diff options
| author | gryf <gryf73@gmail.com> | 2017-03-24 19:54:04 +0100 |
|---|---|---|
| committer | gryf <gryf73@gmail.com> | 2017-03-24 19:54:04 +0100 |
| commit | 14065492e765765fc6251f8734849823fc078bdf (patch) | |
| tree | 3ff0c4de06c28c2ce1fe277dbcb9dba780648caa | |
| parent | 266aa500f7d5bc67e7fb78af24c0add51f755043 (diff) | |
| download | wmamixer-14065492e765765fc6251f8734849823fc078bdf.tar.gz wmamixer-14065492e765765fc6251f8734849823fc078bdf.tar.bz2 wmamixer-14065492e765765fc6251f8734849823fc078bdf.zip | |
README update
| -rw-r--r-- | README.rst (renamed from README) | 51 | ||||
| -rw-r--r-- | images/wmamixer.gif | bin | 0 -> 68790 bytes |
2 files changed, 31 insertions, 20 deletions
@@ -1,35 +1,51 @@ wmamixer ======== -Wmamixer is a fork of wmsmixer and is an ALSA mixer dockapp for Window Maker. +Wmamixer is a fork of `wmsmixer`_ and is an `ALSA`_ mixer dockapp for Window +Maker. -The code for the ALSA part was taken and adapted from amixer and alsamixer +The code for the `ALSA`_ part was taken and adapted from amixer and alsamixer programs from alsa-utils package. +.. image:: /images/wmamixer.gif?raw=true + :alt: wmamixer overview + +Build +----- + +To build the dockapp, just perform following command in the project topmost +directory: + +.. code:: shell-session + + $ make + +Next, copy binary ``wmamixer`` in convenient place. + Bugs ---- -If spotted any bug, please report it using bug tracker on bitbucket. +If spotted any bug, please report it using bug tracker on bitbucket or github. Changes ------- -Changes with comparison with wmsmixer: +Changes with comparison with `wmsmixer`_: -- ALSA instead of OSS. This is the real thing, using alsa-lib, not just +* `ALSA`_ instead of OSS. This is the real thing, using alsa-lib, not just emulation of OSS. -- Removed config file support, since it doesn't apply anymore +* Removed config file support, since it doesn't apply anymore Limitations ----------- -1. Currently, wmamixer does not support switches and enum type of controls. -Only volume is supported. Enum and switch based ALSA controls are simply +1. Currently, wmamixer does not support switches and enum type of controls. +Only volume is supported. Enum and switch based ALSA controls are simply ignored. -2. There are controls with really small limit range, for example here is -control Beep (pc speaker in other words) which is represented by amixer like -this: +2. There are controls with really small limit range, for example here is +control Beep (pc speaker in other words) which is represented by amixer like +this:: Simple mixer control 'Beep',0 Capabilities: pvolume pvolume-joined pswitch pswitch-joined @@ -37,14 +53,9 @@ this: Limits: Playback 0 - 3 Mono: Playback 1 [33%] [-12.00dB] [on] -Under "Limits" section, there is a Playback capability with range 0 - 3. Using -scrollwheel on such low ranges is somehow awkward. For that controls it's +Under "Limits" section, there is a Playback capability with range 0 - 3. Using +scrollwheel on such low ranges is somehow awkward. For that controls it's better to use clicking instead of scrolling. - -Links ------ -wmsmixer homepage: -http://web.archive.org/web/20081024034859/http://www.hibernaculum.net/wmsmixer/index.php -ALSA homepage: -http://www.alsa-project.org +.. _wmsmixer: http://web.archive.org/web/20081024034859/http://www.hibernaculum.net/wmsmixer/index.php +.. _ALSA: http://www.alsa-project.org diff --git a/images/wmamixer.gif b/images/wmamixer.gif Binary files differnew file mode 100644 index 0000000..92103f8 --- /dev/null +++ b/images/wmamixer.gif |
