OpenSource-Hub
S

shiori

SHA-256
11.4k stars·System Optimization·SHA-256 checksum verified

A lightweight, single-binary bookmark manager with offline archiving, CLI and web UI, and support for multiple databases.

Smart Download

Download Download Version

v1.8.0 · 12.8 MB

Self-hosted, single-binary bookmark manager with automatic offline archiving, like Pocket but private.

Core Features

  • Single binary, portable and easy to deploy
  • Automatic offline archive of webpage readable content
  • Both CLI and web interface
  • Supports SQLite, PostgreSQL, MariaDB, and MySQL
  • Import from Pocket and Netscape bookmarks

What It Can't Do

  • •Browser extensions are in Beta, may have compatibility issues. 2. Offline archives consume disk space; clean up periodically. 3. To import from Pocket, export your Pocket data as HTML first. 4. Default database is SQLite; change it before first use if needed.

Use Cases

  • Personal bookmark management with privacy
  • Offline reading and archiving of important webpages
  • Lightweight self-hosted bookmark service for developers

Detailed Introduction

Shiori is a simple bookmark manager written in Go, inspired by Pocket. It runs as a single binary, making it portable and easy to deploy. Shiori supports managing bookmarks via a clean command-line interface or a pretty web interface. It can import bookmarks from Pocket and Netscape bookmark files, and export them as well. One of its standout features is automatic offline archiving: whenever possible, Shiori parses the readable content of a webpage and saves it locally, so you can access it even without an internet connection. It supports SQLite, PostgreSQL, MariaDB, and MySQL as backends. A beta version of browser extensions for Firefox and Chrome is also available, allowing you to save bookmarks directly from your browser.

Troubleshooting & FAQ (2)

information
When will a new version of shiori be released after v1.7.4?

A release candidate, version 1.8.0-rc.1, is now available. It includes the latest features and fixes from the master branch. Check the GitHub releases page to download.

GitHub Issue #1128
How-to
How can I import my Pocket bookmarks into Shiori when running in Docker?

You can use a shell script to parse Pocket's HTML export file and add each URL via shiori add. Save the script below, make it executable, and run it in the Shiori Docker container (ensure the pocket.html file is accessible).

#!/bin/sh
# optional: wget -O pocket.html <link to your pocket exports>
grep -Eoi '<a [^>]+>' pocket.html | grep -Eo 'href="[^"]+"' | cut -d'=' -f 2 | tr -d '"' | tac > Pocket2Shiori.txt

while IFS= read -r line; do
    shiori add $line
done < Pocket2Shiori.txt

rm Pocket2Shiori.txt

GitHub Issue #252

Tags

bookmarksself-hostedoffline-archivegosingle-binary

Getting Started

1

Download installer

Click the button above to download the installer for your system

Windows· 12.8 MBLinux· 12.1 MB
2

Install the software

Double-click the downloaded installer and follow the prompts

3

Step 1: Download the binary for your OS from GitHub Releases (e.g., shiori-linux-amd64)

4

Step 2: Make it executable (Linux/macOS: chmod +x shiori) and run `./shiori server` to start the web service

5

Step 3: Open http://localhost:8080 in your browser; also check `./shiori --help` for CLI commands

Install Guide
  1. Step 1: Download the binary for your OS from GitHub Releases (e.g., shiori-linux-amd64)
  2. Step 2: Make it executable (Linux/macOS: chmod +x shiori) and run `./shiori server` to start the web service
  3. Step 3: Open http://localhost:8080 in your browser; also check `./shiori --help` for CLI commands
File Integrity

SHA-256 checksum verified

Checksum extracted from GitHub official Release page

SHA256 Checksum

f980aad5fde0571476babbca6563eed7d057b4f34b4b86d1adc3b756fa3572ef

This checksum is extracted from the GitHub Release page. Verify file integrity after download.

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Simply delete the downloaded binary and the database file (default shiori.db in the current directory).

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseMIT
Last Updated2026-06-27 05:40:23
GitHub Repository

Having issues? Check the FAQ below

2 FAQs

Similar Projects

C

caddy

Caddy is an extensible server platform that uses TLS by default. It is production-ready, handles automatic certificates, and supports modern HTTP protocols.

H

Huginn

Huginn lets you build agents that automate online tasks. Events propagate through a directed graph. Monitor web, Twitter, email, and more.

R

RSSHub

RSSHub is the world's largest open-source RSS network. It generates RSS feeds from virtually any website, with over 5,000 instances and a thriving community. Perfect for aggregating social media, news, blogs, and more.