ADPLUGDB(1)

Okay bestie, let's talk about adplugdb 💖 It's a User Command (manual section 1), and it's lowkey the most organised tool for keeping your AdPlug records in check ✨

---

✨ NAME ✨

adplugdb - AdPlug database maintenance utility 🎀

🦋 SYNOPSIS 🦋

adplugdb [OPTION]... COMMAND [ARGUMENT]...

💅 DESCRIPTION 💅

Okay so adplugdb maintains database files in AdPlug database format 💜 It can add, list and remove records inside a central database, or merge a whole set of databases together into one single database 🔥

It always works on a central database file ✨ To find it, it first checks whether you have a home directory. If you do, the file lives at ~/.adplug/adplug.db 🌸 If you don't have a home directory, it looks for a file called adplug.db in the current working directory instead 🧚

Want a system-wide one? Use -s 👑 That file is at /usr/com/adplug/adplug.db and it's superuser-only, no cap 😭 You can also point it at any file with -d 🦋

Only one database file can be manipulated at a time, so pick your favourite and stick with it 💀

🌈 EXIT STATUS 🌈

If everything goes smoothly, adplugdb gives you a successful exit status, which is 0 on most systems 🫶 Otherwise you get an unsuccessful exit status, which is 1 on most systems 💀

👑 COMMANDS 👑

Commands control the main operation mode of adplugdb 💖 They can take a bunch of arguments, but only one command can be specified at a time, periodt 💅

• add — This one takes a list of filenames separated by spaces 🍓 Each file gets examined, and a record is added to the database if AdPlug supports the file ✨ By default the record is type Plain, unless you use -t (more on that below) 🎀 The default comment is the filename itself 💬 If a record for that file is already in the database, the new one replaces it 🌸
• list — This takes an optional list of filenames or keys, separated by spaces ✨ Each file gets examined, and its record is looked up in the database and displayed on stdout in a human-readable form 👀 No arguments? Then every record in the database gets shown 🧚
• remove — This takes a list of filenames or keys, separated by spaces 💀 Each file gets examined, and the matching record is removed from the database 🫡
• merge — This takes a list of database filenames, separated by spaces 🦋 Each database file gets loaded, and its contents get merged and written to the central database file 🫶 They're processed in the order you specify them on the commandline 🔥 Records from databases specified earlier take precedence over records from databases specified later 👑 Records from the central database take precedence over everything else 💖 So only additional records from the other databases get added to the central database 🌈 If a record isn't already in the central database, the version from the earliest specified database that contains it is taken ✨ Records are never overwritten in the central database, no exceptions 😤

💜 OPTIONS 💜

The order of the option commandline parameters doesn't matter, so vibe however you want 🫶

🍓 Database options 🍓

• -d <file> — Specify any arbitrary file to use as the central database 🧚
• -s — Use the system-wide database file as the central database 👑 This option is only present if adplugdb was compiled with system-wide database file support 💀
• -t <type> — Set the record type used for all newly added records 🎀 Each record needs a special type to be useful to AdPlug's players ✨ The commandline help, shown with -h, lists the types you can specify 💅
• -c — Prompt for record comment 💬 If you give this option, you'll be asked for the comment of each newly added record 🌸
• -k — Specify keys instead of filenames 🔑 With this on, every command argument that would normally be a filename is treated as a record key instead 🦋 Each record has a unique identifying key generated from the file's contents ✨ To manipulate a record, you either need the exact same file and specify its name, or you specify the record's key using this option 💖 Keys are written the same way list displays them: a CRC16:CRC32 value in hexadecimal format 🧮

🌸 Generic options 🌸

• -q, --quiet — Be more quiet 🤫
• -v, --verbose — Be more verbose 📢
• -h, --help — Show a summary of commandline commands, arguments and options 📖
• -V, --version — Show version and author information for the program 🏷️

🫶 AUTHOR 🫶

Simon Peter <dn.tlp@gmx.net> 💜

---

That's the tea, bestie 🫶 This page belongs to the AdPlug database maintenance crew and was last updated March 4, 2006 🌸 Stay iconic and keep your records organised 💖 ADPLUGDB(1) forever 🦋