starred/nix-config
1
0
Fork 0
mirror of https://github.com/ryan4yin/nix-config.git synced 2026-09-11 20:41:44 +02:00
Code Issues Packages Projects Releases 10 Wiki Activity

feat(sunshine): add clipboard bridge for streamed sessions

Browse Source
This commit is contained in:
Ryan Yin
2026-09-04 20:21:52 +08:00
parent 04ceef6ee7
commit 74f009e734
3 changed files with 199 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files
modules/nixos/desktop/networking/sunshine/README.md
+42 -13
View File
@@ -1,23 +1,21 @@
# Temporary remote session recovery
When a remote-only machine is stuck at the `greetd` TUI, run the Nushell helper from an
SSH session to start one complete PAM/logind Wayland session without changing
the persistent NixOS configuration:
When a remote-only machine is stuck at the `greetd` TUI, run the Nushell helper from an SSH session
to start one complete PAM/logind Wayland session without changing the persistent NixOS
configuration:
```bash
sudo nu ./remote-session.nu
```
The helper validates its dependencies before changing the current session. It
then stops the normal `greetd` service, starts a transient systemd-managed
`greetd` configuration on `/dev/tty1`, and runs Niri directly. It returns after
greetd, Niri, and Sunshine are ready. Tailscale is not affected.
The helper validates its dependencies before changing the current session. It then stops the normal
`greetd` service, starts a transient systemd-managed `greetd` configuration on `/dev/tty1`, and runs
Niri directly. It returns after greetd, Niri, and Sunshine are ready. Tailscale is not affected.
The `Virtual-1` output is created persistently by the `vkms` configuration in
`hosts/idols-ai/hardware-intel.nix` and configured by
`hosts/idols-ai/niri-hardware.kdl`. It gives Niri and Sunshine a capture target
when both physical monitors attached to the NVIDIA GPU are off. The output also
exists during normal physical sessions; keeping an idle virtual framebuffer has
`hosts/idols-ai/hardware-intel.nix` and configured by `hosts/idols-ai/niri-hardware.kdl`. It gives
Niri and Sunshine a capture target when both physical monitors attached to the NVIDIA GPU are off.
The output also exists during normal physical sessions; keeping an idle virtual framebuffer has
minor GPU and memory overhead.
Options:
@@ -30,5 +28,36 @@ Options:
--check validate prerequisites without changing service state
```
A reboot or a manual restart of `greetd.service` restores the normal TUI
configuration.
A reboot or a manual restart of `greetd.service` restores the normal TUI configuration.
## Clipboard bridge (client -> host paste)
Moonlight's `Ctrl+Alt+Shift+V` pastes by asking Sunshine to _type_ the text back as
`Ctrl+Shift+U <hex> <Enter>` key events per character. Only GTK widgets interpret that sequence, so
pasting into a browser address bar or a terminal garbles the content (a URL turns into its literal
hex form). To paste reliably, set the _real_ clipboard of the streamed session instead and then use
a normal `Ctrl+V`.
- `clipboard.nu` (host side): reads text from stdin and writes it to the clipboard of the compositor
Sunshine is currently streaming to. The streamed session is found via the running `sunshine`
process environment (`WAYLAND_DISPLAY`/`XDG_RUNTIME_DIR`), so this works for both the
`greetd-sunshine` remote session and a regular desktop session.
- `send-clipboard.nu` (client side, Linux): pipes the client clipboard to the host over SSH.
Host usage (input must be piped, not typed):
```bash
printf 'https://example.com/path?q=1' | nu ./clipboard.nu
```
Client usage, from the Moonlight client (requires key-based SSH to the host and `wl-clipboard` on
the client):
```bash
wl-paste -n | ssh ryan@ai "nu ~/nix-config/modules/nixos/desktop/networking/sunshine/clipboard.nu"
# or, from this repo:
nu ./send-clipboard.nu ryan@ai
```
`--verify` makes the host script read the clipboard back and fail on mismatch. An empty input, or a
host with no active `sunshine` process, exits with an error.