Readwyn 0.1.0

An ebook manager for Linux

Readwyn is an ebook library and reader, and its Linux version has every feature of the Mac one: EPUB books and comics (CBZ, CB7 or CBT) in as many libraries as you like, conversion of older formats to EPUB 3, Kobo sync, a one-off calibre import, reading stats and the 3D library. It comes as a deb package for Ubuntu and Debian and as an rpm for Fedora, each built for x86_64 and arm64.

The Readwyn library on Linux: the sidebar with Home library, Library, Notebook, Stats, Sync, and the Kobo Clara 2E card; a grid of covers with titles and authors; the search with Ctrl+K and the window controls at the top right
The library on Linux

Where it finds and keeps things

You can import a calibre library once, and on Linux Readwyn finds calibre's default library through ~/.config/calibre/global.py.json. A Kobo turns up wherever udisks mounts it: /media/<user> on Ubuntu and Debian, /run/media/<user> on Fedora.

Your Goodreads sign-in token goes into your desktop's keyring (gnome-keyring or KWallet, through the Secret Service). Libraries and settings live in ~/.local/share/readwyn, caches in ~/.cache/readwyn.

What changes from the Mac

  • Wherever the Mac app says “Mac” for a computer, the Linux app says “computer”: “this computer”, “No computers connected”. It can't tell whether another machine is a Mac.
  • Shortcuts swap ⌘ for Ctrl, so Ctrl+, opens Settings and Ctrl+Shift+L enters the 3D library. Super stays with the desktop. Back is Alt+←, as in Linux browsers and file managers, and the Mac's Emacs keys in text fields are gone: Ctrl+A selects all.
  • Settings › Appearance offers “Match the system” instead of “Match the Mac”. There's no Readwyn menu at the top of the screen as on a Mac, so “About Readwyn” sits at the foot of that tab.
  • Linux has no dictionary of its own, so Wiktionary is the only one. Until you download it, a lookup offers it there and then: English entries, about 900 MB, once. After that, lookups work offline.
  • The speak button in a lookup or in My Words goes through speech-dispatcher, the system's speech service.
  • GNOME on Wayland leaves the title bar to the app, so Readwyn draws its own minimize, maximize and close at the right end of the top bar. There's more on the windows in the post on Wayland and X11.
  • With Readwyn server on in Settings › Other devices, the background server starts at login from an entry in ~/.config/autostart. Its icon sits in the system tray on KDE, and on GNOME when the AppIndicator extension is on (Ubuntu turns it on by default).

Other computers and reader apps

Another computer running Readwyn can pair with this one and open its libraries, and reader apps can browse them over OPDS. For a machine with no display, such as a NAS, there's ryn-server instead (Run a headless ebook server on Linux). It's narrower than the app: it serves the Readwyn apps only.

Which distributions

The packages need glibc 2.35 or later, which puts the floor at Ubuntu 22.04 LTS and Debian 12. On Fedora, any release that's still supported will do. They were tested on Ubuntu, Debian and Fedora, with GNOME and KDE Plasma (the arm64 post lists each system).

You'll find the steps in Install Readwyn on Ubuntu from a deb package and Install Readwyn on Fedora from an rpm package, and the arm64 files in An ebook manager on arm64 Linux. When a new version is out, a card in the sidebar tells you.

Readwyn sticks to the freedesktop standards rather than one distribution or one desktop. If a desktop service is missing, only the feature that needs it stops working. Without speech-dispatcher, for example, the speak button does nothing, and the rest of the app carries on.