https://github.com/blob42/gosuki
blazing fast real time bookmark manager with zero plugin dependencies
https://github.com/blob42/gosuki
bookmarks-manager buku cli golang linux multi-browser multi-profile real-time zero-plugin
Last synced: 2 months ago
JSON representation
blazing fast real time bookmark manager with zero plugin dependencies
- Host: GitHub
- URL: https://github.com/blob42/gosuki
- Owner: blob42
- Created: 2023-10-03T22:29:05.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2023-10-12T13:52:46.000Z (almost 2 years ago)
- Last Synced: 2024-01-28T06:41:11.801Z (over 1 year ago)
- Topics: bookmarks-manager, buku, cli, golang, linux, multi-browser, multi-profile, real-time, zero-plugin
- Language: Go
- Homepage:
- Size: 653 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
GoSuki
Multi-browser, standalone, bookmark manager
No subscription or extension required
Demo |
Documentation |
Website
Install |
Feautres
What's this ? Oh, just another bookmark manager. No big deal.
- [x] Ever feel like your bookmarks are a [chaotic mess](https://news.ycombinator.com/item?id=13734253) ?
- [x] Ever find yourself swapping browsers when they [stop meeting](https://github.com/uBlockOrigin/uBlock-issues/wiki/About-Google-Chrome's-%22This-extension-may-soon-no-longer-be-supported%22) your demands ?
- [x] Have past bookmark managers [let you down](https://support.mozilla.org/en-US/kb/future-of-pocket), vendor locking or abandoning you in your time of need ?
- [x] Would you rather avoid entrusting your bookmarks to cloud companies and [browser extensions](https://arstechnica.com/security/2025/07/browser-extensions-turn-nearly-1-million-browsers-into-website-scraping-bots/) ?
- [x] Perhaps you keep multiple browser profiles for work, research, streaming, and development ?
- [x] Do you use some [“obscure”](https://github.com/qutebrowser/qutebrowser) 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](#how-does-it-work-).
## ✨ 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](https://gosuki.net/docs/features/marktab-actions)
- 🏷️ **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](https://github.com/jarun/buku) sqlite database, you can use any program [that was made for buku](https://github.com/jarun/buku?tab=readme-ov-file#related-projects)
- 📡 **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
## Installation
Checkout the [quick start guide](https://gosuki.net/docs/getting_started/quickstart).
Gosuki currently supports Linux and MacOSbeta . More platforms are [planned](#roadmap).
### Packages
### From source
##### Dependencies:
- `sqlite3` development library
```shell
go install github.com/blob42/gosuki/cmd/gosuki@latest
```
- Build with systray icon feature
```shell
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
```shell
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](contrib/gosuki.service)):
```bash
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:
```bash
gosuki --tui start
```
The TUI displays module status and bookmark processing metrics.
### Importing bookmarks
#### From Buku
```shell
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:
```shell
gosuki import pocket export_file.csv
```
### Debugging
A leveled logging system is available with `--debug={trace,debug,info,warn,error,fatal,none}`
```bash
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](docs/internal/architecture.md) 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](#support).
## 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](https://gosuki.net/docs/contributing/browsers)
- Creating modules for third-party APIs
- Contributing code or documentation
- Sharing the project with others who might benefit
- Financial contributions via [GitHub Sponsors](https://github.com/sponsors/blob42) or [Patreon](https://www.patreon.com/c/GoSuki)
## 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"](docs/how-does-it-compare-to.md) guide.
- [Buku](https://github.com/jarun/buku): Gosuki is compatible with Buku
- [Shiori](https://github.com/go-shiori/shiori): Simple bookmark manager built with Go
- [bmm](https://github.com/dhth/bmm): Get to your bookmarks in a flash
- [wallabag](https://github.com/wallabag/wallabag): Self-hosted application for saving web pages
- [floccus](https://floccus.org/): Self-hosted extension based bookmark synchronization
## Links & Discussions
- [Ask HN: Do you still use browser bookmarks?](https://news.ycombinator.com/item?id=14064096)
- [Ask HN: How to handle bookmarks so you can find them again?](https://news.ycombinator.com/item?id=13734253)
- [Reddit: Does anyone actually use mobile bookmarks](https://www.reddit.com/r/firefox/comments/dez7hh/does_anyone_actually_use_mobile_bookmarks/)
- [You are the dead internet](https://www.youtube.com/watch?v=aoTQPoz9_As)