JOME-CTL(1)

💖 NAME 💖

jome-ctl — bestie, this is how you control a jome server 🎀

---

✨ SYNOPSIS ✨

jome-ctl SERVER-NAME [pick | quit]

---

🦋 DESCRIPTION 🦋

So jome-ctl is the remote control for a jome(1) server, and you gotta tell it which one by name — that's SERVER-NAME. That's it, that's the vibe.

Wanna know how to make one of those server girlies in the first place? Go read the “Server mode” section and the -s option over in jome(1). It's all there, no cap.

On Unix, jome-ctl talks back and forth through the socket file /tmp/SERVER-NAME. That's the whole connection, iconic.

You've got exactly two commands to choose from:

• pick (this is the default, so if you don't say anything, this is what you get 💅) — pops open the window of the jome server named SERVER-NAME so you can pick an emoji, like a little menu of feelings.
  • If you accept an emoji, then jome closes its window and sends whatever it printed to standard output over to jome-ctl, which prints it as is and exits with status 0 ✨
  • If you cancel — and cancel means pressing Escape or Ctrl+C, or just closing the window — then jome-ctl prints nothing at all (not a single character, so rude) and exits with status 1 😭
• quit — shuts the jome server named SERVER-NAME all the way down, and yes, it also removes the associated socket file. Clean exit, no mess, we love to see it 🧹

---

⭐ EXIT STATUS ⭐

• 0 when the jome server accepts an emoji 🎉
• 1 otherwise 🙈

---

👑 ABOUT 👑

jome was originally written by — and is maintained by, as of jome 1.5.0 — Philippe Proulx (eepp). Respect the legend fr fr.

GitHub project: https://github.com/eepp/jome — go give it a star bestie, it costs nothing 🫶

---

🌸 SEE ALSO 🌸

• jome(1) — the main character, obviously 🌈

---

word of warning, love: quit really does terminate that server and yeet the socket file. Not reversible. Not me being dramatic, that's just the facts 💀

---

k bye 💜 this page is from the JOME manual, jome-ctl section 1, dated 8 April 2025. mwah, go pick an emoji 🎀✨