AUDIOTOOLS-CONFIG(1)

📦
version 3.1.1 · 4 versions
, in ubuntu questing

💖 AUDIOTOOLS-CONFIG(1) 💖

okay bestie, welcome to audiotools-config — the Audio Tools Configuration Manager, aka the lil control room for your whole Python Audio Tools setup. it's giving main character energy for your config file, no cap ✨

✨ NAME ✨

audiotools-config — manage Python Audio Tools configuration 🎀

🌸 SYNOPSIS 🌸

audiotools-config [OPTIONS]

🦋 DESCRIPTION 🦋

So audiotools-config is literally THE configuration manager for Python Audio Tools. 💅

Call it with no arguments and it just shows you the system's current configuration — like a vibe check for your settings. 🫶

But the moment you start passing in configuration arguments? It goes into edit mode and writes new values into your $(HOME)/.audiotools.cfg file. That's it, that's the whole thing. Iconic.

👑 OPTIONS 👑

  • -h, --help — shows you the full list of options and then dips. bye! 👋
  • -I, --interactive — edit your options interactively, like a lil conversation with the program 🎀
  • -V, --verbose=VERBOSITY — how much output you wanna see. pick between 'normal', 'quiet' and 'debug'. quiet for when you're feeling mysterious, debug for when you're feeling nosy 🔍

🔥 TRANSCODING OPTIONS 🔥

  • -t, --type — when you use it without the -q option, this sets the default audio type for creating new audio files. otherwise it teams up with -q to set the default audio quality for that given type. wanna see what audio formats exist? try -t help 💖
  • -q, --quality — the default quality level for a given audio type. for the list of available quality levels, try -q help ⭐
  • --format=STRING — the format string used for new filenames. template fields get swapped out for metadata values when new tracks are created, and all the other text just stays exactly as-is. (more on the fields below, bestie 👀)
  • -j, --joint — the default maximum number of processes to run at one time. multitasking queen behavior 💅
  • --replay-gain=YES/NO — whether to add ReplayGain metadata by default 🎧

🎀 ID3 OPTIONS 🎀

  • --id3v2-version=VERSION — which version to use for newly created ID3v2 tags. choose from "id3v2.2", "id3v2.3", "id3v2.4", or "none". all three ID3v2 versions are roughly equivalent in terms of supported features, but "id3v2.2" and "id3v2.3" have the widest level of support. if you go with "none", new MP3 files will not be given ID3v2 tags at all. 🙈
  • --id3v2-pad=TRUE / FALSE — whether to pad ID3v2 numerical fields to 2 digits. for example, if "true", track number 1 gets stored as "01" in ID3v2 tags. if false, it's stored as "1". zero-padding is lowkey aesthetic, ngl ✨
  • --id3v1-version=VERSION — which version to use for newly created ID3v1 tags. choose from "id3v1.1" or "none". if "none" is given, new MP3 files will not be given ID3v1 tags. 💀

🌈 CD LOOKUP OPTIONS 🌈

  • --use-musicbrainz=YES/NO — whether to use the MusicBrainz service for CD lookups by default 🧠
  • --musicbrainz-server=HOSTNAME — the default MusicBrainz server to use
  • --musicbrainz-port=PORT — the default MusicBrainz port number to use
  • --use-freedb=YES/NO — whether to use the FreeDB service for CD lookups by default 🆓
  • --freedb-server=HOSTNAME — the default FreeDB server to use
  • --freedb-port=PORT — the default FreeDB port number to use

💜 SYSTEM OPTIONS 💜

  • -c, --cdrom — the default CD-ROM drive to use 💿
  • --cdrom-read-offset — the CD-ROM read offset, in PCM samples
  • --cdrom-write-offset — the CD-ROM write offset, in PCM samples
  • --fs-encoding — the encoding of filenames on the system, such as "UTF-8"
  • --io-encoding — the encoding of text sent to the screen, such as "UTF-8"

🧚 BINARIES OPTIONS 🧚

okay so these ones are literally just paths — the manpage gives no descriptions for them, so I'm not gonna invent any, that's a promise 🤞

  • --faac=PATH
  • --faad=PATH
  • --flac=PATH
  • --lame=PATH
  • --oggdec=PATH
  • --oggenc=PATH
  • --speexdec=PATH
  • --speexenc=PATH
  • --twolame=PATH

⭐ FORMAT STRING FIELDS ⭐

Template Fields 🎀

  • %(track_number)2.2d — the track's number on the CD
  • %(track_total)d — the total number of tracks on the CD
  • %(album_number)d — the CD's album number
  • %(album_total)d — the total number of CDs in the set
  • %(album_track_number)s — combination of album and track number
  • %(track_name)s — the track's name
  • %(album_name)s — the album's name
  • %(artist_name)s — the track's artist name
  • %(performer_name)s — the track's performer name
  • %(composer_name)s — the track's composer name
  • %(conductor_name)s — the track's conductor name
  • %(media)s — the track's source media
  • %(ISRC)s — the track's ISRC
  • %(catalog)s — the track's catalog number
  • %(copyright)s — the track's copyright information
  • %(publisher)s — the track's publisher
  • %(year)s — the track's publication year
  • %(date)s — the track's original recording date
  • %(suffix)s — the track's suffix
  • %(basename)s — the track's original name, without suffix

🍓 SEE ALSO 🍓

audiotools.cfg(5), cdda2track(1), cddainfo(1), cddaplay(1), coverdump(1), covertag(1), coverview(1), dvda2track(1), dvdainfo(1), track2cdda(1), track2track(1), trackcat(1), trackcmp(1), trackinfo(1), tracklength(1), tracklint(1), trackplay(1), trackrename(1), tracksplit(1), tracktag(1), trackverify(1)

💖 AUTHOR 💖

Brian Langenfeld

and that's the whole page, bestie!! 🫶 this manual is AUDIOTOOLS-CONFIG(1), sourced from the Audio Tools Configuration Manager, dated 2025-03-10. go forth and configure your little heart out 💅✨🌸

📦 where this page comes from