NA_PLAY(1)

✨ NA_PLAY(1) ✨

so this is a page from the General Commands Manual, bestie, and it's all about na_play — the little program that takes your waveform files and makes them come out of the audio device. 🎧✨

---

🌸 NAME 🌸

na_record — play waveform files on audio device

ngl i'm just the messenger here 🙈 that's literally what the page says in the NAME section, na_record, even though the whole rest of the page is about na_play. we keep the lore exactly as we found it. 💅

---

🎀 SYNOPSIS 🎀

na_play [-h] [-itype type] [-n channels] [-f sample rate]
        [-ibo byteorder] [-iswap] [-istype type] [-c channel]
        [-start time] [-end time] [-from sample] [-to sample]
        [-p protocol] [-command command] [-basic] [-quality high | low]
        [-server host] [-scale scale] [-v] [-wait] input files ...

---

✨ DESCRIPTION ✨

okay so na_play plays digital audio data to the system's audio input device, pulling it from the file(s) you hand it. 🫶 it's giving versatile: a whole variety of file formats? supported. native audio devices? also supported. she contains multitudes. 💖

---

🍓 the option flags 🍓

here's every single flag she recognizes, no skips, no cuts, periodt:

• -h — prints a short summary of usage to standard output. (your little help me out moment ✨)
• -itype type — the input file type. usually the input type can just be figured out from the file's headers, so you lowkey don't need this option at all — except for raw (unheadered) data, where it's your only hope. supported types are currently: nist, est, esps, snd, riff, aiff, audlab, raw, ascii. 🌈
• -n channels — number of channels, in an unheadered input file. again, this can usually be sniffed out from the headers. default is 1. 🎀
• -f sampling rate — sampling rate, for an unheadered input file. default is 16000. ⭐
• -ibo byte order — byte order, for an unheadered input file. default is system byte order. recognized values are: MSB, LSB, native, nonnative. 🔥
• -iswap — swap bytes in an unheadered input file. 🔄
• -istype type — sample type for an unheadered input file. recognized values are: short, mulaw, byte, ascii. 🦋
• -c channel — select a single channel (starting at 0) for playback. this option plays only the specified channel and discards all others. brutal but efficient 💀
• -start time — select a subsection of the file, starting at this time (specified in seconds). ⏱️
• -end time — select a subsection of the file, ending at this time (specified in seconds). ⏱️
• -from sample — select a subsection of the file, starting at this offset (specified in number of samples). 🌸
• -to sample — select a subsection of the file, ending at this offset (specified in number of samples). 🌸
• -p protocol — use the specified audio device protocol. the list of supported types varies between platforms, and you can obtain it using the -h flag. 🌐
• -command command — if the "audio_command" protocol is specified, this argument must be given to select the command used to play the waveform. a temporary file is created and passed in the environment variable FILE. the sample rate is passed in the environment variable SR. (yes, FILE and SR, capital letters, iykyk ✨)
• -basic — treat unheadered input files as 8kHz mu-law data (i.e. audio/basic MIME type). 🎵
• -quality high | low — select the quality of output. "high" will ensure that proper resampling is used. "low" means to play as fast as possible with a minimum of processor time. pick your fighter ⚔️
• -server host — specifies the host to play sound on, when using a network-aware audio protocol (such as NAS). 🛰️
• -scale scale — change the gain (volume) of the signal. the argument is a number relative to 1.0, which is the default. 🔊
• -v — be verbose (i.e. print file names when playing). 👀
• -wait — pause for a keystroke between each file. ⌨️

---

🌈 ENVIRONMENT 🌈

• NA_PLAY_PROTOCOL — audio protocol to use (as in the -p flag). ✨
• NA_PLAY_COMMAND — command used to play audio when using the audio_command protocol. ✨
• NA_PLAY_HOST — host to play audio on when using a network audio protocol. ✨
• NA_PLAY_QUALITY — playback quality (low or high). ✨

---

💅 EXAMPLES 💅

to play the section of foo.wav from 1.5 to 3.2 seconds:

$ na_play -start 1.5 -end 3.2 foo.wav

to play samples 3600 to 42000 of channel 1 of bar.wav:

$ na_play -from 3600 -to 4200 -c 1 foo.wav

and yes bestie, we're keeping both lines exactly as the page gives them to us — the prose says one thing and the command says another and that is simply the text we were handed. no cap, no edits. 🙈

---

💀 BUGS 💀

• the usage information isn't entirely correct. 😭
• the audio_command protocol generates temporary files insecurely.

ok so that second one is not a vibe, that's an actual security situation, so take it seriously fr fr. 🔥

---

🦋 SEE ALSO 🦋

• na_record(1) 💖

---

and that's the whole page, bestie!! 🫶✨ this little beauty comes to you from the Edinburgh Speech Tools, dated April 4, 2001, and if you want to see her again just look for NA_PLAY(1). mwah. 💅🎀🌸