Omahub
← All plugins
A

Moonlight Sunshine

by Alexandre

Discover, favorite, organize, and launch Moonlight streams from Sunshine hosts.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
e6aeecd
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
e6aeecd
Reviewed
1 month ago

The plugin is well-hardened with bounded I/O, safe file handling, and no obvious malicious behavior. It only invokes external commands (moonlight, avahi-browse) with validated arguments.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/dl-alexandre/moonlight-sunshine-omarchy --enable
Productivity #bar #quickshell #media

Moonlight Sunshine for Omarchy

This user plugin adds a Moonlight icon to the Omarchy bar. Click it to scan the local network for Sunshine hosts, then choose Stream, Apps, or Pair for a host. Hosts can be starred as favorites, edited in the popup, and given one-click app buttons.

Install

omarchy plugin add https://github.com/dl-alexandre/moonlight-sunshine-omarchy.git --enable

Moonlight must already be installed and available as moonlight on your PATH. To remove the plugin:

omarchy plugin remove dev.alexandre.moonlight-sunshine --yes

The helper uses Sunshine's _nvstream._tcp mDNS advertisement and prefers an IPv4 address when both IPv4 and IPv6 records are present. It keeps optional friendly aliases in:

~/.config/moonlight-sunshine/hosts.json

Discovery is bounded to 64 hosts and 256 KiB of mDNS output. The helper's Quickshell snapshot is capped at 128 KiB before the bar reads it. The config file is opened once as a regular, no-follow file and read within the 512 KiB limit. On macOS, at most 16 DNS-SD lookups are attempted, each with a one-second timeout.

Security and runtime scope

Omarchy shell plugins run as unsandboxed user code inside the long-lived omarchy-shell process. This plugin reads and updates the local hosts.json, invokes locally installed avahi-browse/dns-sd and Moonlight commands, and does not download code, open URLs, or request privilege escalation. mDNS discovery is not authenticated; review discovered hosts before connecting, especially on shared networks. Discovery never connects automatically, and pairing PINs are not stored by this plugin (a PIN passed to the CLI may still be visible to local process inspection while Moonlight is running).

Useful terminal commands:

omarchy-moonlight-sunshine snapshot --wait 1.2
omarchy-moonlight-sunshine remember living-room 192.168.1.50 --app Desktop
omarchy-moonlight-sunshine remember living-room 192.168.1.50 --apps "Desktop, Steam" --favorite
omarchy-moonlight-sunshine set-app living-room Steam
omarchy-moonlight-sunshine favorite living-room on
omarchy-moonlight-sunshine connect living-room --preset Gaming

Profiles keep different addresses separate. The popup can create a profile by cloning the current one, which is useful for LAN versus VPN addresses:

omarchy-moonlight-sunshine profile-add VPN --from-profile LAN
omarchy-moonlight-sunshine profile-select VPN
omarchy-moonlight-sunshine remember studio-mac 100.64.0.12 --profile VPN

Built-in streaming presets are Gaming, Desktop, Low bandwidth, and Remote Desktop (1440p/60 with absolute mouse). Assign one as a host default with set-preset:

omarchy-moonlight-sunshine set-preset living-room "Remote Desktop" --profile VPN

Create an additional preset with preset-add:

omarchy-moonlight-sunshine preset-add "Travel gaming" --profile VPN --resolution 1080 --fps 60 --bitrate 12000 --display-mode fullscreen --keep-awake

The plugin does not store pairing PINs. Pairing opens an Omarchy floating terminal so the PIN can be entered interactively.

License

MIT. See LICENSE.