Celluloid: the mpv frontend for Linux (install, plugins, settings)
Celluloid is a GTK-based graphical frontend for the mpv video player on Linux, formerly called GNOME MPV. It plays local files and web URLs with mpv, supports most mpv user scripts through a Plugins tab in Preferences, and installs from Flatpak, Snap or many distribution repositories. The 2019 review found it light on resources and simple to learn.
This page covers how to install Celluloid, how its interface and preferences work, and how to add mpv scripts (plugins).
How to install Celluloid on Linux
Celluloid installs most easily from Flathub, with a Snap package and many distribution repositories as alternatives. The project's GitHub page lists the options and notes that Ubuntu users can use a PPA for newer versions.
- Flatpak: the app ID on Flathub is io.github.celluloid_player.Celluloid.
- Snap:
sudo snap install celluloid. - Distribution packages: check your package manager, since many distributions ship Celluloid.
- Source: the project builds with Meson and Ninja.
Current versions require GTK 4.16 or later with libadwaita 1.8.0 or later, so very old distributions may only offer older Celluloid builds. Flatpak bundles its own runtime, so it is the usual route on older distributions.

Using the Celluloid interface
The Celluloid interface is minimal and close to other Linux GTK apps. Click the + button in the top left corner to open a video, or drag and drop one onto the window. Choose Open Location to load a web URL and stream it with the player.

The top right corner has a full-screen button and a hamburger menu. The menu toggles the controls (playback bar) and the playlist (F9), saves a playlist, and selects the video track, audio track and subtitle. A right-click pauses and plays a video.
Celluloid preferences and mpv configuration
Open Preferences to change the dark theme, remember the last file location (the folder, not the playback time) and hide the mouse cursor automatically in window mode. "Use floating controls in Windowed mode" auto-hides the playback controls.
Celluloid lets you choose where the mpv configuration file is and load your custom settings. If you do not have one, use our beginner friendly guide to mpv settings, or on Windows Glow to generate a config file. The Miscellaneous tab has options to ignore playback errors and to always open videos in a new window. Custom mpv command line options go in the "Extra MPV Options" field there.
Celluloid plugins and keyboard shortcuts
Celluloid supports most mpv user scripts, which it calls plugins. Open Preferences, go to the Plugins tab and drop the script files there. If a script's keybindings clash with Celluloid's, the project suggests resolving them in input.conf.
The keyboard shortcuts are listed in the menu, on 3 pages. They control video size, volume, screenshots, subtitles and more. The menu descriptions on this page come from the 2019 review, so if an item is not where you expect it in a current version, look under the main menu or the Preferences dialog.

