gosuki

GoSuki

Multi-browser, realtime, bookmark manager

No subscription or extension required

Demo | Documentation | Website

Install | Feautres | Faq

What's this ? Oh, just another bookmark manager. No big deal.

• Ever feel like your bookmarks are a chaotic mess ?

• Ever find yourself swapping browsers when they stop meeting your demands ?

• Have past bookmark managers let you down, vendor locking or abandoning you in your time of need ?

• Would you rather avoid entrusting your bookmarks to cloud companies and browser extensions ?

• Perhaps you keep multiple browser profiles for work, research, streaming, and development ?

• Do you use some “obscure” browser that doesn't support extensions ?

• If you're nodding your head to any of the above, then look no further:

GoSuki is a cloudless, extension-free, multi-browser, and real time bookmark tracker and organizer. It packs everything in a single binary and captures all your bookmarks in a portable database with multi-device sync & archiving capability. It will eventually support every internet browser under the sun.

add your browser

✨ Features

• 📦 Standalone: Gosuki is a single binary with no dependencies or external extensions necessary. It's designed to just work right out of the box
• ⌨️ Ctrl+D: Use the universal shortcut to add bookmarks and call custom commands
• 🏷️ Tag Everything: Tag with #hashtags even if your browser does not support it. You can even add tags in the Title. Your folders become tags
• 🔎 Real time: Gosuki keeps track of your bookmarks, spotting any changes as they happen
• 📱 Multi-Device-Sync: Synchronize your bookmarks across multiple devices.
• 🗃️ Archiving Archive your bookmarks with ArchiveBox.
• 🖥️ Web UI + CLI Builtin, local Web UI. Also works without Javascript. dmenu/rofi compatible CLI.
• 🧪 Hackable: Modular and extensible. Custom scripts and actions per tags and folders.
• 🌎 Browser Agnostic: Detects which browsers you have installed and watch changes in all of them
• 👤 Profile Support: Also handles multiple profiles for each browser
• 💾 Buku Compatibility: Gosuki is compatible with the Buku sqlite database, you can use any program that was made for buku
• 📡 External APIs Consolidate your curated content from external APIs (github, reddit ...)

📸 In Action

Realtime Bookmark Tracker

realtime-bookmarks-webui.mp4

Marktab Scripts

marktab-scripts.mp4

Note: you can also drop bookmarks in a folder matching an action to execute the script. Folders are tags

CLI - Suki

cli-suki.mp4

Full Demo on YT

Installation

Checkout the quick start guide.

Gosuki supports Linux, macOS, Windows, and BSD (FreeBSD, NetBSD, OpenBSD).

Packages

From source

Dependencies:

• sqlite3 development library

go install github.com/blob42/gosuki/cmd/gosuki@latest

• Build with systray icon feature

go install -tags systray github.com/blob42/gosuki/cmd/gosuki@latest

optional suki cli command

suki is a cli command to list/filter bookmarks with a customizable dmenu/rofi compatible output

go install github.com/blob42/gosuki/cmd/suki@latest

Running GoSuki

GoSuki is designed to run as a background service for real-time bookmark monitoring. Below are the recommended ways to start and interact with the application.

As a Service

Start GoSuki as a persistent service (systemd example):

gosuki start

This initializes all configured browsers and begins real-time bookmark tracking.

By default the Web UI binds to 127.0.0.1:2025. Use --listen to change the address:

gosuki --listen 0.0.0.0:8080 start

Terminal UI (TUI)

Launch with an interactive terminal interface for real-time parsing overview:

gosuki --tui start

The TUI displays module status and bookmark processing metrics.

Importing bookmarks

From Buku

gosuki import buku

This will imports all bookmarks from Buku into Gosuki. Gosuki DB is compatible with buku, meaning you can symlink gosuki DB or add it to Buku and it will just work. However, gosuki cannot read a buku database unless it is imported with the above command.

From pocket

Import bookmarks from a Pocket export in csv format:

gosuki import pocket export_file.csv

Debugging

A leveled logging system is available with --debug={trace,debug,info,warn,error,fatal,none}

gosuki --debug=info 

## Set debug level per subsystem
gosuki --debug=info,chrome=trace

note use --debug=list to list the available levels and subsystems

How does it work ?

Gosuki monitors the browser's internal bookmark files for changes. It uses the native OS event notification system to detect changes as they happen. This allows it to be fast and efficient, without the need for any plugins or extensions. This architecture makes it possible to load bookmarks from any kind of internet browser, API or program that emits something akin to a bookmark.

Browser definitions are stored in a single YAML file (pkg/browsers/browsers.yaml) and code is generated via make gen. Adding a new browser only requires adding its paths to this file.

The application maintains a local portable database of all tracked bookmarks, accessible via the built-in web UI or CLI.

Curious for more details on the internals ? Checkout the Architecture file.

Rationale

I spent years working on and off on this project. My goal was to create a bookmark management solution resilient to vendor lock-in and the increasing trend of subscription services seeking rent for access to our curated internet content.

In the age of the "everything internet" web links and bookmarks represent a significant investment of human time spent curating and selecting relevant content. The past decade has seen a noticeable enshittification decline in the quality of internet results, with SEO-optimized blogs, marketing materials, and censored links making it increasingly difficult to find valuable websites and articles. Now with the advent of AI-generated “slop” and low-quality content, we face an endless stream of potentially fake and unreliable information.

GoSuki is my modest attempt to make the definitive solution for managing internet bookmarks that is: browser and platform agnostic, immune to vendor lock-in and fully self contained. The extension-free architecture of gosuki means that eventually every internet browser under the sun will be supported.

If you like this project consider starring the repo and supporting the effort.

Roadmap

• Multi-device Sync - Synchronization between multiple devices
• Archiving - Archive bookmarks with ArchiveBox
• Linkrot - Automatically identify broken links and replace with web.archive.org alternatives
• Metadata Refresh - Automatically clean and update tags/metadata for existing bookmarks
• Management UI - Self-hosted server node with admin interface.
• Browser Sync - Push changes back to browsers for consistent bookmark management
• Packaging - More distros and FreeBSD ports
• More Platforms - Android

Support

GoSuki is a one-man project. If you find value in this tool, consider supporting its development through:

• Reporting issues and suggesting features
• Testing and adding new browsers
• Creating modules for third-party APIs
• Contributing code or documentation
• Sharing the project with others who might benefit
• Financial contributions via GitHub Sponsors or Patreon

Contributing

We welcome contributions from the community! To get started:

1. Fork the repository
2. Create a new branch for your changes
3. Submit a pull request with clear documentation

For bug reports, please provide detailed steps to reproduce the issue.

Related Projects

Read the "how does it compare to" guide.

• Buku: Gosuki is compatible with Buku
• Shiori: Simple bookmark manager built with Go
• bmm: Get to your bookmarks in a flash
• wallabag: Self-hosted application for saving web pages
• floccus: Self-hosted extension based bookmark synchronization

Links & Discussions

• Ask HN: Do you still use browser bookmarks?
• Ask HN: How to handle bookmarks so you can find them again?
• Reddit: Does anyone actually use mobile bookmarks
• You are the dead internet
• How to choose a browser for everyday use ?
• Lifting the veil - how to test browsers for spyware

---

In memory of my father, mentor, role model, best friend, and the kindest person I have ever known.