Audio(0.98a) MachTen Programmer’s Manual Audio(0.98a)

Audio - the AfterStep Audio module

Audio is spawned by afterstep, so no command line invoca-
tion will work. From within the .steprc file, Audio is
spawned as follows:

Module Audio

or from within an afterstep pop-up menu:

Popup "Module-Popup"
Title "Modules"
Module "Wharf" Wharf
Module "FvwmIdentify" FvwmIdent
Module "Audio" Audio
Module "Pager" Pager 0 3

The Audio module communicates with the AFterStep window
manager to bind audio sounds to window manager actions.
Different audio queues may be assigned to any window man-
ager action. Audio 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.

Audio can also have builtin support for the rplay library.

Audio reads the same .steprc file as afterstep(1) reads
when it starts up, and looks for certain configuration

*AudioPlayCmd /usr/bin/X11/demos/auplay
This determines the independent audio player pro-
gram 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:

*AudioPlayCmd builtin-rplay

*AudioDir /usr/lib/sounds
Specifies the directory to look for the audio
files. This option is ignored when rplay is used.

*AudioDelay 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

*AudioRplayHost 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.

*AudioRplayPriority 0
Specifies what priority will be assigned to the
sounds when they are played. This option is only
valid with builtin rplay support.

*AudioRplayVolume 127
Specifies what volume will be assigned to the
sounds when they are played. This option is only
valid with builtin rplay support.

*Audio window-manager_action audio_filename
Binds particular window manager actions to sound

*Audio startup
*Audio shutdown
*Audio unknown
*Audio add_window
*Audio raise_window
*Audio lower_window
*Audio focus_change
*Audio destroy_window
*Audio iconify
*Audio deiconify
*Audio toggle_paging
*Audio new_page
*Audio new_desk
*Audio configure_window
*Audio window_name
*Audio icon_name
*Audio res_class
*Audio res_name
*Audio end_windowlist

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

This module is a port of the FvwmAudio module to AfterStep
by Frank Fejes. The concept for interfacing this module to
the Window Manager, is original work by Robert Nation.

Copyright 1996, Frank Fejes. 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

Frank Fejes <> -- application

Dan Weeks <> -- man page

Audio May 1996 3