go-shiori/shiori

★ 11,451GoAudience · developerComplexity · 3/5LicenseSetup · easy

Mindmap

mindmap
  root((Shiori))
    What it does
      Saves bookmarks
      Offline page copies
      Search and organize
    Interfaces
      Command line CLI
      Web browser UI
      Browser extension
    Databases
      SQLite file-based
      PostgreSQL
      MariaDB and MySQL
    Import and Export
      Pocket import
      Netscape format

mindmap root((Shiori)) What it does Saves bookmarks Offline page copies Search and organize Interfaces Command line CLI Web browser UI Browser extension Databases SQLite file-based PostgreSQL MariaDB and MySQL Import and Export Pocket import Netscape format

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Replace Pocket or browser bookmarks with a self-hosted manager that stores offline copies of pages so they survive link rot.

USE CASE 2

Save web pages directly from Firefox or Chrome using the built-in browser extension and access them through a web UI later.

USE CASE 3

Migrate all existing Pocket bookmarks to a self-hosted setup using Shiori's built-in import tool.

USE CASE 4

Run a shared bookmark server for a small team backed by PostgreSQL or MariaDB for multi-user access.

Tech stack

GoSQLitePostgreSQLMySQLMariaDB

Getting it running

Difficulty · easy Time to first run · 30min

Distributed as a single binary with no complex installation, just download, configure a database, and run.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Shiori is a bookmark manager you can run on your own computer or server, designed as a self-hosted alternative to services like Pocket. It lets you save, organize, search, edit, and delete web page bookmarks without depending on a third-party cloud service. It comes as a single downloadable file with no complex installation, and it can be used in two ways: through a command line interface for people comfortable with a terminal, or through a web interface accessible in a browser. Both are included in the same program. When you save a bookmark, Shiori can automatically fetch the readable text of the page and store an offline copy, so you can still read the content even if the original site goes down or changes. It also supports a beta browser extension for Firefox and Chrome, allowing you to save pages directly from the browser without switching to the app. Bookmarks can be imported from Pocket or from the Netscape Bookmark format (the standard export format used by most browsers and bookmark tools), and they can be exported back to that same format. For storage, Shiori works with SQLite (a simple file-based database), PostgreSQL, MariaDB, and MySQL, giving flexibility for both personal and shared setups. The project is MIT licensed, meaning it is free to use and modify. Documentation lives in a separate folder within the repository.

Copy-paste prompts

Prompt 1

I want to set up Shiori as a self-hosted Pocket replacement on my home server. Show me how to download and run it, configure it with SQLite, and access the web interface.

Prompt 2

I have a Pocket export file with hundreds of bookmarks. Walk me through importing them into Shiori and installing the browser extension to save new pages going forward.

Prompt 3

I want to run Shiori on a VPS with PostgreSQL instead of SQLite and make the web UI accessible over HTTPS. Show me the configuration steps.

Open on GitHub → Explain another repo

← go-shiori on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.