shiori
Self-hosted bookmark manager with web interface
TLDR
SYNOPSIS
shiori command [options] [args]
DESCRIPTION
shiori is a self-hosted bookmark manager that saves web pages for offline reading. When a URL is added, shiori downloads the page, extracts readable content using a readability algorithm, and stores both the original HTML and a clean text version in its database.Bookmarks support full-text search across titles, URLs, and saved content, making it easy to find previously saved pages. Tags provide additional organization, and the built-in web interface offers a visual way to browse, edit, and manage the collection.Data can be imported from and exported to standard bookmark HTML files for interoperability with browsers and other bookmark managers. The CLI provides the same functionality as the web interface for scripting and automation.
PARAMETERS
serve
Start web server.add URL
Add bookmark.search QUERY
Search bookmarks.print
List bookmarks.delete ID
Remove bookmark.export
Export bookmarks.import FILE
Import bookmarks.-t, --title TITLE
Set title.-e, --excerpt TEXT
Set excerpt.--tags TAGS
Add tags.
CONFIGURATION
SHIORI_DIR
Environment variable setting the data directory for the database and archived pages (default: ~/.local/share/shiori).
INSTALL
CAVEATS
Requires database (SQLite default). Large archives use storage. Some pages don't parse well.
HISTORY
Shiori was created by RadhiFadlillah as a simple bookmark manager. Named after Japanese for bookmark, it focuses on offline reading.
