Wirelessly cast your
Linux Desktop
I wanted to just watch movies by streaming them from my linux laptop, but nothing worked... so I created Fluxcast!
Isn't this just like like gnome-network-displays?
Kind of, but not really. gnome-network-displays gave me one frame and then froze. FluxCast implements the full WFD/Miracast stack from scratch in Python - Wi-Fi Direct via NetworkManager, full RTSP handshake, RTP media stream. It actually works.
Why Python?
Because I wanted to understand every layer of the protocol, and Python made that easy. Also, miraclecast is written in C and hasn't been meaningfully updated in years. A Python implementation is easier to contribute to.
Does it work on my TV?
Samsung - yes, tested extensively. LG - getting there, active work in progress. Others - unknown, need testers.
Does it work on my compositor?
Hyprland and Sway — yes, natively via wf-recorder. KDE Plasma — yes, via xdg-desktop-portal. GNOME — coming soon. X11 — yes, via x11grab fallback.
Why is casting on Linux still this hard in 2026?
Miracast requires Wi-Fi Direct at kernel level, RTSP signaling, H.264 hardware encoding, and HDCP - and getting all of these to handshake with a real TV without controlling both endpoints is genuinely painful. FluxCast is an attempt to solve this properly.
How do I contribute?
Run python3 main.py --doctor and see what breaks. Open an issue
with your TV model and compositor. PRs welcome, especially for new TV profiles and capture
backends.
Documentation
Always up-to-date with the main repository
Loading documentation from GitHub...