1 args "--conf-parser --no-handle-version --no-handle-help"
3 purpose "An alarm clock and volume-fader for OSS and ALSA."
6 define(CURRENT_PROGRAM,para_fade)
7 define(DEFAULT_CONFIG_FILE,~/.paraslash/fade.conf)
9 section "General options"
10 #########################
13 include(config_file.m4)
20 values = "sleep", "snooze", "fade"
24 para_fade knows three different fading modes:
26 sleep mode: Change to the initial volume and select
27 the initial afs mood/playlist. Then fade out until
28 the fade-out volume is reached. Switch to the
29 sleep mood/playlist until wake time minus fade-in
30 time. Finally switch to the wake mood/playlist and
31 fade to the fade-in volume.
33 fade: Fade the volume to the given value in the
36 snooze: Fade out, sleep a bit and fade in.
41 "choose the mixer API"
42 string typestr = "api"
45 ALSA is preferred over OSS if both APIs are supported
46 and this option is not given. To see the supported
47 mixer APIs, use this option with an invalid string
48 as the mixer API, e.g. --mixer-api help.
51 option "mixer-device" m
52 #~~~~~~~~~~~~~~~~~~~~~~
54 string typestr = "device"
57 The default device (used if this option is not given)
58 depends on the selected mixer API. For ALSA, the
59 default is 'hw:0' which corresponds to the first sound
60 device. For OSS, '/dev/mixer' is used as the default.
63 option "mixer-channel" C
64 #~~~~~~~~~~~~~~~~~~~~~~~
65 "select the analog mixer channel"
66 string typestr = "channel"
69 For the ALSA mixer API, the possible values are
70 determined at runtime depending on the hardware and
71 can be printed by specifying an invalid mixer channel,
72 for example --mixer-channel help. The default channel
75 For OSS the possible values are invariably 'volume',
76 'bass', 'treble', 'synth', 'pcm', 'speaker', 'line',
77 'mic', 'cd', 'imix', 'altpcm', 'reclev', 'igain',
78 'ogain'. However, not all listed channels might be
79 supported on any particular hardware. The default
83 section "Options for sleep mode"
84 ################################
89 int typestr = "volume"
93 Used as the start volume, before fading out to the
99 "afs mood/playlist during fade out"
100 string typestr = "mood_spec"
104 Select this mood right after setting the
105 volume. Example: --fo-mood m/sleep
110 "fall asleep fade out time"
111 int typestr = "seconds"
115 No fading if set to 0.
120 "volume to fade out to"
121 int typestr = "volume"
125 option "sleep-mood" -
126 #~~~~~~~~~~~~~~~~~~~~
127 "sleep time afs mood/playlist"
128 string typestr = "mood_spec"
132 Select the given afs mood/playlist after the fade
133 out is complete. If unset, the \"stop\" command is
139 "(0-23) (default: now + 9 hours)"
146 int typestr = "minutes"
152 "afs mood/playlist during fade in"
153 string typestr = "mood_spec"
157 Change to this afs mood/playlist on wake time.
162 "wake up fade in time"
163 int typestr="seconds"
167 No fading in if set to 0.
172 "volume to fade to at wake time"
173 int typestr = "volume"
177 section "Options for snooze mode"
178 #################################
183 int typestr = "seconds"
189 "volume to fade to before snooze"
190 int typestr = "volume"
194 option "snooze-time" -
195 #~~~~~~~~~~~~~~~~~~~~~
197 int typestr = "seconds"
204 int typestr = "seconds"
210 "volume to fade to after snooze"
211 int typestr = "volume"
215 section "Options for fade mode"
216 ###############################
221 int typestr = "volume"
228 int typestr = "seconds"