VM(1)

💖 VM — the VoiceModem bestie 💖

okay so ✨ this is vm, from the mgetty fam, and she is literally the program that handles all the voice modem functionality so you can drive it straight from your shell scripts. no cap. she's the plug for talking to your modem's voice side. 🎀

---

🌸 ACTIONS 🌸

here's the menu of things she can do, bestie. each one takes its own little set of options:

• beep options [<frequency [<length in 0.001sec>]]> — makes the modem go beep, and you can tell it the frequency and how long it lasts in thousandths of a second 💅
• diagnostics options device name (e.g. ttyS2) — runs the diagnostics vibe check on a device
• dial options phone number — dials the number, obviously 🦋
• help — she tells you how to use her, iconic
• play options [<file names]+> — plays your file(s) out loud, one or many
• record options file name — records into a file, main character energy
• shell options [<shell script [shell options]]> — runs a shell script (and you can pass the script's own options along too)
• wait options [<time in seconds]> — just vibes. waits. ⏳
• devicetest — tests the device, no arguments needed, she just goes

---

✨ OPTIONS ✨

all the flags, all the details, zero skips:

• -c n — use compression type n
• -d n — set the i/o device
• -t, -m, -i, -e, -s, -H — these are all equals to -d <2,3,4,5,6,7> (so -t is -d 2, -m is -d 3, and so on down the line — cute shortcuts fr fr)
• -l s — set the device string (e.g. -l ttyS2:ttyC0)
• -v — verbose output, she'll tell you everything 🗣️
• -w — use the off / on hook signal from the local handset to start and stop recording
• -x n — set the debug level
• -L n — set the maximum recording length in sec
• -P — print the first DTMF tone on stdout and exit
• -R — read and print the DTMF string on stdout and exit
• -S s — set the default shell for shell scripts (e.g. -S /bin/sh)
• -T n — set the silence timeout in 0.1sec
• -V n — set the silence threshold to n (0-100%%)

🫶 heads up bestie: -V takes a percentage from 0 to 100%%, and -T is measured in tenths of a second — keep those units straight or your silence detection will be doing its own thing 😭

---

👑 SEE ALSO 👑

• vgetty(1) — go read that one too, they're a matching set 💜

---

and that's the whole page, periodt. this was written up in the mgetty manual, rendered by perl v5.34.0, dated 2022-04-14 — love that for us 🌈💖✨