From 14065492e765765fc6251f8734849823fc078bdf Mon Sep 17 00:00:00 2001 From: gryf Date: Fri, 24 Mar 2017 19:54:04 +0100 Subject: README update --- README | 50 ------------------------------------------ README.rst | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++ images/wmamixer.gif | Bin 0 -> 68790 bytes 3 files changed, 61 insertions(+), 50 deletions(-) delete mode 100644 README create mode 100644 README.rst create mode 100644 images/wmamixer.gif diff --git a/README b/README deleted file mode 100644 index 8058ee7..0000000 --- a/README +++ /dev/null @@ -1,50 +0,0 @@ -wmamixer -======== - -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 -programs from alsa-utils package. - -Bugs ----- - -If spotted any bug, please report it using bug tracker on bitbucket. - -Changes -------- - -Changes with comparison with wmsmixer: - -- 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 - -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 -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: - - Simple mixer control 'Beep',0 - Capabilities: pvolume pvolume-joined pswitch pswitch-joined - Playback channels: Mono - 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 -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 diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..12cec8f --- /dev/null +++ b/README.rst @@ -0,0 +1,61 @@ +wmamixer +======== + +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 +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 or github. + +Changes +------- + +Changes with comparison with `wmsmixer`_: + +* `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 + +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 +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:: + + Simple mixer control 'Beep',0 + Capabilities: pvolume pvolume-joined pswitch pswitch-joined + Playback channels: Mono + 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 +better to use clicking instead of scrolling. + +.. _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 new file mode 100644 index 0000000..92103f8 Binary files /dev/null and b/images/wmamixer.gif differ -- cgit v1.2.1