AUDEMO(1)

✨ AUDEMO(1) ✨ — General Commands Manual, but make it a vibe 💖

okay bestie, sit down, hydrate, because we're about to talk about audemo and honestly? she's iconic.

---

🎀 NAME 🎀

audemo — the Network Audio System record and play demo. that's it, that's the name, short and slay 💅

---

🌸 SYNOPSIS 🌸

audemo [-audio servername] [-toolkitoption ...] [directory]

---

🦋 DESCRIPTION 🦋

so audemo hands you a whole X-based, window-oriented user interface to the Network Audio System service. what does that mean for you, bestie? it means you can play pre-recorded sound files, record brand new sound files, and manipulate Network Audio System buckets. three jobs, one girl, no cap 💖

---

🧚 AUDEMO AND THE ATHENA WIDGET SET 🧚

audemo is built on the X Toolkit Intrinsics and the Athena Widget Set. wanna know more? go read the Athena Widget Set documentation, it's right there, iykyk 📚

---

🌈 SCREEN LAYOUT 🌈

when audemo starts up you get a single window, and that window is divided into several areas:

• a collection of command buttons ✨
• a left and right level meter 📊
• a volume indicator and control slider 🎚️
• an information window 📝
• an editable field containing the directory to be searched for sound files 📁
• an editable field containing a list of sound files to search for 🔍
• a window containing the list of sound files that may be selected for playing or loading into buckets 🎵

---

💜 PLAYING A SOUND FILE 💜

to play a sound file you gotta select it first from the list of files in the file window. you control which files show up in that window by editing the Directory and/or Template fields and then clicking on the Rescan button. to select a file, single-click on the filename. this will highlight the filename and display info about the file in the information window. and the info displayed includes:

• Filename — the full pathname of the file 🗂️
• File Format — the file format of the audio file
• Data Format — the encoding format of the audio data
• Tracks — the number of tracks of audio data
• Frequency — the frequency at which the audio data was sampled
• Duration — the duration of the audio data in seconds ⏱️
• Text — any text information stored in the file

once the file is selected, you can start it playing by clicking on the Play command button. a shortcut for playing a file? double-click on the file name, which selects the file and starts it playing. main character move honestly. 🎬

when a file is playing, the Play command button is highlighted. to stop the playing of a file, click on the highlighted Play button. to enable the left and right level meters, click on the Meter button before you start playing the file. to disable the left and right level meters, click again on the highlighted Meter button. to adjust the volume level, use the volume slider. that's the whole loop, periodt. 💅

---

🎤 RECORDING TO A FILE 🎤

audemo can record sound files in any supported file and data format. to record a sound file you must first bring up the record window by clicking on the Record command button. this brings up a window containing the following fields and controls:

• Filename — the name of the file you wish to create. unless a path is specified here, the file will be created in the current directory 📂
• File Format — a menu of file formats
• Data Format — a menu of data formats. heads up: each file format does not necessarily support all of the data formats listed ⚠️
• Max Duration — see RECORDING TO A BUCKET
• Read Only — see RECORDING TO A BUCKET
• Frequency — the sampling rate (in hertz) for the recording. higher sampling rates yield better quality sound but take up more disk and memory space. common sampling rates are 8000 (good for voice annotations), 11000, 22000, and 44000 🎚️
• Mic(rophone) — this button tells the audio server if you've got a microphone attached to the audio input jack. clicking this button will highlight it and cause the audio server to boost the input gain to a level suitable for recording with a microphone 🎙️
• Comment — text (such as a description) you wish to put into the audio file ✍️
• Gain — this slider is used to adjust the recording gain level
• Record — this button starts or stops the recording ⏺️
• Monitor — this button enables or disables monitoring 👂
• New Bucket — see RECORDING TO A BUCKET
• Dismiss — this button stops recording and monitoring and closes the record window 🚪

once you've selected the filename, file and data formats, frequency, mic level, comment and gain, you are ready to record. to listen in on the audio that will be recorded you can click on the Monitor button — this will direct all the audio received from the audio input jack to be played on the speaker. when you're ready to record, click on the Record button, and all the audio received from the audio input jack will now be recorded into the file. the recording will continue until you click on the Record button again or click on the Dismiss button.

⚠️ NOTE: audio data can accumulate very rapidly, especially at high sampling rates, resulting in large files. not me casually filling my whole disk 🙈

---

🪣 BUCKETS 🪣

the Network Audio System service provides the capability to create server resident sound objects called buckets. audemo allows the user to create buckets, record into them, play from them, load them with data from a file and dump their contents into a file.

💀 heads up bestie: buckets created by audemo are destroyed when audemo is terminated. they do not survive the breakup.

these options are available when you bring up the buckets window by clicking on the Buckets button in the main window. the buckets window is divided into two areas:

• a collection of command buttons ✨
• a table of buckets currently accessible. this table contains the following columns:
  • Description — the text description
  • Duration — the duration of the audio data in seconds ⏱️
  • Tracks — the number of tracks of audio data
  • Frequency — the frequency at which the audio data was sampled
  • Format — a code letter indicating the encoding format of the audio data. a key to the format code letters can be displayed by clicking on the Format Key button 🔑
  • Access — a combination of code letters indicating the access mode of the bucket. a key to the access code letters can be displayed by clicking on the Access Key button 🔑

