FvwmAudio(1)

✨ FvwmAudio ✨ (manual name: FvwmAudio, section 1, General Commands Manual) 🎀

okay bestie, let's talk about FvwmAudio, the FVWM Audio module 🦋 it's giving sound effects for your window manager and it is iconic 💅

---

📜 NAME

FvwmAudio — the FVWM Audio module 🌸

🪄 SYNOPSIS

ngl you can't just type FvwmAudio into your terminal and expect magic 🙈 fvwm spawns it for you, so no command line invocation will work. from inside your .fvwmrc file it looks like this:

Module FvwmAudio

or you can tuck it into an fvwm pop-up menu like this:

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

okay so FvwmAudio talks to the Fvwm window manager and binds audio sounds to window manager actions 🎧 any action can have different audio queues assigned to it. the best part? it works with any independent audio player, so it doesn't need any special audio library APIs of its own 😭 it's super simple: it just binds the audio filenames to particular actions and forks off the audio player program with the right filename whenever that action happens ✨

FvwmAudio can also have builtin support for the rplay library 🌈

⚙️ CONFIGURATION OPTIONS

FvwmAudio reads the same .fvwmrc file that fvwm(1) reads when it starts up, and it looks for certain configuration options 👑

• *FvwmAudioPlayCmd /usr/bin/X11/demos/auplay — this picks the independent audio player program that actually plays the sounds 🎶 if you set the play command to builtin-rplay, the builtin rplay support takes over instead. for example:

*FvwmAudioPlayCmd builtin-rplay

• *FvwmAudioDir /usr/lib/sounds — tells it which directory to look in for audio files 📁 this option gets ignored when rplay is used.
• *FvwmAudioDelay 5 — sound events only play if they happen at least 5 seconds after the previous event 🙅‍♀️ anything that lands during the delay period gets ignored. super helpful if you don't want a bunch of sounds going off at once 🫶 the default delay is 0, which disables the audio delay.
• *FvwmAudioRplayHost hostname — picks which host the sounds play on 🖥️ the hostname can also be an environment variable, like $HOSTDISPLAY. this one is only valid with builtin rplay support.
• *FvwmAudioRplayPriority 0 — sets the priority that gets assigned to the sounds when they play 🔥 only valid with builtin rplay support.
• *FvwmAudioRplayVolume 127 — sets the volume that gets assigned to the sounds when they play 🔊 only valid with builtin rplay support.
• *FvwmAudio window-manager_action audio_filename — this is where you bind particular window manager actions to sound queues 💜

Here's the whole sound lineup, bestie:

*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 in the SYNOPSIS section, so you already know the vibe 🌸 no command line invocation is possible. fvwm has to be the one to invoke FvwmAudio 👑

🙈 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 basically takes Mark's original program and extends it so it's generic enough to work with any audio player. the concept for interfacing this module with the Window Manager is original work by Robert Nation 💜

Copyright 1994, Mark Boyns and Mark Scott. no guarantees, no warranties, nothing 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) 🌈

---

bestie, this manual was from the 3rd Berkeley Distribution, dated Mar 28 1994, and it's FvwmAudio(1) all the way 💖 slay forever 💅✨