NAME
FvwmAudio - the FVWM Audio module
SYNOPSIS
FvwmAudio is spawned by fvwm, so no command line invocation will work.
From within the .fvwmrc file, FvwmAudio is spawned as follows:
Module FvwmAudio
or from within an fvwm pop-up menu:
Popup "Module-Popup"
Title "Modules"
Module "GoodStuff" GoodStuff
Module "NoClutter" FvwmClean
Module "FvwmIdentify" FvwmIdent
Module "Banner" FvwmBanner
Module "Debug" FvwmDebug
Module "Audio" FvwmAudio
Module "Pager" FvwmPager 0 3
EndPopup
DESCRIPTION
The FvwmAudio module communicates with the Fvwm window manager to bind
audio sounds to window manager actions. Different audio queues may be
assigned to any window manager action. FvwmAudio can be used with any
independent audio player, and therefore requires no special audio
library APIs of its own. Simple in its design, it merely binds the
audio filenames to particular actions and forks off the audio player
program with the appropriate filename when that action occurs.
FvwmAudio can also have builtin support for the rplay library.
CONFIGURATION OPTIONS
FvwmAudio reads the same .fvwmrc file as fvwm(1) reads when it starts
up, and looks for certain configuration options:
*FvwmAudioPlayCmd /usr/bin/X11/demos/auplay
This determines the independent audio player program that will
actually play the sounds. If the play command is set to
builtin-rplay then the builtin rplay support will be used. For
example:
*FvwmAudioPlayCmd builtin-rplay
*FvwmAudioDir /usr/lib/sounds
Specifies the directory to look for the audio files. This
option is ignored when rplay is used.
*FvwmAudioDelay 5
Specifies that sound events will only be played if they occur at
least 5 seconds after the previous event. Sounds events that
occur during the delay period are ignored. This option is
useful if you don’t want several sounds playing at the same
time. The default delay is 0 which disables the audio delay.
*FvwmAudioRplayHost hostname
Specifies what host the sounds will play on. The hostname can
also be an environment variable such as $HOSTDISPLAY. This
option is only valid with builtin rplay support.
*FvwmAudioRplayPriority 0
Specifies what priority will be assigned to the sounds when they
are played. This option is only valid with builtin rplay
support.
*FvwmAudioRplayVolume 127
Specifies what volume will be assigned to the sounds when they
are played. This option is only valid with builtin rplay
support.
*FvwmAudio window-manager_action audio_filename
Binds particular window manager actions to sound queues.
*FvwmAudio startup TaDa.au
*FvwmAudio shutdown Elvis_Left.au
*FvwmAudio unknown doh.au
*FvwmAudio add_window drip.au
*FvwmAudio raise_window swoosh.au
*FvwmAudio lower_window swoosh.au
*FvwmAudio focus_change boing.au
*FvwmAudio destroy_window explosion.au
*FvwmAudio iconify ploop.au
*FvwmAudio deiconify ploop.au
*FvwmAudio toggle_paging fwop.au
*FvwmAudio new_page beam_trek.au
*FvwmAudio new_desk beam_trek.au
*FvwmAudio configure_window huh.au
*FvwmAudio window_name beep.au
*FvwmAudio icon_name beep.au
*FvwmAudio res_class beep.au
*FvwmAudio res_name beep.au
*FvwmAudio end_windowlist twang.au
INVOCATION
The invocation method was shown in the synopsis section. No command
line invocation is possible. FvwmAudio must be invoked by the fvwm
window manager.
BUGS
It’s REALLY noisy when fvwm starts and restarts.
COPYRIGHTS
This module is heavily based on a similar Fvwm module called FvwmSound
by Mark Boyns. FvwmAudio simply takes Mark’s original program and
extends it to make it generic enough to work with any audio player. The
concept for interfacing this module to the Window Manager, is original
work by Robert Nation.
Copyright 1994, Mark Boyns and Mark Scott. No guarantees or warranties
or anything are provided or implied in any way whatsoever. Use this
program at your own risk. Permission to use this program for any
purpose is given, as long as the copyright is kept intact.
AUTHORS
Mark Boyns (boyns@sdsu.edu)
Mark Scott (mscott@mcd.mot.com)