BROADWAYD(1)

💅 BROADWAYD — ok bestie, let's talk about the Broadway display server

(that's broadwayd from the User Commands manual, if you're keeping track 🎀)

---

✨ NAME ✨

broadwayd — the Broadway display server, aka the little server that makes your GTK+ windows show up in a browser instead of on a screen. no cap. 🦋

---

🌸 SYNOPSIS 🌸

broadwayd [--port PORT] [--address ADDRESS] [--unixsocket ADDRESS]
          [:DISPLAY]

---

💖 DESCRIPTION 💖

okay so. broadwayd is a display server for the Broadway GDK backend. what that means in group-chat terms: it lets multiple GTK+ applications all put their windows up in the same web browser, just by connecting to broadwayd. iconic behaviour honestly. 👑

when you're using broadwayd, you gotta tell it which display number to use, prefixed with a colon — literally just like X does it. and if you don't say anything? the default display number is 0. 🙈

broadwayd :5

then you point your web browser at http://127.0.0.1:8085. yes, that port. that's the one. ✨

and you start your apps like this, bestie:

GDK_BACKEND=broadway BROADWAY_DISPLAY=:5 gtk3-demo

you can also add password protection for your session 💅 by creating a file in $XDG_CONFIG_HOME/broadway.passwd or $HOME/.config/broadway.passwd with a crypt(3) style password hash inside. a simple way to generate that hash is with openssl:

openssl passwd -1  > ~/.config/broadway.passwd

lowkey obsessed with how easy that is. one line and you're locked in. 🔥

---

🎀 OPTIONS 🎀

• --port — use PORT as the HTTP port instead of the default, which is 8080 + (DISPLAY - 1). yes, the default does math. it's giving ✨calculated✨.
• --address — use ADDRESS as the HTTP address instead of the default http://127.0.0.1:PORT. main character energy, your own address. 🌈
• --unixsocket — use ADDRESS as the unix domain socket address. this one is powerful, ok? it overrides --address and --port. and heads up: it's available only on Unix-like systems. 👑

---

🫶 and that's the whole page, bestie

source: GTK+, and it's the BROADWAYD(1) page from the User Commands manual section. periodt. 💖🌸🦋 go run broadwayd :5 and make something pretty.