FM(1)

💖 FM(1) — the manual page for fm, bestie 💖

okay so real talk, this is section 1 of the General Commands Manual, and today's main character is fm. she's little, she's powerful, she tunes your radio. let's get into it 🫶

✨ NAME ✨

fm — control frequency, volume, and mute/unmute of an FM radio card. that's it, that's the job, and she ate 💅

🌸 SYNOPSIS 🌸

fm [ -h ] [ -o ] [ -q ] [ -d device ] [ -t tuner ] [ -T none | forever |
       time ] on | off | + | - | freq [ volume ]

like yes, that's a lot of brackets, but it's giving flexible, not scary 💖

🦋 DESCRIPTION 🦋

fm is a program that controls the frequency, volume, and mute/unmute state of an FM radio card. it does this using the video4linux interface, which was introduced back in the 2.1.x series Linux kernels. no cap, she's been doing this a minute and she still slays 🌈

🎀 OPTIONS 🎀

• -h — prints a usage message to standard output, and then exits. the classic "help me bestie" move 🙈
• -o — ignores the frequency range limits of the card. use this one if you suspect that your card actually supports a wider frequency range than its driver believes it does. living beyond the driver's expectations, iconic 👑
• -q — quiet mode. keeps information on station and volume from being printed on standard output. sometimes you just want peace and quiet, and honestly? valid 🧚
• -d device — sets device as the device to tune. the default is /dev/radio0. ✨
• -t tuner — sets tuner as the tuner on the selected device to adjust. the default is tuner 0. most radio devices have only a single tuner, so like, lowkey you'll never touch this one 🌸
• -T none | forever | time — after tuning, sleep for the time specified, or forever. time is specified in seconds by default. a suffix of m indicates minutes, h indicates hours, or d indicates days. ⏰

the -T option is useful with radio card drivers that only maintain the tuner settings while the tuner's file descriptor remains open. try using this option if running fm ordinarily produces only a single "pop" from your speakers. that one sad little pop is not the vibe, bestie 💀

• freq — the frequency to tune the radio to, in MHz. for instance, 88.9 specifies a frequency of 88.9 MHz. AM tuner values are also specified in MHz; for instance, 530 kHz would be specified as .530. yes, the leading dot is on purpose, don't come for her 🍓
• on — turn the radio on (unmute). sound ON, main character energy 🎀
• off — turn the radio off (mute). shhh 🤫
• volume — specify the desired volume, in percent. not all radio devices support volume control, so if yours doesn't, that's not on fm 😭
• + — increase the current volume. turn it up bestie 🔥
• - — decrease the current volume. okay fine, turn it down 💜

💜 CONFIGURATION 💜

fm reads $HOME/.fmrc, if it exists, to obtain default settings. each line may take one of the following forms:

• VOL percent — specifies default volume (default: 12.5%). ✨
• INCR percent — volume increment used for + and - options (default: 10%). 💫
• TIME — default sleep time (default: none). 😴

all other lines are ignored. she's not nosy, she just minds her business 💅

🌈 SEE ALSO 🌈

additional documentation:

• /usr/share/doc/fmtools/README

the fmtools homepage:

• http://benpfaff.org/fmtools

👑 AUTHORS 👑

Russell Kroll <rkroll@exploits.org>, now maintained by Ben Pfaff <blp@cs.stanford.edu>. the sleep time feature was contributed by Dave Ulrick <d-ulrick@insightbb.com>. this manpage was written by Ben Pfaff.

and that's the whole page, bestie!! every flag, every default, every file path, all present and accounted for, no crumbs left behind 🫶

kisses, this was fm version 1.0.2, section FM(1), mwah 💖✨🎀🦋