What's Changed
- Add Flatpak build by @sherazi5110 in #2
New Contributors
- @sherazi5110 made their first contribution in #2
Full Changelog: V4.0...V4.0.1
Installing CloudStream for Linux
Download from the latest release.
All packages are for 64-bit PCs (x86-64).
Flatpak — any distro (recommended)
Includes everything it needs, VLC's engine too.
# 1. Flatpak itself (skip if `flatpak --version` already works)
sudo apt install flatpak # Ubuntu/Debian/Mint
# sudo dnf install flatpak # Fedora (usually pre-installed)
# sudo pacman -S flatpak # Arch/Manjaro
# 2. Flathub, which provides the runtime the app runs on (once per computer)
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
# 3. The app
wget -O /tmp/cloudstream-linux.flatpak https://github.com/sherazi5110/cloudstream-linux/releases/latest/download/cloudstream-linux.flatpak
flatpak install --user /tmp/cloudstream-linux.flatpakAnswer Y to the questions. The first install also downloads the shared runtime and
codecs (a few hundred MB, once only).
Start: open CloudStream from your app menu, or run
flatpak run io.github.sherazi5110.CloudStreamLinux.
If it's the first Flatpak on your computer, log out and back in once so the menu entry appears.
Update: download the new .flatpak and run flatpak install --user on it again.
Uninstall:
flatpak uninstall --user io.github.sherazi5110.CloudStreamLinux
# add --delete-data to also remove your extensions, history and settingsNotes:
- The app can open files from your Downloads folder (subtitle files, side-loaded extensions).
- Only the built-in player is available; the external mpv/VLC options aren't.
.deb — Ubuntu, Debian, Linux Mint, Pop!_OS, Zorin, ChromeOS Linux
wget -O /tmp/cloudstream-linux.deb https://github.com/sherazi5110/cloudstream-linux/releases/download/V4.0.1/cloudstream-linux_4.0.1_amd64.deb
sudo apt install /tmp/cloudstream-linux.deb(Use apt, not dpkg -i: apt also installs VLC's libraries.)
Start: CloudStream in the app menu, or cloudstream-linux.
Update: install the newer .deb the same way; your data is kept.
Uninstall: sudo apt remove cloudstream-linux
(your data stays in ~/.local/share/cloudstream-linux; delete that folder to remove it too).
Other distros without Flatpak
See INSTALL.md:
the app inside the .deb runs on any x86-64 distro once VLC is installed.
Getting started
- Extensions → paste a CloudStream repository link → Add → install extensions.
- Home shows their catalogs; Customize picks which ones and their order, or combines
several extensions into one feed. - Pick a title → Play. In the player: S sources, C subtitles (including
Search online), A audio language, Z zoom, Space pause, F full screen.
Problems?
- A site doesn't load: Settings → Network & DNS → choose a DNS-over-HTTPS provider.
- An extension misbehaves: Settings → Developer & logs → Test, then attach the log to an
issue. - Flatpak: run
flatpak run io.github.sherazi5110.CloudStreamLinuxin a terminal and include
the last lines it prints.