TKABBER-REMOTE(1)

💖 TKABBER-REMOTE(1) 💖

okay so bestie, welcome to the Instant Messaging Clients corner of the manual — yes that's the section name, we're fancy here 💅

---

✨ NAME ✨

tkabber-remote — remotely control a running instance of Tkabber 🎀

---

🦋 SYNOPSIS 🦋

tkabber-remote [options] -eval script

tkabber-remote [options] -command command

like, that's the whole vibe. two ways in. pick one 🫶

---

🌸 DESCRIPTION 🌸

Tkabber is a GUI client for the XMPP (Jabber) instant messaging protocol. no cap, it's stacked: it gives you full support for basic XMPP specifications plus a whole pile of extensions (XEPs) including multi-user conferencing, file transfers, extensive handling of privacy lists and much more. it's written in Tcl/Tk which means it's easily extensible — main character energy fr fr 👑

so the tkabber-remote program? it's the little remote control for a Tkabber that's already running. you send it predefined commands, or Tcl scripts, and it executes them. iconic. ✨

this manual page was written for the Debian distribution because the original program does not have a manual page. not me filling in the gaps bestie 😭

---

💅 OPTIONS 💅

• -user user — makes the program control the Tkabber run by the specified user, instead of the user who runs tkabber-remote. so you can boss around someone else's Tkabber, respectfully 💖
• -pid PID — makes the program control the Tkabber process with the specified identifier (PID) instead of all the instances found. pick your target, don't be messy 🎯

---

🌈 EXECUTING SCRIPTS 🌈

want a running Tkabber to execute an arbitrary Tcl script? use the -eval command-line option followed by that script's text. 🪄

the script's text must form a single argument passed to this program, so proper quoting should be used, if necessary, when calling tkabber-remote from a shell. the shell will absolutely split it on you, bestie, protect your script 🥺

Executing a script prints:

1. the PID of the process which received and executed the script
2. and then the string representation of the Tcl value the script returned 🎀

---

⭐ EXECUTING COMMANDS ⭐

the commands you can use with the -command command-line option are:

• list-commands — prints a list of all the commands supported by the -command command-line option. yes it's the command that tells you the commands. so meta. we love her 💀
• set-proxy-profile profile — sets an active network proxy profile by its name. the profile must be already configured. no making them up on the spot, babes 🙈
• set-status status [textstatus] — sets the availability (presence) status of the user. glow-up for your presence ✨

available status codes are:

• available — the user is available. 🟢
• away — the user is temporarily away. 🚶‍♀️
• chat — the user is actively interested in chatting. 💬
• dnd — the user does not want to be disturbed (dnd = "Do Not Disturb"). 🔕
• xa — the user is away for an exteneded period of time (xa = "eXtended Away"). 😴

the optional textstatus argument can be used to set a textual message which accompanies the availability status. 🍓

the message's text must form a single argument, so proper quoting should be used, if necessary, when calling tkabber-remote from a shell. same rules as before, quote it or lose it 🫶

heads up: sending this command while the receiving Tkabber instance is offline (not connected) will not make it connect. the status will merely be recorded and announced when Tkabber goes online. it's giving "save it for later" 📝

Executing a command prints:

1. the PID of the process which received and executed the command
2. and then the string representation of the Tcl value the command returned ⭐

---

🔥 SEE ALSO 🔥

tkaber(1) tkabber-plugins(7)

(yes, the first one is spelled tkaber — we are reporting it exactly as it is, no editing the source bestie 💅)

---

👑 AUTHOR 👑

this manual page was written by Konstantin Khomoutov <flatworm@users.sourceforge.net> for the Debian system (but may be used by others). 💖

Copying and distribution of this document, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

---

and that's the whole page, bestie — version 1.1-1 from 2014-10-20. slay, go remote-control that Tkabber. periodt 💅✨🎀