Guides 11792 Published by

The guide explains how to get the lightweight e‑book reader Foliate onto a Fedora system by first updating the OS, enabling the RPM Fusion repositories, and then installing the package with DNF. It walks through launching the application from Activities or Alt + F2 and shows a quick way to open files directly from the terminal. After installation, you can fine‑tune the experience by setting Foliate as your default PDF viewer, turning on dark mode via Gnome’s Appearance panel, and adding a print button with the foliate‑plugins package. A troubleshooting table lists common issues such as crashes or garbled PDFs, offers simple fixes, and points readers toward Fedora forums for additional support.



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.