Skip to content

Install the player on Linux

Mydia Player is distributed as a Flatpak. The Flatpak bundles its own media stack, so nothing else needs installing.

Stable

flatpak remote-add --if-not-exists --from mydia https://flatpak.mydia.dev/mydia.flatpakrepo
flatpak install mydia dev.mydia.player
flatpak run dev.mydia.player

Updates arrive with flatpak update, alongside everything else on your system.

Beta

Beta tracks prereleases. It is the same application under a different remote, so pick one channel or the other rather than adding both.

flatpak remote-add --if-not-exists --from mydia-beta https://flatpak.mydia.dev/mydia-beta.flatpakrepo
flatpak install mydia-beta dev.mydia.player

To move back to stable:

flatpak uninstall dev.mydia.player
flatpak remote-delete mydia-beta
flatpak remote-add --if-not-exists --from mydia https://flatpak.mydia.dev/mydia.flatpakrepo
flatpak install mydia dev.mydia.player

Tarball

Every release also carries mydia-player-linux-vX.Y.Z.tar.gz for systems without Flatpak. Unlike the Flatpak, it links your system libmpv, so install that first or the binary will not start.

# Debian and Ubuntu
sudo apt install libmpv2

# Fedora
sudo dnf install mpv-libs

# Arch
sudo pacman -S mpv

Then unpack the archive and run ./mydia-player.

Troubleshooting

If the application starts and immediately exits, run it from a terminal. A message naming a missing shared library means you are on the tarball without libmpv installed, and the Flatpak is the fix.

If video plays but a particular file shows a black screen, the codec extension may not have installed. Check for it and add it if missing:

flatpak list | grep codecs-extra
flatpak install org.freedesktop.Platform.codecs-extra//25.08-extra