TWILOG(1)

💖 TWILOG(1) — the General Commands Manual girlies' edition 🎀

okay so bestie, this is twilog, and she lives in section 1 of the general commands manual. yes, the manual. iconic. let's get into it ✨

---

🌸 NAME 🌸

twilog — download Twilio notifications and log them to syslog. that's the whole gig. she fetches, she logs, she slays 💅

---

🦋 SYNOPSIS 🦋

twilog [-d] [-i] [-m] [-c config] [-f facility] [-t tag] [-s statefile]

---

✨ DESCRIPTION ✨

so twilog downloads your Twilio notifications using the Twilio REST API and logs them to syslog. like, that's her job and she's obsessed with it 🫶

and here's the part that's genuinely so smart: twilog keeps track of which notifications she's already downloaded between invocations, so only the new ones get logged. no duplicates, no spam, no chaos. main character energy fr fr 💖

normally you'd invoke twilog from a cron(8) script. she's a background gorl. she works while you sleep 🌙

---

🌈 OPTIONS 🌈

• -c — specify the configuration file.

so this file is simply a shell script, and when it gets sourced it must define the ACCOUNT_SID and AUTH_TOKEN shell variables containing the corresponding Twilio credentials. that's it. that's the requirement. don't overthink it 💅

if you don't specify one, /etc/twilio.conf is assumed. default behavior, love that for us.

• -d — run in debug mode. instead of logging notifications to syslog, print them to standard output. perfect for when you're like "wait what is she actually doing" 👀
• -f — specify the syslog facility. the default is user.
• -i — include the Notification's SID in the message. yes, capital-N Notification, that's how the manpage says it, we respect it 💜
• -m — include the notification's original timestamp in the message. timestamps!! so you know when things went down ⭐
• -t — specify the syslog tag. the default is twilog. (cute name, no notes 🎀)
• -s — specify the state file used to maintain state between invocations. the default is /var/lib/twilog/state.${ACCOUNT_SID} — note that ${ACCOUNT_SID} gets expanded, she's per-account, very exclusive 💅

---

🔥 EXIT STATUS 🔥

twilog exits zero normally, or 1 if an error occurs. simple. clean. no cap.

errors returned from the Twilio REST API get reported to standard error. so if something goes wrong on the Twilio side, check stderr bestie 😭

---

💀 BUGS 💀

okay so this is the one you gotta know about: if more than 1000 notifications have been created since the last time twilog was run, only the most recent 1000 will be logged. the rest? gone. not logged. 🙈

so like… run her regularly, alright? don't leave her hanging for a month and then act surprised. the 1000 limit is real and she's not joking.

---

🧚 SEE ALSO 🧚

cron(8), logger(1), twimsg(1), twils(1), twirm(1), twiping(1), smslen(1). the whole friend group 🫶 go read them, they're all serving.

---

👑 AUTHOR 👑

Archie L. Cobbs <archie.cobbs@gmail.com> — thank you for this gift, king 🫡

---

and that's the page!! 💖 this edition came to you from Debian, dated May 17, 2013 — yes she's a vintage icon and she still eats 🌸✨🎀