man(1)

✨ NAME ✨

/executable β€” the Profanity /executable command, bestie πŸ’…

yes this is literally a whole man page for one lil slash command and honestly? she earned it.


πŸ’– DESCRIPTION πŸ’–

okay so, you know how you want a certain command to trigger a certain program? 🌸 That's what this is. You're configuring which executable gets called when you run a particular command. Set it once, vibe forever. ✨


πŸŽ€ SYNOPSIS πŸŽ€

/executable avatar set <cmdtemplate>

/executable avatar default

/executable urlopen set <cmdtemplate>

/executable urlopen default

/executable urlsave set <cmdtemplate>

/executable urlsave default

/executable editor set <cmdtemplate>

/executable editor default

/executable vcard_photo set <cmdtemplate>

/executable vcard_photo default

🫢 ARGUMENTS 🫢

  • avatar set β€” tells Profanity what program to run when you do /avatar open. Point it at your fave image viewer, no cap. πŸ–ΌοΈ
  • avatar default β€” puts everything back the way it was, we're restoring the default settings 🫢
  • urlopen set β€” sets the executable that gets run by /url open. It takes a command template, and inside that template %u gets swapped for the URL and %p gets swapped for the path, respectively. πŸ”₯
  • urlopen default β€” restore to default settings, back to factory vibes ✨
  • urlsave set β€” sets the executable that gets run by /url save. Takes a command template that swaps %u and %p for the URL and the path respectively. πŸ’Ύ
  • urlsave default β€” uses the built-in download method for saving, so like, Profanity handles it herself, periodt πŸ‘‘
  • editor set β€” sets the editor used with /editor. Heads up bestie: it needs a terminal editor, or a script that launches a graphical one. Don't just throw a GUI at it and expect ✨ magic ✨
  • editor default β€” restore to default settings, we love a reset πŸŽ€
  • vcard_photo set β€” sets the executable run by /vcard photo open. Takes a command template where %p gets replaced with the path πŸ“
  • vcard_photo default β€” restore to default settings (yes, again, it's iconic) πŸ’œ

🌸 EXAMPLES 🌸

/executable avatar xdg-open

/executable urlopen set "xdg-open %u"

/executable urlopen set "firefox %u"

/executable urlopen default

/executable urlsave set "wget %u -O %p"

/executable urlsave set "curl %u -o %p"

/executable urlsave default

/executable vcard_photo set "feh %p"

/executable editor set "emacsclient -t"
okay quick note: if you're copy-pasting these, keep the quotes around the templates, they're doing work πŸ’…

that's the whole thing!! go set your executables, you're doing amazing, main character energy only πŸŒˆπŸ¦‹

this page came to you from version 0.18.2, dated 2026-06-08, under the Profanity XMPP client manual umbrella β€” mwah, xoxo, see you in man(1) πŸ’–

πŸ“¦ where this page comes from