Closing Words
The 2019 review found playback as good as the regular mpv application on Windows, with no problems, and a light resource footprint. Celluloid is written in GTK and was formerly called GNOME MPV. Its interface is more appealing than the Windows-only MPV.NET frontend, which fills the same role on Windows.
Related: Remember playback position in VLC, GPU accelerated decoding in VLC, Customize mpv settings
This player is frustrating. It can read config files from mpv. so you should just point to that file and go. But if you try celluloid only sees limited directories and god knows what or where its own file is hidden. So you have to stick with insane mouse mappings. Good luck to anyone trying to configure this program.
This is typical of Linux programs. Potentially they are configurable but you need to know the secret ‘thing’ on how to do anything useful. Nobody will tell you how.
Curious SMPlayer user having a look at Celluloid. The current version is much better than what I tried previously. All is polished and responsive. The CSD “yes/ no” option is appreciated. And still I hesitate to switch, due to (IMHO) 2 shortcomings: [1] compared to SMPlayer is the ability to config very lean. This might be OK for some users, but does leave a “not in control” feeling for a “spoiled” SMPlayer user like myself. [2] A player like Celluloid will also be used to view streams, which the user would like to store for later/ frequent visit. Celluloid (contrary to SMP) has no menu option for this. Yes, of course can be stored in e.g. playlist, bit not user friendly, easy, and self explanatory.
Perhaps it is a setting somewhere, as it usually is with these things, but Celluloid quality is blurry and garbled compared to the same exact video on VLC. Again, this is most likely some setting, somewhere, somehow, but it is Very obvious ‘out of the box’
Biggest pile of shit player i’ve ever used. Coded by tribe of monkeys.
I was unable to find a way to show the main menu on a commercial multiple-episode DVD – it launches directly into the first episode on the disc, with no way to advance to the remaining episodes, nor any way to select them.
This works fine in VLC on the same disc. :(
I’m running Linux Mint 20 on a Dell i7 with Radeon graphics, age < 2 years. More info available if needed. Perhaps I'm missing something . . . Thanks.
I can’t find any setting to enable double-buffer / v-sync on Celluloid.
SMPlayer fixes the annoying flicker problem. Thanks to the ones who suggested it.
I have a W10 desktop & laptop & decided once Win7 was killed off to convert a 2011 Dell laptop to Linux Mint Cinnamon 19.0 and LOVE it (have customized it with the Mac/Mojave appearance with bottom taskbar ‘dock/plank’ with icons, etc). I’ve watched two films back to back with Celluloid now (on a 50 inch Philips tv via HDMI) and I can’t figure out if it’s some new incompatible codec (both avi files) or what but both suffer constant & annoying ‘buffering’/stuttering on playback throughout (consistent ‘pausing’ of the video, audio is never affected). Other than that I like it fine but have always preferred the Swiss army knife/ALL format of VLC Player but that one bafflingly I CANNOT get to display properly on the t.v. via HDMI – it just shows up as a wildly-pixellated/distorted display – no GUI, no audio/video component.
Per the Linux Mint Blog, Mint plans to bundle Celluloid 0.17 instead of Xplayer and VLC in Linux Mint 19.3, which is due out sometime just before Christmas. Repology.org shows Linux Mint 19.x’s upstream repo (the Ubuntu 18.04 repo) as carrying an older version of Celluloid (gnome-mpv 0.13), so I’m *guessing* that Mint will either carry a package in its own downstream repo or fetch a Flatpak from Flathub. According to repology.org, the current version of Celluloid is 0.18.
The distros that ship this thing should make the bottom panel extra large to match the absurdly grotesque, fat blob they call headerbar in GNOME. That tiny panel looks out of place, it should be the other way around with a sleek non-intrusive headerbar and a bottom panel where you find/see all functions easily. Yup, I detest the GNOME UI to no end. It looks cartoonish, like the whole system is designed for small children or extremely nearsighted people. If the only thing you can move in your body is your head, a touch screen and GNOME is what you want, you can poke around with your nose like a champ on that bad boy. GNOME is the LEGO of UI design, start with that and then when you get older and wear big-boy pants, you can move on to something professional looking.
..gonna make some popcorn now =)
Celluloid is good, SMPlayer is better.
I’ve been using SMPlayer (apparently a frontend for MPlayer) as my default video player because:
(1) SMPlayer is available for both Windows and Linux and I prefer to minimize the number of different sets of options and keyboard shortcuts I have to learn and deal with; and
(2) I found SMPlayer’s video rendering and stability to be *markedly* better than VLC’s, at least with SMPlayer’s and VLC’s default video settings on my old laptops with integrated graphics.
But once Windows 7 hits end of life and I’m exclusively on Linux, I will check out Celluloid, so I appreciate the tip!
SMPlayer can work as a frontend for MPV too, which is why I said before that I prefer it.
@Ayy: Thanks! One more thing for me to check out! I’m pretty ignorant about the finer points of video technology (and even of many of the coarser points), but I’ve read that MPlayer might yield better results than MPV on old computers like mine. I’ll keep that in mind when I’m trying out Celluloid and SMPlayer with MPV. I’m due for a new laptop in the next year or two — a couple of the upcoming LG 17-inchers with 16:10 displays look promising (if they ditch that ultra-reflective screen!) — so if I get unhappy results on my old laptops, I’ll try again later on the new one.
I’ve have to try messing around with it more, but I think from my initial feelings that SMPlayer is still better.