gosuki

package module
v1.3.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 16, 2025 License: AGPL-3.0 Imports: 0 Imported by: 0

README

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

Marktab Scripts

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

CLI - Suki


Full Demo on YT

Installation

Checkout the quick start guide.

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

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.

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.

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 in a portable format for offline access.
  • 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 - Intuitive interface for organizing and pruning bookmarks
  • Browser Sync - Push changes back to browsers for consistent bookmark management
  • Packaging: Package for all common Linux distros, MacOS brew and FreeBSD ports
  • 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.

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

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Bookmark 

type Bookmark struct {
	URL      string   `json:"url"`
	Title    string   `json:"metadata"`
	Tags     []string `json:"tags"`
	Desc     string   `json:"desc"`
	Module   string   `json:"module"`
	Version  uint64   `json:"version"`
	Modified uint64   `json:"modified"`
	Xhsum    string   `json:"xhsum"`
}

Bookmark type

Source Files

View all Source files

Directories

Path Synopsis
browsers
chrome
Chrome browser module.
 Chrome browser module.
firefox
Configuration
 Configuration
qute
cmd
Modules can register custom hooks here that will plug into urfave *cli.App API.
 Modules can register custom hooks here that will plug into urfave *cli.App API.
gosuki command
Main command line entry point for gosuki
 Main command line entry point for gosuki
suki command
Package hooks permits to register custom hooks that will be called during the parsing process of a bookmark file.
 Package hooks permits to register custom hooks that will be called during the parsing process of a bookmark file.
internal
api
database
sqlite database management
 sqlite database management
gui/icon
index
scripts command
Script to generate a json file containg 1000 random bookmark.
 Script to generate a json file containg 1000 random bookmark.
server
utils
webui
github
# Github Personal Token: This module requires a github personal token to be able to access the user's profile.
 # Github Personal Token: This module requires a github personal token to be able to access the user's profile.
importer
pkg
browsers
browsers/mozilla
Package mozilla provides functionality for managing Mozilla-based browser profiles, such as Firefox and LibreWolf.
 Package mozilla provides functionality for managing Mozilla-based browser profiles, such as Firefox and LibreWolf.
build
https://github.com/lightningnetwork/lnd/blob/master/build/version.go#L66 https://raw.githubusercontent.com/lightningnetwork/lnd/refs/heads/master/build/version.go
 https://github.com/lightningnetwork/lnd/blob/master/build/version.go#L66 https://raw.githubusercontent.com/lightningnetwork/lnd/refs/heads/master/build/version.go
config
events
export
Package export implements common exporting functionnality
 Package export implements common exporting functionnality
logging
manager
marktab
Package marktab handles reading and parsing of marktab files, inspired by the crontab file format.
 Package marktab handles reading and parsing of marktab files, inspired by the crontab file format.
modules
Modules allow the extension of gosuki to handle other types of browsers or source of data that can be turned into bookmarks.
 Modules allow the extension of gosuki to handle other types of browsers or source of data that can be turned into bookmarks.
parsing
Tag related parsing functions
 Tag related parsing functions
profiles
Package profiles ...
 Package profiles ...
tree
watch

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.