Skip to content

blob42/gosuki

Repository files navigation

GoSuki

Multi-browser, standalone, bookmark manager

No subscription or extension required

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 privacy first, 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. 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
  • 🖥️ 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-bookmarks-webui.mp4

marktab-scripts.mp4

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

cli-suki.mp4


Full Demo on YT

Installation

Checkout the quick start guide.

Gosuki currently supports Linux and MacOSbeta . More platforms are planned.

Releases

From source

Dependencies:
  • sqlite3 development library
go install github.com/blob42/gosuki/cmd/gosuki@latest

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

To build with systray icon support use go install -tags systray ...

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.

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 Buku bookmarks

gosuki buku import

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.

Debugging

Enable detailed logging with:

gosuki --debug=3

note: Avoid using --tui with debug mode.

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.

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

  • Archival - Archive bookmarks in a portable format for offline access.

  • Packaging: Package for all common Linux distros, MacOS brew and FreeBSD ports

  • Linkrot - Automatically identify broken links and replace with web.archive.org alternatives

  • Metadata Refresh - Automatically clean and update tags/metadata for existing bookmarks

  • Browser Sync - Push changes back to browsers for consistent bookmark management

  • Management UI - Intuitive interface for organizing and pruning bookmarks

  • More Platforms - FreeBSD, Windows, 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