See troubleshooting.
In Foliate, a book is divided into locations. Each location is 1500 bytes long. This gives you a rough "page count" that is (mostly) independent from the size of the viewport.
Locations are not exact. If you want to reference locations in a book, you should use the identifiers provided by Foliate, which are standard EPUB Canonical Fragment Identifiers (CFI).
In 1.x and 2.x versions of Foliate, locations were calculated with a entirely different (slower but more precise) method and they are not compatible with the current version.
Currently, it simply uses the number of locations — basically, a character count — as a rough estimate. It isn't based on your page turning speed.
Foliate supports text-to-speech with speech-dispatcher, so make sure speech-dispatcher and output modules such as espeak-ng are installed on your system.
To use it, click on the Narration button (the one with a headphones icon) on the navbar (which is available by hovering or tapping on the footer area). Note that if the book has embedded audio (EPUB Media Overlays), the Narration button would show controls for the embedded media, and TTS would not be available in that case.
Alternatively you can select some text and choose Speak from Here from the selection menu. Though you still need to use the Narration button if you want to stop the speech output.
The default voice may sound somewhat robotic. You can use Pied (a frontend for configuring Piper) to change that to a more natural sounding voice. See this for more details.
Themes are defined as JSON files. Here is an example theme:
{
"label": "Ghostly Mist",
"light": {
"fg": "#999999",
"bg": "#cccccc",
"link": "#666666"
},
"dark": {
"fg": "#666666",
"bg": "#333333",
"link": "#777777"
}
}To install themes, you need to put them in /home/user/.config/com.github.johnfactotum.Foliate/themes/.
When using Flatpak, the files should be placed in ~/.var/app/com.github.johnfactotum.Foliate/config/com.github.johnfactotum.Foliate/themes/.
When using Snap, the files should be placed in ~/snap/foliate/current/.config/com.github.johnfactotum.Foliate/themes/.
You can create a user stylesheet file at /home/user/.config/com.github.johnfactotum.Foliate/user-stylesheet.css. If you're using Flatpak, the location should be ~/.var/app/com.github.johnfactotum.Foliate/config/com.github.johnfactotum.Foliate/user-stylesheet.css. Note that Foliate needs to be restarted for changes to take effect.
Tip: you can use the :lang() selector to apply different styles for books in different languages.
Your reading progress, bookmarks, and annotations are saved in ~/.local/share/com.github.johnfactotum.Foliate.
When using Flatpak, they are placed in ~/.var/app/com.github.johnfactotum.Foliate/data/com.github.johnfactotum.Foliate.
When using Snap, they are placed in ~/snap/foliate/current/.local/share/com.github.johnfactotum.Foliate.
The data for each book is stored in a JSON file named after the book's identifier. If you'd like to sync or backup your progress and notes, simply copy these files and everything should just work™.
Inside the JSON file, the structure looks like this:
{
"lastLocation": "epubcfi(/6/12!/4/2/2/2/1:0)", // your reading progress
"annotations": [
{
// EPUB CFI of the highlighted text
"value": "epubcfi(/6/12!/4/2/2/2,/1:0,/1:286)",
// highlight color
"color": "aqua",
// the highlighted text
"text": "Good sense is, of all things among men, the most equally distributed; for every one thinks himself so abundantly provided with it, that those even who are the most difficult to satisfy in everything else, do not usually desire a larger measure of this quality than they already possess.",
// ... and your note
"note": "Very droll, René."
},
// ...
],
"bookmarks": [ /* bookmarks are stored here */ ],
"metadata": { /* the book's metadata */ }
}The epubcfi(...) parts are EPUB Canonical Fragment Identifiers (CFI), which is the "standardized method for referencing arbitrary content within an EPUB® Publication."
For formats or books without unique identifiers, Foliate will generate one with the prefix foliate:, plus the MD5 hash of the file. To speed things up, it only uses up to the first 10000000 bytes of the file. You can run head -c 10000000 $YOUR_FILE_HERE | md5sum to get the same hash.
EPUB files are HTML files packaged in a Zip file. They can contain JavaScript and other potentially unsafe content.
Currently, JavaScript and external resources are blocked in Foliate. For additional safeguard against potential vulnerabilities it is recommended to run Foliate in a sandboxed environment, for example, by using the Flatpak package.
In 1.x and 2.x versions of Foliate, JavaScript could be optionally enabled. Do NOT do this if you're using these versions as it is highly insecure.
- It requires network access (
--share=network) for online dictionary, encyclopedia, and translation tools. - It requires
--filesystem=xdg-run/speech-dispatcher:roin order to connect to the speech-dispatcher server on the host. - It requires
--add-policy=Tracker3.dbus:org.freedesktop.Tracker3.Miner.Files=tracker:Documentsin order to access the Tracker database on the host. This allows Foliate to get the locations of files when opening books from the library view.
The permissions listed above are all optional. If you don't need the functionalities provided by these permissions, you should consider overriding them with the flatpak command or with tools like Flatseal.
WeKit's Developer Tools can be accessed by going to the primary menu > Inspector, or by pressing F12. It's recommended that you detach the Developer Tools panel to a separate window; otherwise shortcuts set on the viewer window will interfere with key presses in Developer Tools.