TELEPATHY-RAKIA(8)

💖 TELEPATHY-RAKIA 💖

okay bestie, welcome to the telepathy-rakia(8) manual page, aka the glow-up guide to the SIP connection manager of your dreams ✨

🌸 NAME 🌸

telepathy-rakia — the Telepathy connection manager for SIP, and yes she serves 🫶

🎀 SYNOPSIS 🎀

/usr/lib/telepathy/telepathy-rakia

that's it. that's the whole invocation. iconic, honestly 💅

🦋 DESCRIPTION 🦋

so like, telepathy-rakia implements the Telepathy D-Bus specification for the Session Initiation Protocol — SIP for short, iykyk — which means Telepathy clients like empathy(1) can connect to Voice over IP providers that implement SIP. it's giving matchmaker, but for your calls 🔥

she's a D-Bus service, and she runs on the session bus. normally? she just starts herself automatically via D-Bus activation, no effort required, main character energy fr fr. but — and this is the tea — it might be useful to start her manually when you're debugging 👀

✨ OPTIONS ✨

and the options are... drumroll please... 🥁

• there are no command-line options.

that's the whole section. she said "no flags, only vibes" 💀

🌈 ENVIRONMENT 🌈

okay this is where it gets juicy, bestie — she reads a bunch of environment variables and they do stuff:

• RAKIA_DEBUG=type — set this to "all" for full debug output 💖 or, alternatively, to various undocumented options to filter the output. heads up though: those undocumented options may change from release to release, so don't get too attached 😭
• RAKIA_LOGFILE=filename — point this at the name of a file and she'll overwrite it with log messages. want to keep the old stuff instead? prefix the filename with + and she'll append messages to an existing file instead of overwriting it. queen of choices 👑
• RAKIA_PERSIST — set this to any value and you'll stop telepathy-rakia's usual automatic exit that happens when there have been no connections for a few seconds. she will simply ✨ stay ✨ periodt
• TPORT_LOG — set this to any value and she'll print all parsed SIP messages at the transport layer 🔥 (this functionality is provided by the underlying Sofia-SIP library, which also offers various more specialized debugging options, if you're the type to go deeper 👀)

ngl, if something's acting up, RAKIA_DEBUG=all is your bestie's bestie. just saying 💜

👑 SEE ALSO 👑

• http://telepathy.freedesktop.org/
• empathy(1)

and that's the page, babe 💖 written under the Telepathy name, dated February 2010 — yeah she's vintage, she's a classic, and she still slays. mwah 🎀✨