RUNAPP(1)

💖 RUNAPP(1): runapp, the Linux desktop application runner 💖

okay so this is from the General Commands Manual, and the manual name is literally RUNAPP(1) — it's giving "let's launch desktop apps in the most systemd-correct way possible" and honestly? iconic. 🫶

🌸 NAME 🌸

runapp — Linux desktop application runner

✨ SYNOPSIS ✨

runapp [OPTIONS] COMMAND...

runapp --help

🦋 DESCRIPTION 🦋

runapp is an application runner for Linux desktop environments that integrate with systemd(1). It launches the given command in an appropriate systemd user unit, in accordance with systemd recommendations. no cap, that's its whole job. 💅

🎀 OPTIONS 🎀

• -v, --verbose — increase output verbosity. more yapping from runapp, basically. 🗣️
• -o, --scope — run command directly, registering it as a systemd scope; the default is to run it as a systemd service. so without this, service mode is the main character. 👑
• -i, --slice=SLICE — assign the systemd unit to the given slice. the name must include the .slice suffix, bestie — no suffix, no slay. default is app-graphical.slice. 🍰
• -d, --dir=DIR — run command in given working directory. yes, DIR is a whole mood and also a path. 📁
• -e, --env=VAR=VALUE — run command with given environment variable set; may be given multiple times. stack those --env flags like friendship bracelets. 🫶
• -c, --description=DESCRIPTION — set human-readable unit name (the Description= systemd property) to given value. iconic labeling behavior. 🏷️
• --help — show help. when in doubt, ask the manual. 🙋

🌈 EXAMPLES 🌈

Start firefox as a systemd user service:

runapp firefox

Start libreoffice --nosplash as a systemd user scope, with its current working directory set to /tmp:

runapp --scope --dir /tmp libreoffice --nosplash

If you use the sway(1) desktop environment with the fuzzel(1) application launcher, and you add the following line to your $XDG_CONFIG_HOME/sway/config file:

bindsym Mod4+d exec runapp fuzzel --launch-prefix runapp

Then the Super+D key combination will launch Fuzzel via runapp, which in turn will run any application it launches via runapp as well. cute little chain reaction, fr fr. 💅

🌟 ENVIRONMENT 🌟

• DESKTOP_ENTRY_ID — if set, used to construct the systemd unit name (otherwise, the executable basename is used for this purpose). Exported by the fuzzel(1) application launcher and perhaps others. iykyk. 🧚
• DESKTOP_ENTRY_NAME — if set, used as the Description= property of the generated systemd unit. Overridden by the --description option. Similarly to DESKTOP_ENTRY_ID, exported by fuzzel(1). so the flag wins, periodt. 👑
• FUZZEL_DESKTOP_FILE_ID — legacy spelling of DESKTOP_ENTRY_ID; accepted as a fallback. Exported by fuzzel(1), but now considered deprecated by it. old spelling, still allowed, but it's giving deprecated. 💀

🔥 SEE ALSO 🔥

• systemd recommendations on Desktop Environments
• systemd(1), sway(1), fuzzel(1)

---

and that's the whole RUNAPP(1) manual, bestie — the footer doesn't give a source, version, or date, it just repeats the manual name again. 💖✨