zeitansage(1)

🎀 NAME 🎀

okay so bestie, meet zeitansage 💖 — the docs live right here: http://osmocom-analog.eversberg.eu/docs/. that's the whole description, that's the vibe, it's giving "go read the docs". this page is zeitansage(1), from the General Commands Manual (section 1, so she's a command, not a syscall, periodt).

✨ SYNOPSIS ✨

zeitansage -k <kanal/channel> -c hw:0,0 [options] [station_id]

like, that's the shape of it. channel + call device + whatever options + optionally a station id. slay.

🌸 Global options 🌸

• -h --help — This help. literally just the help. iconic.
• --config [~/]<path to config file> — hand her a config file to use 🫶. if the path starts with ~/, that path is at your home dir. every single line in the config file is one option, and ngl this is the part people mess up: - or -- must not be given in there! Default: ~/.osmocom/analog/zeitansage.conf.
• --no-config — even if a config file exists, don't use it. ghosted. 💅
• -v --verbose <level> | <level>,<category>[,<category>[,...]] | list — use list to get a list of all levels and categories, like a lil menu 🎀. Verbose level: digit of debug level (default = 3). Verbose level+category: level digit followed by one or more categories -> if no category is specified, all categories are selected. no cap.
• -v --verbose date — show date with debug output. timestamps, bestie 🕐.
• -k --kanal <channel> — Channel (German = Kanal) number of "Sender" (German = Transceiver). ja, wir sind multilingual hier ✨.
• -k --channel <channel> — same thing, same option, just the English spelling. Channel (German = Kanal) number of "Sender" (German = Transceiver).
• -a --audio-device hw:<card>,<device>[/hw:<card>.<rec-device>] — Sound card and device number (default = hw:0,0). You may specify a different recording device by using /. > Don't set it for SDR! (that's not a suggestion, that's a warning 🚨)
• -s --samplerate <rate> — Sample rate of sound device (default = 48000).
• -i --interval 0.1..25 — Interval of processing loop in ms (default = 1.0 ms). Use 10 to drastically reduce CPU usage 🔥. In case of buffer underrun, increase buffer accordingly.
• -b --buffer <ms> — How many milliseconds are processed in advance (default = 50). A buffer below 10 ms requires low interval like 0.1 ms. math is mathing 📐.
• -p --pre-emphasis — Enable pre-emphasis, if you directly connect to the oscillator of the transmitter. (No pre-emphasis done by the transmitter.)
• -d --de-emphasis — Enable de-emphasis, if you directly connect to the discriminator of the receiver. (No de-emphasis done by the receiver.)
• --rx-gain <dB> — Raise/lower receiver's RX level by given gain in dB. (Works with sound card only.)
• --tx-gain <dB> — Raise/lower transmitters's RX level by given gain in dB. (Works with sound card only.)
• -e --echo-test — Use echo test, to send back audio from mobile phone's microphone to the speaker. (German: Blasprobe). you yell, it yells back 😭 iconic behaviour.
• -c --call-device hw:<card>,<device>[/hw:<card>.<rec-device>] — Sound card and device number for headset (default = ``). You may specify a different recording device by using /.
• --call-samplerate <rate> — Sample rate of sound device for headset (default = 48000).
• --call-buffer <ms> — How many milliseconds are processed in advance (default = 50).
• -x --osmocc-cross — Enable built-in call forwarding between mobiles 📞➡️📞. Be sure to have at least one control channel and two voice channels. Alternatively use one combined control+voice channel and one voice channels.
• -o --osmocc-sock — Disable built-in call control and offer socket.
• --cc "<osmo-cc arg>" [--cc ...] — Pass arguments to Osmo-CC endpoint. Use -cc help for description. yes you can stack them, she's flexible 💅.
• --no-l16 — Disable L16 (linear 16 bit) codec.
• -t --tones 0 | 1 — Connect call on setup/release to provide classic tones towards fixed network (default = 1).
• -l --loopback <type> — Loopback test: 1 = internal | 2 = external | 3 = echo. pick your fighter ✨.
• -r --realtime <prio> — Set prio: 0 to disable, 99 for maximum (default = 0).
• --fast-math — Use fast math approximation for slow CPU / ARM based systems. for the lil guys 🥺🫶.
• --write-rx-wave <file> — Write received audio to given wave file.
• --write-tx-wave <file> — Write transmitted audio to given wave file.
• --read-rx-wave <file> — Replace received audio by given wave file.
• --read-tx-wave <file> — Replace transmitted audio by given wave file.

🦋 Network specific options 🦋

• -G --gain — Gain of audio level relative to 1 mW on a 600 Ohm line. (default = -16)
• -A --alerting — Play as early audio while alerting. Don't send a connect. it's the "hey bestie i'm here" before the actual call 👑

Press digits 0..9 and then d key to dial towards mobile station. Press h key to hangup. Press w key to toggle display of RX wave form. Press c key to toggle display of channel status. Press m key to toggle display of measurement value. keyboard go brrr 🎹✨

and that's the whole page, bestie 🌈 — footer's just zeitansage(1), straight from the General Commands Manual, no extra source or version line, no date, just vibes and a manual name 💖💅🦋