Readeck: Readeck 0.22

5 min read Original article ↗

Readeck 0.22 is out with new features and lots of improvements! It introduces Annotations, Bookmark properties edition, Multi Factor Authentication, Forwarded Authentication and more.

Annotations

You can create highlights in Readeck but, before today's release, you couldn't add a short (or long) note to your highlight. This release adds a "note" field on every highlight and introduces a new highlight color: transparent.

Highlight with annotation (click to play)

As you can see, the highlight dialog was updated to accommodate for the extra field. It now supports dark mode properly and is less in the way when using a mobile browser.

The text you add is indexed and bookmarks with specific terms in annotations will show up when using Readeck's search engine.

Annotations are also included when exporting a bookmark to EPUB. They will show as footnotes in the e-book. However, since annotations can contain private information, they are removed in bookmarks shared by email or with a public link; the highlights remain, though.

Thanks to @vhbelvadi and @ruben for talking me into implementing a feature that wasn't planned for this release and to @mislav and @Pontoporeia for the extensive tests and tricky bug fixes. 👏

Bookmark properties

Bookmark properties editor (click to play)

By popular demand, you can now edit more properties on a bookmark than only its title. The not so great title editor has been replaced by a dialog that lets you edit the following:

  • title
  • description
  • site name
  • authors
  • publication date
  • language
  • text direction

Multi Factor Authentication

Finally! Readeck now provides multi factor authentication to improve your account security. This release adds TOTP as a new security option. The "password" menu in your account is replaced by a "security" one, where you'll find the password form and a button to setup TOTP on your account.

TOTP Setup with Bitwarden (click to play)

If a user has lost their TOTP secret, it can be removed using Readeck's user command.

Forwarded Authentication

Readeck now supports forwarded authentication from Identity Providers like Authelia or Tailscale. This authentication mechanism is simple: it instructs your reverse proxy to send authentication information through HTTP headers.
Setting up forwarded authentication is quite simple and explained in the documentation.

Even though I raised concerns against something that I consider fundamentally insecure, we can make it reasonably safe using Mutual authentication with mTLS.

While mTLS is optional, it's highly recommended. Please carefully read the security part in the documentation.

Farewell to the legacy API authentication

As announced in November last year, the legacy API authentication mechanism has been removed, for it can't coexist with TOTP and external authentication. If you're using an app that doesn't support OAuth, you can probably keep using it, as long as you are already connected. It's never too late to ask nicely your favorite app developer that they implement OAuth as soon as possible.

Once again, @mislav has been quite busy working on the content extractor, improving its reliability, making things faster and fixing bugs.

  • Speed up fetching bookmark outgoing links.
  • Improvements with WebP images processing.
  • Increased thumbnail and bookmark image size.
  • Improved stripping heading anchors.
  • Preserve anchor links with special characters.
  • Improved display of SVGs with percentage dimensions.
  • Prevent error logging on non fatal issues when parsing JSON-LD and fediverse pages.

It is safe to say that Readeck wouldn't exist without the initial Readability port from Shiory. Radhi has made an excellent job over the years, maintaining an almost line by line copy of Mozilla's readability.

Readeck now uses @mislav's fork and I'm very pleased that, after a friendly discussion, we can now contribute it back to where it started.

Wallabag import improvements

Following a report from a new user, @mislav fixed a host of rare but annoying issues when importing articles from Wallabag. There should be no encoding issues anymore and it can import more documents than before.
Excellent job! 🎉

Applications and Browser Extension

Safari extension

Good news! Readeck browser extension was upgraded with an improved authentication flow in order to make it compatible with Safari. Thanks to @Nicell for the initial work on this.

The extension is currently in "test flight" for users who want to test it and should be released soon.

iOS App

Ilyas has been hard at work on the Readeck for iOS application, with a new version that brings a lot of improvements, OAuth support and offline reading. 🚀

Obsidian plugin

@makebit has worked on an Obsidian plugin for quite a while now. At the end of last year, Lennard added the OAuth support into it. Great job!

Koreader App

If, like me, you're a happy Koreader user, there is now a plugin for Readeck with OAuth support (thanks Nicell). You'll have to install it yourself but it's a quite simple process.

SingleFile support

SingleFile is a browser extension that lets you save a page with all its media into a single file. Rings a bell, doesn't it? SingleFile can be configured to send its result to a service, instead of saving a file on your disk. Readeck now accepts and can save pages created by SingleFile.

You'll find the instructions in the FAQ.

Miscellaneous changes

  • User's last login date and time
  • Enabled theme toggle for public bookmarks, by @shom
  • Configurable UNIX socket file mode
  • Let the PWA use the device orientation, by @mlfh
  • Fixed Back/forward navigation with gestures
  • Fixed EPUB mimetype
  • Fixed Sorting on api/bookmarks/sync

Thank you! ❤️

As always, thank you for reporting bugs, suggesting improvements, submitting contributions and translations. Many, many, thanks to all the users who installed the testing version and reported issues!

Patch releases

Readeck 0.22.1 - March 6th

  • Restored German translation
  • Pinboard import adapter, by @jlecour
  • Improved permission system
  • Updated Go to 1.26.1
  • Fixed markup error in "about" page
  • Fixed HTTP cache for zstd responses

Readeck 0.22.2 - March 8th

  • Fixed Youtube transcript extraction
  • Added DOMParser for Content Scripts

Download Readeck Upgrade Instructions