# Foliate changelog
> A simple, modern ebook viewer for GNOME.
- Vendor: John Factotum
- Category: Productivity
- Platforms: Linux
- Official site: https://johnfactotum.github.io/foliate
- Tracked by: What's New (https://whatsnew.fyi/product/foliate)
- Harvested from: GitHub (johnfactotum/foliate)
- Entries below: 10 (newest first)
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.
## Releases
### 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
- 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
- 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 (#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, 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
▲ 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
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]_
### 2.6.4
- Date: 2022-01-13
- Version: 2.6.4
- Original notes: https://github.com/johnfactotum/foliate/releases/tag/2.6.4
- Permalink: https://whatsnew.fyi/product/foliate/releases/2.6.4
- Labels: Platforms: Linux
Fixed various bugs
Technical change: Foliate now optionally depends on Tracker 3, not Tracker 2.
### 2.6.3
- Date: 2021-04-01
- Version: 2.6.3
- Original notes: https://github.com/johnfactotum/foliate/releases/tag/2.6.3
- Permalink: https://whatsnew.fyi/product/foliate/releases/2.6.3
- Labels: Platforms: Linux
Fixed a performance issue with zipped files (including EPUB files) (https://github.com/Stuk/jszip/pull/716)
### 2.6.2
- Date: 2021-03-24
- Version: 2.6.2
- Original notes: https://github.com/johnfactotum/foliate/releases/tag/2.6.2
- Permalink: https://whatsnew.fyi/product/foliate/releases/2.6.2
- Labels: Platforms: Linux
Fix UI when running with libhandy 1.x