Shiori v1.5.0 Release Notes

Release Date: 2019-09-21 // over 4 years ago
  • 🚀 Today Shiori v1.5.0 is released after almost five months of development (with several long breaks between). This release is quite huge with many changes and improvement from older version. Granted there are still some rough edges, but I think it's still usable enough to release.


    • 👉 Use Go modules. Thanks to this, we don't need to use Git submodules anymore to include go-readability.
    • Restructure code following Go Project Layout.
    • ⚡️ Huge update in go-readability. Now it closely follows code in Readability.js, which means it now as accurate as Firefox reader mode.
    • ✂ Removed account command. Before, on fresh install, to access web interface we need to manually register account. This is quite annoying, especially if we are using Docker. Now, on fresh install we can just login using default password and account (shiori with password gopher).
    • 🚚 Replace JWT with simple session for login. Before, if an account already login then admin removed that account, the account can still access the web interface as long its JWT key is still valid. Now, thanks to session, if an account got removed we can do mass log out for that account.
    • 👉 Use favicon as alternative if hero image doesn't exists.
    • Resized thumbnail image to 4:3 aspect ratio. This is done to make all image looks consistent. If the thumbnail image doesn't have that ratio, it will be padded by color that matches with the image.
    • ➕ Add support for MySQL database (#81, thanks to @peteretelej for the groundwork).
    • ➕ Add initial support for archiving the entire web page. Before, Shiori only saves the output of go-readability which sometimes not really good (for example is Stack Overflow). Now, when requested Shiori will archive the web page with its entire resource.
    • When a bookmark is archived, the reader mode will uses images and other resources from the archive instead of the one from original site (#108).
    • ➕ Add support for bookmarking non HTML URL (#77).
    • ➕ Add support for bookmarking non reachable URL (#128).
    • 🛠 Fix failed to delete many bookmarks at once (#104).
    • ➕ Add option to specify address and port number while serving web interface (#101, thanks to @contradictioned).
    • ➕ Add portable mode (#126).
    • Set user agent for downloading and archiving an URL (#127).
    • ➕ Add support for searching in bookmark's excerpt (#134).
    • ➕ Add check command to find bookmarks that no longer available online, thanks to @sascha-andres.
    • Other minor improvements in CLI, which I forgot the detail.


    • 👉 Use ES6 feature like modules and arrow function. Thanks to modules, I can (kind of) imitate the Vue's single file component without using JS bundler.
    • 👉 Use fetch instead of third party library like axios.
    • Increase font size to make it more readable.
    • 🚚 Move actions from sidebar to header.
    • Revamped the mobile view.
    • Revamped options page and add account management.
    • 👉 Uses history state so back and forward button works properly. Thanks to this, now search result can be shared via its URL (#111).
    • ➕ Add icons which shows if bookmark has archive or readable content.
    • In list mode, make layout tighter to give space for more visible content.
    • Now bookmarks is sorted by last created instead of last modified.
    • ➕ Add initial support for web extension to replace bookmarklet.
    • In Firefox for Android, make the address bar gone while scrolling.
    • Display creation and modified time in local timezone instead of UTC (#103).
    • 👉 Make Vue.js doesn't uses development mode in production (#106).
    • ➕ Add rel=noopener on link that open in new tab (#105, thanks to @sascha-andres).
    • Group bookmarks that tagged or untagged (#109).
    • ➕ Add support to flag whether a bookmark is public or private (#112).
    • ➕ Add support for account's level. Now, we can specify whether an account is the owner (i.e. can add and edit data) or only a visitor (i.e can only read the data) (#137).
    • ➕ Add tag's auto completion in edit dialog (#135).
    • ➕ Add menu to rename the existing tags (#136).

    Future Plans

    There are still several issues and feature that I want to be implemented in the future :

    • ✅ If you look at the source code, you will realize that there are no unit tests. None, at all.
    • 🌐 Some feature is available in web interface but not in CLI. For example: renaming tags and flagging a bookmark as private or public.
    • ✅ I haven't extensively tested the import feature. The issues about importing bookmarks (#121, #125) mention that they have a lot of bookmarks to import. Meanwhile my bookmarks at most only has several hundred entries which is not near enough to what they have. Thanks to this, I haven't been able to reproduce their issues. If any of you willing to submit your bookmarks, feels free to email me.

    If you like this project please consider donating to me either via PayPal or Ko-Fi.

Previous changes from v1.0

  • This is the first stable version of shiori. The stable here means two things :

    • It doesn't crash or error as often as before, so it can be used for daily use.
    • 🚀 The database and directory structure has been fixed, so future update should be backward compatible with this release.

    🚀 There are several changes compared to initial release, but (IMHO) the most important are :

    • 💻 Huge UI redesign
    • ➕ Add import from Pocket
    • Implement bookmarklet for faster bookmarking