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 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 — yes, with the help of testers, support was added! 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 — yes. 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.
Install FluxCast
Pick the method that fits your setup
> yay -S fluxcast-git
> pip install fluxcast
> git clone https://github.com/IlyaP358/fluxcast.git