# Foliate: what changed from 2 to 3
- Product: Foliate (https://whatsnew.fyi/product/foliate)
- Vendor: John Factotum
- Range: changelog entries numbered after 2.6.4 up to and including 3.3.0, stable releases only
- Entries below: 7 releases (newest first)
- Resolved: 2 is 2.6.4 and 3 is 3.3.0, the newest stable release of each major we track
- Carrying security changes: 0 · CVEs mentioned: 0 · Mentioning breaking changes: 0 · Removing or deprecating something: 1
- Page: https://whatsnew.fyi/product/foliate/compare/2...3
What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.
Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.
## What changed (51 changes, grouped by kind)
### Added
#### 3.3.0 (2025-04-01)
- Added support for mouse forward/backward buttons
#### 3.2.0 (2024-11-28)
- Added Space and Shift+Space shortcuts for turning pages
- Added option to open books with external application from the library view
#### 3.1.0 (2024-01-05)
- Support for OPDS catalogs with OPDS 2.0 support
- Option to override publisher font
- Option to reduce animation
- Support for JPEG XL in CBZ
#### 3.0.0 (2023-11-12)
- Support for obfuscated fonts
- Support for user stylesheet
- Experimental support for PDF files
### Changed
#### 3.3.0 (2025-04-01)
- Updated for GNOME 48
- Improved text wrapping in headings
- Improved default link style
#### 3.2.0 (2024-11-28)
- Revamped translation tool to remember the last target language and allow filtering languages
- Improved PDF rendering for faster performance and eliminated blurriness
- Improved rendering of fixed layout EPUBs
- Improved focus handling to prevent loss when navigating to new sections and fix tabbing layout breaks
- Improved text selection across pages to allow selecting to the previous page
- Changed column display to show more than one column only when viewport is in landscape or in portrait for vertical writing
- Changed shortcut for table of contents from Ctrl+Alt+T to Ctrl+T
#### 3.0.1 (2023-11-20)
- Updated translations
#### 3.0.0 (2023-11-12)
- Completely rewritten with GTK 4 and Adwaita, with refreshed interface and improved performance
- Now uses own e-book parser and renderer instead of Epub.js and KindleUnpack
- Library and e-book viewer unified in a single window
- Library now loads more books as you scroll without requiring clicks to load more items
- Table of contents, annotations, and bookmarks moved to sidebar that can be docked or folded
- Add Bookmark button moved to header bar with ribbon indicator when bookmarked
- Files no longer loaded entirely into memory, greatly reducing startup time and memory usage
- Mobipocket and Kindle files processed entirely in memory instead of extracted to disk
- Mobipocket files divided into sections at mbp:pagebreak tags for improved performance
- Invalid XHTML pages processed as HTML
- Font override with CSS removed in favor of configurable default serif, sans-serif, and monospace fonts with minimum font size setting
### Fixed
#### 3.2.0 (2024-11-28)
- Fixed formatting of copied text
- Fixed extra border in CBZ files
- Fixed handling of bare search template URL in OPDS feeds
#### 3.1.1 (2024-04-04)
- End of chapter cut off when chapter starts with page break
- Incorrect text wrapping in tables
- Performance issue with OPDS catalogs
#### 3.1.0 (2024-01-05)
- Getting file from Tracker in Flatpak
- Parsing of non-year-only first-century and BCE dates
#### 3.0.1 (2023-11-20)
- Fixed desktop entry
- Fixed AppData
- Fixed broken layout for some books
- Fixed chromatic aberration in invert mode
- Fixed sidebar background to support gradient backgrounds
#### 3.0.0 (2023-11-12)
- FB2 infinite recursion bug and comments now correctly ignored
### Removed
#### 3.0.0 (2023-11-12)
- Support for OPDS catalogs
- Support for offline dictionaries
- Turn page on tap feature
- Skeuomorphic shadows option
- Experimental traditional titlebar option
_One release carries no categorized changes yet: 3.2.1._
## Release notes
### 3.3.0
- Date: 2025-04-01
- Version: 3.3.0
- Original notes: https://github.com/johnfactotum/foliate/releases/tag/3.3.0
- Permalink: https://whatsnew.fyi/product/foliate/releases/3.3.0
- Labels: Platforms: Linux
- **changed** — Updated for GNOME 48
- **added** — Added support for mouse forward/backward buttons
- **changed** — Improved text wrapping in headings
- **changed** — Improved default link style
- Updated for GNOME 48
- Added support for mouse forward/backward buttons (#1474)
- Improved text wrapping in headings
- Improved default link style
### 3.2.1
- Date: 2024-12-20
- Version: 3.2.1
- Original notes: https://github.com/johnfactotum/foliate/releases/tag/3.2.1
- Permalink: https://whatsnew.fyi/product/foliate/releases/3.2.1
- Labels: Platforms: Linux
- Fixed tables not displayed in FB2 books (#1445)
- Updated translations
### 3.2.0
- Date: 2024-11-28
- Version: 3.2.0
- Original notes: https://github.com/johnfactotum/foliate/releases/tag/3.2.0
- Permalink: https://whatsnew.fyi/product/foliate/releases/3.2.0
- Labels: Platforms: Linux
- **changed** — Revamped translation tool to remember the last target language and allow filtering languages
- **changed** — Improved PDF rendering for faster performance and eliminated blurriness
- **changed** — Improved rendering of fixed layout EPUBs
- **changed** — Improved focus handling to prevent loss when navigating to new sections and fix tabbing layout breaks
- **changed** — Improved text selection across pages to allow selecting to the previous page
- **changed** — Changed column display to show more than one column only when viewport is in landscape or in portrait for vertical writing
- **changed** — Changed shortcut for table of contents from Ctrl+Alt+T to Ctrl+T
- **added** — Added Space and Shift+Space shortcuts for turning pages
- **added** — Added option to open books with external application from the library view
- **fixed** — Fixed formatting of copied text
- **fixed** — Fixed extra border in CBZ files
- **fixed** — Fixed handling of bare search template URL in OPDS feeds
- Revamped translation tool, which now remembers the last target language (#1159), and allows filtering languages
- Improved PDF support: the rendering is faster and no longer blurry
- Improved rendering of fixed layout EPUBs (see comments in #1318)
- Improved focus handling: the focus is no longer lost when navigating to new sections, and tabbing no longer breaks layout
- Improved text selection across pages, allowing selecting to the previous page
- It now only shows more than one column when the viewport is in landscape (or, for vertical writing, in portrait)
- Changed shortcut for the table of contents from Ctrl+Alt+T to Ctrl+T (#1316)
- Added Space/Shift+Space shortcuts for turning pages (#1336)
- Added option to open books with external application from the library view (#1372)
- Fixed formatting of copied text (#1191)
- Fixed extra border in CBZ files (#1421)
- Fixed handling of bare search template URL in OPDS feeds (#1401)
### 3.1.1
- Date: 2024-04-04
- Version: 3.1.1
- Original notes: https://github.com/johnfactotum/foliate/releases/tag/3.1.1
- Permalink: https://whatsnew.fyi/product/foliate/releases/3.1.1
- Labels: Platforms: Linux
- **fixed** — End of chapter cut off when chapter starts with page break
- **fixed** — Incorrect text wrapping in tables
- **fixed** — Performance issue with OPDS catalogs
- Fixed end of chapter cut off when chapter starts with page break (#1179)
- Fixed incorrect text wrapping in tables (#1278)
- Fixed a performance issue with OPDS catalogs (#1287)
### 3.1.0
- Date: 2024-01-05
- Version: 3.1.0
- Original notes: https://github.com/johnfactotum/foliate/releases/tag/3.1.0
- Permalink: https://whatsnew.fyi/product/foliate/releases/3.1.0
- Labels: Platforms: Linux
- **added** — Support for OPDS catalogs with OPDS 2.0 support
- **added** — Option to override publisher font
- **added** — Option to reduce animation
- **added** — Support for JPEG XL in CBZ
- **fixed** — Getting file from Tracker in Flatpak
- **fixed** — Parsing of non-year-only first-century and BCE dates
- Added support for OPDS catalogs, now with support for OPDS 2.0
- Added option to override publisher font (#1113)
- Added option to reduce animation (#1161)
- Added support for JPEG XL in CBZ (#1193)
- Fixed getting file from Tracker in Flatpak
- Fixed parsing of non-year-only first-century and BCE dates
### 3.0.1
- Date: 2023-11-20
- Version: 3.0.1
- Original notes: https://github.com/johnfactotum/foliate/releases/tag/3.0.1
- Permalink: https://whatsnew.fyi/product/foliate/releases/3.0.1
- Labels: Platforms: Linux
- **changed** — Updated translations
- **fixed** — Fixed desktop entry
- **fixed** — Fixed AppData
- **fixed** — Fixed broken layout for some books
- **fixed** — Fixed chromatic aberration in invert mode
- **fixed** — Fixed sidebar background to support gradient backgrounds
▲ Foliate with a custom theme, using a gradient as the background. In the previous version, the sidebar can only be themed if the background is a solid color. This is now fixed in v3.0.1.
---
- Updated translations
- Fixed desktop entry (#1109) and AppData (#1114)
- Fixed broken layout for some books (#1122)
- Fixed chromatic abberation in invert mode (#1137)
- Fixed sidebar background (pictured)
### 3.0.0
- Date: 2023-11-12
- Version: 3.0.0
- Original notes: https://github.com/johnfactotum/foliate/releases/tag/3.0.0
- Permalink: https://whatsnew.fyi/product/foliate/releases/3.0.0
- Labels: Platforms: Linux
- **changed** — Completely rewritten with GTK 4 and Adwaita, with refreshed interface and improved performance
- **changed** — Now uses own e-book parser and renderer instead of Epub.js and KindleUnpack
- **removed** — Support for OPDS catalogs
- **removed** — Support for offline dictionaries
- **changed** — Library and e-book viewer unified in a single window
- **changed** — Library now loads more books as you scroll without requiring clicks to load more items
- **changed** — Table of contents, annotations, and bookmarks moved to sidebar that can be docked or folded
- **changed** — Add Bookmark button moved to header bar with ribbon indicator when bookmarked
- **removed** — Turn page on tap feature
- **removed** — Skeuomorphic shadows option
- **removed** — Experimental traditional titlebar option
- **changed** — Files no longer loaded entirely into memory, greatly reducing startup time and memory usage
- **changed** — Mobipocket and Kindle files processed entirely in memory instead of extracted to disk
- **changed** — Mobipocket files divided into sections at mbp:pagebreak tags for improved performance
- **changed** — Invalid XHTML pages processed as HTML
- **changed** — Font override with CSS removed in favor of configurable default serif, sans-serif, and monospace fonts with minimum font size setting
- **added** — Support for obfuscated fonts
- **added** — Support for user stylesheet
- **fixed** — FB2 infinite recursion bug and comments now correctly ignored
- **added** — Experimental support for PDF files
Foliate has been completely rewritten from scratch with the latest platform libraries, [GTK](https://gtk.org/) 4 and [Adwaita](https://gnome.pages.gitlab.gnome.org/libadwaita/), with refreshed interface and improved performance. It now has its own e-book parser and renderer, and no longer uses [Epub.js](https://github.com/futurepress/epub.js) and [KindleUnpack](https://github.com/kevinhendricks/KindleUnpack).
Some features could not be ported in time. Most notably, this version has no support for OPDS catalogs and offline dictionaries.
UI changes:
- The library and the e-book viewer are unified in a single window (#509)
- The library now loads more books as you scroll, no longer requiring clicks to load more items (#583).
- Table of contents, annotations, bookmarks are now in a sidebar, which is docked to the side by default, but can also be set to be always folded (overlaid on top of content when revealed)
- The "Add Bookmark" button is moved to the header bar, and the page will show a ribbon when bookmarked (#863)
- Removed "turn page on tap"; use swiping instead
- Removed option for skeuomorphic shadows
- Removed experimental traditional titlebar option
Book rendering:
- It no longer loads the entire file into memory, greatly reducing startup time and memory usage, and it no longer loads every item in the TOC, further improving startup time (#526, #813)
- Reloading now properly reloads the file, rather than merely re-rendering (#544)
- Mobipocket and Kindle files are no longer extracted on disk; they are processed entirely in memory
- Mobipocket files are now divided into sections at `` tags, which greatly improves performance as it no longer requires rendering the whole book at once (#764). Unfortunately this also means existing annotations for this format will not be displayed correctly.
- When a page is not valid XHTML, it will be processed as HTML (#699)
- It no longer tries to override fonts with CSS. Instead, you can now configure the default serif, sans-serif, and monospace fonts (#222), as well as setting the minimum font size (#906).
- Added support for obfuscated fonts (#721)
- Added support for user stylesheet (#947)
- FB2: fixed infinite recursion bug (#935) and comments are now correctly ignored (#972)
- Added experimental support for PDF files (#139)
- Removed support for CBR, CBT, and CB7 files (CBZ is still supported)
Layout:
- Paginated mode now has animation and 1:1 touchscreen and touchpad swipe gestures (#188, #862)
- Paginated mode supports more than two columns. The number of columns is controlled by a maximum width setting. As the window gets wider, it will add more columns to prevent lines from getting too long.
- Margins are now relative to the viewport size
- It is now possible to configure both max width and max height.
- The page reflows faster when resizing, and reliably stays at the same location without flashing (#459)
- Switching between paginated and scrolled layouts is faster and can be done with a shortcut (Ctrl+M)
- Removed continuous scrolling mode, as the new renderer does not support it (yet)
Locations:
- Locations are now calculated from raw byte size instead of character count. The progress slider and reading time estimates are available instantly when you first open a book, and locations are no longer cached. Old .json files in the cache directory can be deleted.
- The progress slider now turns pages as you drag, and can be used with keyboard and mouse wheel (#386)
- Page-list and landmarks are now supported and can be accessed from the location popover
Find in book:
- Results are now shown in the sidebar (#674)
- Added option to ignore diacritics (#778) and to match whole words only
- Added shortcuts for going to next and previous matches (Ctrl+G and Ctrl+Shift+G) (#693)
Image viewer:
- Images are opened with double click by default; removed options for single, right, and middle cli
_[Truncated at 4000 characters — full notes: https://github.com/johnfactotum/foliate/releases/tag/3.0.0]_