audtty(1)

👑 audtty — the ncurses remote for Audacious, bestie edition 💖

okay so like. imagine controlling Audacious from your terminal but make it cute. that's this. it's the audtty(1) manual page and we're gonna get through it together, no cap.

---

✨ NAME ✨

audtty — control Audacious from the command line with a friendly ncurses interface 🎀

🌸 SYNOPSIS 🌸

audtty [<-|+>ahlntV] [ options ]

💅 DESCRIPTION 💅

audtty is a simple lil application for controlling Audacious straight from the command line. it's built so the common, simple tasks are fast and easy — like, effortless. you drive it with arrow keys and the standard Audacious keys, so it's intuitive to learn and you'll be slaying in seconds fr fr. 🦋

🔥 OPTIONS 🔥

first things first, the negation lore:

• to negate a short option, use + instead of - (like +a).
• long-options get negated with no-, (like --no-read-all).

🫶 remember this one, it's giving "small detail, big consequences".

The keys for basic control are as follows:

+-----------------------+
|     <<  >  || o  >>   |
+-----------------------+
       z  x  c  v  b

• -a, --read-all — read all the titles and lengths on startup. (EXTREMELY SLOW) (default off). like, when we say extremely slow we mean it, bestie 😭
• -h, --help — print the help message. your lil safety net 💜
• -l, --length — show the length of the track in the playlist (SLOW) (default on).
• -n, --numbers — show numbers in the playlist (default on). numbering is a vibe ✨
• -t, --title — read the title from the ID3/ogg-tags (SLOW) (default on).
• -V, --version — display version information. the receipts 📜

Tip: things going slow? try audtty -ntl 🏃♀️💨

🎀 KEYS 🎀

• Arrow right/left — skip forward/backward 5 seconds. yes, five, exactly five, iconic ⏩
• Arrow up/down — move up/down in the playlist or search results.
• Page up/down — scroll up/down one page in the playlist or search results.
• Enter — select and play the file. main character moment 👑
• Esc — exit from the application, or, if you're in another dialog, go to the main view.
• 0 or + — increase volume. turn it up 🎶
• 9 or - — decrease volume.
• a — open a file browser window.
• b — jump to the next song.
• c — pause.
• d — remove the currently selected item from the playlist.
• j — search for a file to jump to.
• L — add URI to the playlist. (capital L, don't @ me)
• q — exit from the application.
• R — reload the playlist.
• u — save the playlist.
• v — stop
• x — play
• z — jump to previuos song

🦋 FILE BROWSER 🦋

• Enter — will either add the current selection if it is a file, or change directories if it is a directory. it reads the room and does the right thing, we love a self-aware queen 💅
• a or A — will add the selected file or directory to the playlist.
• q or Esc — exit back to the main playlist window. bye bestie 👋

🌈 CONFIGURATION FILES 🌈

• /etc/audtty.conf — the global configuration file.
• $HOME/.audtty.conf — the local configuration file, specific to each user. can be used to override the global options. it's giving "my rules now" 💖

the syntax of the configuration files is long options without the --, one on each line.

Example:

numbers
title
length no-read-all

💀 BUGS 💀

the xmms remote controlling library provides no good way of detecting changes in the playlist, and therefore audtty might need to be told to reload the playlist if songs are moved. do so by pressing L. and if the length of the playlist changes, audtty will assume the playlist has changed and reload the entire playlist to make sure it is correct. so like, it's doing its best 🙈

probably lots more.

💜 AUTHORS 💜

see /usr/share/doc/audtty/copyright for the list of authors.

⭐ RESOURCES ⭐

the audtty website can be found at <http://audacious-media-player.org/Audtty>

this man page was originally written by Knut Auvor Grythe <audtty@auvor.no>. updated by Chris Taylor <chris@code-monkeys.org>.

---

and that's the whole thing, bestie 🫶 this was version 0.1.12, dated 2010-02-28, and yeah — it's still serving. periodt. 💖✨