summaryrefslogtreecommitdiff
path: root/audio/volume.app/README
blob: b61772402f8dc0cf021e9684e19f051d5902817d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
========================================================================
Volume.app -- a simple windowmaker volume control dockapp
========================================================================

This is a simple volume control for the AfterStep / BlackBox /
Window Maker dock. Volume.app is intended to be an extremely simple,
efficient, and attractive interface to a system's sound mixer.

Currently, only OSS mixer interface is supported. ALSA mixer can be used
through ALSA's OSS emulation.

========================================================================

NOTE:  The hacks/mods are for "ALSA's OSS emulation" in ALSA systems.

NOTE2: There are two 'mod' files: "config.h.in.mod" and
       "volume.app.c.mod".
       If you want to use them, simply rename them to each "original
       filename" (remove ".mod" on filename).

       "volume.app.c.mod" is a hack to fix the mute/unmute problem
       for ALSA systems. (It uses "amixer" command as background).

       "config.h.in.mod" is just a covenience to set some parameters.
       eg: If you notice that the app is not running on the right mixer
          (more than 1 soundcard), you may try to set the default mixer
          before creating the package!

          'cat /proc/asound/oss/sndstat' and search the "Mixers"
          section.  Locate the desired 'mixer number' and then modify
          file "config.h.in.mod" at "DEFAULT_MIXER_DEVICE" parameter.

          Eg2: if desired mixer is "2", modify "config.h.in.mod"
          as below:

          DEFAULT_MIXER_DEVICE "/dev/mixer"
          ( to )
          DEFAULT_MIXER_DEVICE "/dev/mixer2"

        Again, do not forget to rename the file "config.h.in.mod" to
        "config.h.in" before creating the package.

========================================================================