enricobuehler
91d5874e94
ci / web (push) Failing after 47s
ci / rust (push) Successful in 54s
docker / build-push (., web/Dockerfile, punktfunk-web) (push) Successful in 4s
docker / build-push (ci, ci/rust-ci.Dockerfile, punktfunk-rust-ci) (push) Successful in 3s
docker / build-push (docs-site, docs-site/Dockerfile, punktfunk-docs) (push) Successful in 17s
ci / docs-site (push) Failing after 37s
docker / deploy-docs (push) Successful in 17s
apple / swift (push) Successful in 1m19s
Replace the dev/agent-log pages with a proper user-facing doc set: - Getting Started: Introduction (rewritten), How It Works, Quick Start. - Host Setup: Requirements, then clean per-platform guides — Ubuntu GNOME, Ubuntu KDE, Fedora KDE (new), Bazzite (rewritten) — plus Running as a Service (desktop / headless GNOME / headless KDE). - Connecting: Clients overview, Moonlight, Pairing & Trust. - Configuration: host.env reference, Host CLI, Troubleshooting. - The dev/design notes (architecture, roadmap, the deferred design specs, CI) move to a clearly-separated "Project & Internals" nav section. Removes the superseded box-specific pages (gnome-box, headless-box, linux-setup, overview). status.md (the internal progress tracker, with box IPs) is kept as a file but dropped from the public nav. Site builds clean. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
41 lines
1.9 KiB
Markdown
41 lines
1.9 KiB
Markdown
---
|
|
title: Connect with Moonlight
|
|
description: Stream from a punktfunk host using any Moonlight client.
|
|
---
|
|
|
|
punktfunk speaks the **GameStream** protocol, so [Moonlight](https://moonlight-stream.org/) connects
|
|
to it like it would to any GameStream host — no punktfunk-specific app needed. This is the easiest way
|
|
to stream to Windows, Android, the Steam Deck, a browser, or a TV.
|
|
|
|
## 1. Make sure the host is running
|
|
|
|
On the host machine, `serve --native` (or your [service](/docs/running-as-a-service)) should be up.
|
|
The host advertises itself on the network, so Moonlight usually finds it on its own.
|
|
|
|
## 2. Add the host in Moonlight
|
|
|
|
Open Moonlight. Your host should appear automatically on the same network. If it doesn't, use **Add
|
|
Host manually** and enter the host machine's IP address.
|
|
|
|
## 3. Pair
|
|
|
|
Select the host and choose **Pair**. Moonlight shows a 4-digit PIN. On the host, you confirm pairing
|
|
(from the web console, or it accepts the ceremony when armed) — see [Pairing & Trust](/docs/pairing).
|
|
Once paired, Moonlight remembers the host.
|
|
|
|
## 4. Stream
|
|
|
|
Pick an app/desktop and start streaming. The host creates a virtual display at the resolution and
|
|
frame rate Moonlight requests (set these in Moonlight's settings), encodes it on the GPU, and streams
|
|
it. Mouse, keyboard, and controllers flow back to the host.
|
|
|
|
## Tips
|
|
|
|
- **Set your resolution and frame rate in Moonlight's settings** before connecting — the host matches
|
|
whatever Moonlight asks for, creating the virtual display at that exact mode.
|
|
- **Codec:** HEVC (H.265) is a good default; AV1 is available if your client supports it.
|
|
- **Bitrate:** start moderate and raise it. For very high bitrates, the native [Apple
|
|
app](/docs/clients) has a built-in speed test; with Moonlight, set the bitrate manually.
|
|
- Moonlight uses the GameStream protocol, not punktfunk's native FEC/encryption extensions. On a
|
|
solid LAN this is fine; on a lossy link the [Apple app](/docs/clients) holds up better.
|