GNUAIS(1)

💖 GNUAIS(1) — the manual, but make it make sense 💖

okay bestie, pull up a chair, we're reading a General Commands Manual page together and it's gonna be adorable. this one's for gnuais 🎀

🌸 NAME 🌸

gnuais — the GNU Automatic Identification System receiver. yes, that AIS. the boat one. she's a receiver, she's GNU, she's iconic. 💅

✨ SYNOPSIS ✨

gnuais [options]

that's it. that's the whole vibe. options optional, boat messages mandatory (jk, it needs a signal, see below 👇).

🦋 DESCRIPTION 🦋

okay so first things first: this manual page is just a brief little rundown of the gnuais command. quick lil summary, not a novel. 📖

so gnuais is a tool for demodulating and decoding AIS messages using the line/mic input of your sound card. yes, the actual audio jack. she listens. 👂✨

here's the setup, fr fr:

1. take the discriminator output of a VHF receiver
2. tune that receiver to either 161.975 MHz or 162.025 MHz (pick one, queen)
3. plug it into the line/mic input of your sound card
4. then run gnuais with no options at all, or with some of the options described below

that's the whole ritual. no cap. 🔥

👑 OPTIONS 👑

here's a summary of the options, all of them, every single one, we are not skipping a single flag in this house 💖

• -c <filename> — Specify config file to use. If not specified, a gnuais.conf file in the current directory is searched for, if not found, ~/.config/gnuais/config is used. so like, she looks next to you first, then she checks your home. cute. 🏠
• -f — Runs gnuais in the background. she's mysterious now. she's in the background. main character energy. 💅
• -h — Shows the short command use info. the lil help moment. 🙈
• -l <filename> — Runs with raw audio data from file. so you can feed her a file instead of the live wire. 🎧
• -s <filename> — Saves raw audio data to file. she's recording. she's documenting. she's keeping receipts. 📝
• -e <level> — Log level: INFO, DEBUG, NOTICE, WARNING, ERR, CRIT, ALERT, EMERG. that's the whole ladder, from "just chatting" to "🚨 EMERG 🚨". choose your drama level.
• -o <dest> — Log destination: none, file, stderr, syslog. where do the lil log messages go? you decide. 🎀
• -r <dir> — Log directory. the folder where the logs live. her apartment. 🏡
• -n <name> — Name of the log. give her a name. she deserves one. ⭐

🔥 SEE ALSO 🔥

gnuaisgui(1) — go look at her graphical sister too, she's also slaying. 💜

🌈 AUTHOR 🌈

This manual page was written by Ruben Undheim <ruben.undheim@gmail.com>, for the Debian project (and may be used by others). ty for the lore, Ruben, we appreciate you fr fr 🫶

and that's the page bestie!! this is GNUAIS(1) from the General Commands Manual, dated August 07, 2013 — older than some of us but the info still hits. go decode some boats, you absolute legend 👑✨🦋💖