A modern X11 server for macOS, built in 30 days by a seasoned programmer and Agentic AI

Remote app launcher

One click from the Mac status menu to an X client running on a vintage Sun. Passwords in Keychain, optional verbose progress, two-stage menu grouped by host.

Remote app launcher
The Launchers config editor. A host block sets host and user once; each app block under it adds the command for one X app. Passwords come from the macOS Keychain, or set inline in the file.
The macXserver status menu showing the Launchers submenu pulled down, with one X app per row grouped by host.
Click the macXserver status menu, pick a host, pick an X app. The submenu is built from the entries in your launcher config (above).
The Launcher Progress window showing a verbose telnet session log.
The Launcher Progress window with verbose mode on, showing the full telnet transcript: connection, login, the DISPLAY export, and the xterm launch command. Useful while you're getting a new launcher entry working; once it runs cleanly, set verbose = false and the window stays hidden.

What it does

A two-stage menu in the macXserver status bar, grouped by host. Pick a vintage workstation; pick an X app. macXserver telnets in, sets DISPLAY to your Mac’s IP, and launches the app. The window appears on your Mac.

No more remembering the right telnet host, the right DISPLAY syntax, the right shell to use, the right path to the binary. Passwords live in the Mac Keychain. An optional verbose progress window shows you exactly what’s being sent over the wire if you want to see it.

Telnet only today. The SunOS 4.1.4 boxes this was built for don’t run sshd, so the launcher drives a telnet session. For modern hosts that do speak SSH, add it manually with ssh -X and DISPLAY set; an SSH transport for the launcher itself is a known follow-up.

When the X server is on your Mac and the X clients you actually want to run live on a Sun in the basement, the daily friction is the telnet-into-the-Sun part. That’s three steps every time: ssh-or-telnet, set DISPLAY correctly, run the binary. Multiplied across eight workstations and dozens of apps, it adds up. The launcher removes that friction.

The vintage Suns also have constraints: SunOS 4.1.4 doesn’t know about xterm-256color, the default shell prompts assume TERM=vt100, and the path to the binary depends on which release you’ve got mounted. The launcher negotiates TERM=xterm on the telnet connection so the remote shell’s prompt setup runs cleanly, and the per-host launcher configuration lets you encode the right path per Sun.

Technical detail

Launcher entries live in ~/.macxserver-launchers as a structured config file. A [host:NAME] block holds the connection settings for one machine, and each app is its own [NAME/label] block that inherits those settings and adds a command:

[host:ultra5]
host = ultra5.local
user = todd

[ultra5/xterm]
command = /usr/openwin/bin/xterm -bg black -fg white

[ultra5/xcalc]
command = /usr/openwin/bin/xcalc

[ultra5/quickplot]
command = /usr/local/quickplot/bin/quickplot

[host:ss2]
host = ss2.local
user = todd

[ss2/xterm]
command = /usr/bin/X11/xterm

The text after the / becomes the submenu label. Connection fields (host, user, port, shell_prompt, login_prompt, password_prompt, verbose) go once in the [host:NAME] block, so each app block usually needs only its command.

Passwords aren’t a config key you point at the Keychain. Omit password and the launcher prompts you once, then stores it in the macOS Keychain under the account user@host and reuses it on later launches. You can set password inline in the host block instead, but it’s plaintext, so skip that on a shared machine.

The launcher uses an interactive expect-style script under the hood to drive the telnet session: wait for the login prompt, send the user, wait for the password prompt, send the password, wait for the shell prompt, send TERM=xterm, send export DISPLAY=..., then send the binary launch. The optional progress window streams every line of the transcript so you can debug a misbehaving remote shell.

  • The launcher shipped Day 23 .
  • Two-stage menu grouping by host shipped Day 26 .
  • TERM=xterm negotiation shipped Day 24 .
  • Plaintext password field plus Keychain fallback shipped Day 25 .