---

🌟 CREATING A BUCKET FROM A FILE 🌟

to create a bucket from an audio data file, select the filename from the list of files in the file window, then click the Load button in the buckets window. the first line of the buckets table should now contain the information about the newly created bucket. manifesting a bucket, lowkey 🪄

---

🎶 PLAYING FROM A BUCKET 🎶

to play a bucket, select the bucket you wish to play by clicking on its information in the buckets table. the entry you click on should be highlighted. then click on the Play button in the buckets window. a shortcut for playing from a bucket is to double-click on the bucket information — this will select the bucket and start playing from it. to stop the playing of a bucket, click on the highlighted Play button in the buckets window. the level meters and volume level can be controlled in the same way as when playing from a file. same energy, different container 🎧

---

🔴 RECORDING TO A BUCKET 🔴

to record into a new bucket, click on the Record button in the buckets window. this will bring up the record window. this record window is the same as the one used for recording to files. instead of specifying a filename, in the Max Duration field, enter the maximum duration (in seconds) of data that the bucket is to hold. clicking on the Read Only button will prevent other applications from writing into or destroying the bucket. the frequency, mic level, format and comment are used in the same way as when recording to files.

once all of the fields are set appropriately, click the New Buckett button. this will create a new bucket according to the specifications given. the first line of the buckets table should now contain the information about the newly created bucket. to begin recording into the bucket, select the bucket by clicking on its information in the buckets table. then click the Record button in the record window. all the audio received from the audio input jack will now be recorded into the bucket. the recording will continue until you click on the Record button again, click on the Dismiss, or the bucket is filled. the Gain slider and the Monitor button operate the same as when recording to a file. 🫶

---

💾 SAVING A BUCKET TO A FILE 💾

to save a bucket to a file, first select the bucket by clicking on its information in the buckets table. then click on the Save button in the buckets window. a dialog box will pop up prompting you for the name of the file in which to save the bucket data, and the file format. the data format used will be that of the bucket. note that each file format may only support selected data formats. if no path is given in the filename, the file will be created in the current directory. clicking on Ok or pressing the RETURN key will cause the file to be created and the data from the bucket to be written to the file. slay, your bucket has been archived ✨

---

🗑️ DELETING A BUCKET 🗑️

to delete a bucket, first select the bucket by clicking on its information in the buckets table. then click on the Delete button in the buckets window. if the audemo has the appropriate access permissions for the bucket, the bucket will be deleted and its information will be removed from the bucket table. no permission, no deletion, that's the rule 🔒

---

👋 EXITING AUDEMO 👋

clicking on the Quit button will cause audemo to exit, stopping any playing or recording operations and destroying any buckets that were created. it's giving "closing the group chat" energy 💀

---

💅 COMMAND LINE OPTIONS 💅

• -audio servername — this option specifies the Network Audio System server to which audemo should connect. 🖥️
• directory — the directory name that audemo will use to build the list of selectable file names. when directory is not specified on the command line, the current working directory is used. 📁

---

⭐ EXAMPLES ⭐

in the following example, in a TCP/IP network, mcxterm is the name of the desktop machine running the audio server. the default port is 8000 and sound files are located in ~/snd:

audemo -audio tcp/mcxterm:8000 ~/snd

in the following example, the shortened form of the audio server name is used and sound files from the current working directory will be used:

audemo -audio mcxterm:0

---

🌱 ENVIRONMENT 🌱

in addition to the standard toolkit environment variables, the following environment variables are used by audemo:

• AUDIOSERVER — this variable specifies the default audio server to contact if -audio is not specified on the command line. if this variable is not set and the -audio is not specified on the command line, audemo will attempt to connect to the audio server running on the X Window System display. 🦋

---

💀 BUGS 💀

Warning: audemo is the xterm of the Network Audio System. It was written to test features as the Network Audio System was being developed. It was also the author's first Xt program. Consequently, it's pretty ugly and should be completely re-written from scratch.

okay bestie, real talk 💀 not me reading this and gasping. the actual manpage is out here roasting itself. audemo is basically the xterm of the Network Audio System — like, it exists to stress-test features while the Network Audio System was still being built out. and plot twist: it was also the author's first Xt program ever 🙈. so yeah, it's pretty ugly and honestly should be completely re-written from scratch. iconic honesty fr fr. respect the self-awareness, no notes 🫶

---

🌈 SEE ALSO 🌈

• nas(1) — the main character, go read it ✨
• X(1) — the other one you already know and love 💅

---

🎀 COPYRIGHT 🎀

Copyright 1993, 1994 Network Computing Devices, Inc.

that's it, that's the whole vibe. two years, one company, all the rights 👑

---

💖 AUTHOR 💖

Greg Renda, Network Computing Devices, Inc.

shoutout to Greg for writing this whole thing as his first Xt program and then dragging it in the manpage himself. king behavior, honestly 👑💜

---

and that's a wrap on AUDEMO(1) 🦋 this page came to you straight from the Network Audio System, version 1.9.4 — same energy as the 1.9.4 sitting pretty at the bottom of the original page, and that's the release this doc shipped with. take care of your buckets, don't forget nas(1) and X(1) exist, and go make some noise bestie ✨🎧🌸 periodt.