PURPLE-REMOTE(1)

💜 NAME 💜

purple-remote — ok bestie, this is the lil glow-up tool that sends remote commands straight to Pidgin and Finch. That's it. That's the whole job. 💅

(Also, hi, this is the page for PURPLE-REMOTE(1) from the General Commands Manual — folding that in here so we're all caught up 🫶)

✨ SYNOPSIS ✨

purple-remote command1 command2 ...

Yeah. You just feed it commands. One, or a whole lil stack of them. Go off. 🌈

🎀 OPTIONS 🎀

Not me using "options" for command shapes, but periodt, each command you pass is one of these three types:

• [protocol:]commandname?param1=value1&param2=value2&... — the main character form, the one you actually want 💖
• FunctionName?param1=value1&param2=value2&... — exists, technically works, but listen...
• FunctionName(value1,value2,...) — also exists, also technically works, and again...

Okay real talk: those second and third forms are there for completeness, but their use is not recommended — the docs literally say use purple-send or purple-send-async instead. And the second form? It uses introspection to figure out the parameter names and their types, so it is rather slow. Not the vibe. 🐌

🌸 EXAMPLES 🌸

Look at these. Ate. No crumbs. 🔥

jabber:goim?screenname=testone@localhost&message=hi
jabber:gochat?room=TestRoom&server=conference.localhost
jabber:getinfo?screenname=testone@localhost
jabber:addbuddy?screenname=my friend

setstatus?status=away&message=don't disturb
quit

PurpleAccountsFindConnected?name=&protocol=prpl-jabber
PurpleAccountFindConnected(,prpl-jabber)

(Yes the blank lines are doing something. They're separating the vibes. ✨)

🦋 DESCRIPTION 🦋

You send remote commands to Purple. That's the tea. ☕

The way it pulls this off is DBus — that's the lil messenger running between this program and Pidgin/Finch. iykyk 💫

👑 LICENSE 👑

Copyright (c) 1998-2006 see: AUTHORS

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2, as published by the Free Software Foundation. 💜

🧚 AUTHORS 🧚

Sean Egan <seanegan@gmail.com> — Lead Developer 👑

This manual page was written by Anibal Avelar <avelar@gmail.com>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation. 🫶

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL. 📜

And that's a wrap on purple-remote(1) from the General Commands Manual, bestie — go send some commands, you've got this 💖✨🎀🦋🌸💅🫶