osmotv(1)

💖 NAME 💖

osmotv — the iconic little tool that's literally just vibing at http://osmocom-analog.eversberg.eu/docs/ 🦋✨

🌸 SYNOPSIS 🌸

okay bestie, here's the whole vibe in one code block:

osmotv -f <frequency> | -c <channel>  <command>

so you give it a frequency OR a channel, and then you hand it a command. that's the whole deal. 💅

✨ command: ✨

pick your fighter, fr fr 👑

• tx-fubk — sends out the FUBK test image (that's the German PAL image, iconic)
• tx-ebu — sends out the EBU test image, aka color bars 🌈
• tx-convergence — sends out a convergence grid so you can adjust color
• tx-black — sends out a single color image 🖤
• tx-blue — sends out a single color image 💙
• tx-red — sends out a single color image (this one's for DY adjustment) ❤️
• tx-magenta — sends out a single color image 💜
• tx-green — sends out a single color image 💚
• tx-cyan — sends out a single color image 🩵
• tx-yellow — sends out a single color image 💛
• tx-white — sends out a single color image 🤍
• tx-vcr — sends out Jolly's VCR test pattern 📼
• tx-img [<image>] — sends out a natural image, or whatever image file you gave it
  • pro tip: use a 4:3 image with 574 lines for the best result. no cap. 🫶

🎀 general options: 🎀

• -h, --help — this help, bestie. the little map. 🗺️
• --config [~/]<path to config file> — give it a config file to use. if it starts with ~/, the path is in your home dir. every line in the config file is one option, and you must NOT put - or -- in there! ⚠️
• -f, --frequency <frequency> — give the frequency in Hertz 📡
• -c, --channel <channel> — or give a channel number instead. special channels start with s or S. use list to get a channel list 📋
• -s, --samplerate <frequency> — give the sample rate in Hertz 🎚️
• -w, --wave-file <filename> — output to a wave file instead of going out over SDR 🌊
• -r, --realtime <prio> — set the prio: 0 to disable it, 99 for maximum (default = 0) ⏱️

💫 signal options: 💫

• -F, --fbas 1 | 0 — turn color on or off (default = 1) 🎨
• -T, --tone 1 | 0 — turn tone on or off (default = 1) 🔊

🌟 FUBK options: 🌟

• -R, --circle-radius <radius> | 0 — use a circle radius, or 0 for off (default = 6.7) ⭕
• -C, --color-bar 1 | 0 — 1 == Color bar on, 0 = show the complete middle field (default = 0). for a clean scope signal, also turn the circle off by setting radius to 0. 🔵
• -G, --grid-only 1 | 0 — 1 == show only the grid of the test image (default = 0) 📐
• -I, --sation-id "<text>" — give exactly 12 characters to display as the Station ID (default = "Jolly Roger") 📛

🦋 convergence options: 🦋

• -W, --grid-width 2 | 1 — thickness of the grid (default = 0) 🖊️

👑 SDR options 👑

• --limesdr — auto-selects several required options for LimeSDR 🍋
• --limesdr-mini — auto-selects several required options for LimeSDR Mini 🍋‍🟩
• --sdr-soapy — force the SoapySDR driver 🧼
• --sdr-channel <channel #> — give the channel number for a multi channel SDR device (default = 0) 🔢
• --sdr-device-args <args> — (see the trio below, they all share one explanation)
• --sdr-stream-args <args> — (same vibe)
• --sdr-tune-args <args> — optional SDR device arguments, separated by comma, e.g. --sdr-device-args <key>=<value>[,<key>=<value>[,...]] 🧾
• --sdr-samplerate <samplerate> — the sample rate to use with SDR. by default it equals the regular sample rate 🎚️
• --sdr-lo-offset <Hz> — give a frequency offset in Hz to move the local oscillator away from the target frequency (default = -3000000) 🎯
• --sdr-bandwidth <bandwidth> — give the IF filter bandwidth to use. if you don't, the sample rate gets used instead 📶
• --sdr-rx-antenna <name> — the SDR device's RX antenna name, use list to get a list 📡
• --sdr-tx-antenna <name> — the SDR device's TX antenna name, use list to get a list 📡
• --sdr-clock-source <name> — the SDR device's clock sourc name, use list to get a list ⏰
• --sdr-rx-gain <gain> — the SDR device's RX gain in dB (default = 0.0) 📈
• --sdr-tx-gain <gain> — the SDR device's TX gain in dB (default = 0.0) 📈
• --write-iq-rx-wave <file> — write the received IQ data to the given wave file ✍️
• --write-iq-tx-wave <file> — write the transmitted IQ data to the given wave file ✍️
• --read-iq-rx-wave <file> — replace the received IQ data with the given wave file 🔁
• --read-iq-tx-wave <file> — replace the transmitted IQ data with the given wave file 🔁
• --sdr-swap-links — swap the RX and TX frequencies so you can do loopback tests over the air 🔄
• --sdr-timestamps 1 | 0 — use TX timestamps on the UHD device (default = 1) 🕐

and that's the whole page, bestie. every flag, every default, nothing skipped, periodt. 💅

this was osmotv(1) from the General Commands Manual — mwah, go slay some test patterns 🎀💖✨