DOKK / manpages / debian 11 / fvwm1 / FvwmAudio1.1.en
FvwmAudio(1) General Commands Manual FvwmAudio(1)

FvwmAudio - the FVWM Audio module

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

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.

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
*FvwmAudio shutdown
*FvwmAudio unknown
*FvwmAudio add_window
*FvwmAudio raise_window
*FvwmAudio lower_window
*FvwmAudio focus_change
*FvwmAudio destroy_window
*FvwmAudio iconify
*FvwmAudio deiconify
*FvwmAudio toggle_paging
*FvwmAudio new_page
*FvwmAudio new_desk
*FvwmAudio configure_window
*FvwmAudio window_name
*FvwmAudio icon_name
*FvwmAudio res_class
*FvwmAudio res_name
*FvwmAudio end_windowlist


The invocation method was shown in the synopsis section. No command line invocation is possible. FvwmAudio must be invoked by the fvwm window manager.

It's REALLY noisy when fvwm starts and restarts.

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.

Mark Boyns (

Mark Scott (

Mar 28 1994 3rd Berkeley Distribution