XPRA_LAUNCHER(1)

💖 NAME 💖

xpra_launcher — your lil' user interface for connecting to a Xpra session 🫶

---

✨ SYNOPSIS ✨

xpra_launcher [FILENAME]

---

🌸 DESCRIPTION 🌸

okay so bestie, xpra_launcher is the tool that lets you connect to a remote xpra(1) session through a graphical user interface — yes, buttons, windows, the whole aesthetic ✨. And it can also read a pre-configured session file, which is so convenient of it.

When you call it with no FILENAME, xpra_launcher will spawn a GTK window so you can set all your connection parameters easily, no stress 💅.

But if you do pass a FILENAME, then the parameters in the GUI get pre-set to whatever values live in that session file. And — plot twist 👑 — if that session file contains the special parameter autoconnect, xpra_launcher will skip showing you the parameters window entirely and just establish the connection directly. main character energy, honestly.

---

🎀 SESSION FILE 🎀

The format of the session file you hand to xpra_launcher as a parameter is a series of parameter = value lines. And the tea ☕ is that most of the options you'd get through the xpra command line are also available in the session file. For instance:

• host — tell it the remote host to connect to 🖥️
• port — tell it the remote port to connect to 🔌
• encoding — pick your encoding type: h264, jpeg, png, ... if you want the full list of available encodings, go check xpra --help 🦋
• quality — sets the image quality when you're using lossy encodings. values are 1-100 ✨
• mode — connection mode: tcp or ssh 🌈
• autoconnect — specify whether to establish the connection immediately (True) or just pre-fill the parameters so the user can review them (False, which is the default) 🙈

---

👑 SEE ALSO 👑

xpra(1)

---

that's the whole vibe bestie, go forth and connect 💜 this was XPRA_LAUNCHER(1) from the General Commands Manual, mwah 🎀🫶