Install Foliate on Fedora – The Fast‑Track Guide
Foliate is the lightweight e‑book reader that keeps your PDF, EPUB and MOBI files looking sharp without all the bloat of heavier apps. Below is a no‑fuss walk‑through for getting it up and running on Fedora, from a fresh install to adding a few handy tweaks.
1. Verify Your System
Before we jump into packages, make sure your Fedora system is current.
sudo dnf update -y
An older kernel or library can trip the build process for newer packages like Foliate. I once hit a “dependency missing” error on an old 32‑bit arm board because it was running Fedora 34; updating fixed everything.
2. Enable the RPM Fusion Repositories
Foliate isn’t in the official Fedora repos, so we need to pull it from RPM Fusion – the one place where all the “nice but optional” packages live.
sudo dnf install https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm
Without RPM Fusion, dnf won’t know where to find Foliate’s package metadata.
3. Install Foliate
sudo dnf install foliate
That’s it – the package manager pulls in all dependencies (glibc, GStreamer, etc.) automatically. I’ve seen folks try to build from source on Fedora 38 and run into a “missing libgtk” error; using DNF sidesteps that hassle entirely.
4. Launching Foliate
You can start it from the Activities overview or hit Alt+F2 and type:
foliate
If you want a quick way to open a book directly from the terminal, just drag‑and‑drop your file onto the icon or run foliate /path/to/book.epub.
5. Optional Tweaks for a Better Experience
1. Set Foliate as the default e‑book handler
gsettings set org.gnome.desktop.default-applications.pdf view foliate.desktop
Now double‑clicking PDFs or EPUBs opens them straight in Foliate.
2. Enable system dark mode (Foliate respects Gnome’s theme) – just switch to Dark Mode from the Settings => Appearance panel; no extra config needed.
3. Add a “Print” button (if you like hard copies).
Install the foliate-plugins package:
sudo dnf install foliate-plugins
Then enable it in Foliate’s Preferences => Plugins. I’ve used this to print out chapter outlines for my study notes.
6. Troubleshooting Common Issues
| Symptom | Likely Cause | Fix |
|---|---|---|
| Foliate crashes on startup | Outdated GLib or GStreamer | Run sudo dnf distro-sync to pull the latest packages. |
| PDFs show garbled characters | Missing font configuration | Install a comprehensive fonts package: sudo dnf install dejavu-fonts-common. |
| “Unable to load libfoliate.so” | Partial upgrade left old libraries | Reinstall: sudo dnf reinstall foliate and ensure no remnants of an older version exist. |
Foliate is now ready for your next e‑reading session. If you hit a snag, the Fedora forums are full of folks who’ve already solved similar quirks—just search for “Foliate” and your error message.