github.com/blob42/gosuki

What Changed

Added

• Automatic backup of database before schema migration to protect against data loss.
• Creates gosuki-v<VERSION>.db.bak in the same directory as the database before migration

Changed

• Database and importer now use platform-appropriate data directories via utils.GetGosukiDataDir() — Windows uses %APPDATA%\gosuki, Linux/BSD retains ~/.local/share/gosuki
• suki: enable version display via --version flag (was previously hidden)
• Man pages: update synopsis formatting, add repository and documentation links, update copyright year
• TUI: use lowercase l (instead of L) to toggle logs panel

Fixed

• Skip backup for in-memory databases during schema migration (regression when db.filePath is empty)
• Firefox: close places.sqlite connection after each Run() to prevent file descriptor leak — closes #26, #22

Installation

Arch Linux

paru install gosuki-git

You can build from the PKGBUILD file in packages/arch/PKGBUILD

Ubuntu / Debian

Full instructions at https://git.blob42.xyz/gosuki.net/-/packages/debian/gosuki

Setup this registry from the command line:

sudo curl https://git.blob42.xyz/api/packages/gosuki.net/debian/repository.key -o /etc/apt/keyrings/gosuki.asc

echo "deb [signed-by=/etc/apt/keyrings/gosuki.asc] https://git.blob42.xyz/api/packages/gosuki.net/debian trixie main" | sudo tee -a /etc/apt/sources.list.d/gosuki.list
sudo apt update

To install the package, run the following command:

sudo apt install gosuki=1.4.2-1

macOS (Homebrew)

brew tap blob42/gosuki
brew install blob42/gosuki/gosuki

# OR with system tray
brew install --cask blob42/gosuki/gosuki-app

From Source

Gosuki Daemon:

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

note: skip the tags flag if you don't need the feature

Suki:

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

Full Changelog: v1.4.1...v1.4.2

This is a minor fix release, checkout v1.4.0 for more details about the new features in 1.4.

What Changed

Fixed

• suki: expand ~ and $HOME in database path before opening the database — closes #25
• Windows binaries packaged in zip instead of tar.gz
• Issues with release workflow that produced broken packages

Installation

Arch Linux

paru install gosuki-git

You can build from the PKGBUILD file in packages/arch/PKGBUILD

Ubuntu / Debian

Full instructions at https://git.blob42.xyz/gosuki.net/-/packages/debian/gosuki

Setup this registry from the command line:

sudo curl https://git.blob42.xyz/api/packages/gosuki.net/debian/repository.key -o /etc/apt/keyrings/gosuki.asc

echo "deb [signed-by=/etc/apt/keyrings/gosuki.asc] https://git.blob42.xyz/api/packages/gosuki.net/debian trixie main" | sudo tee -a /etc/apt/sources.list.d/gosuki.list
sudo apt update

To install the package, run the following command:

sudo apt install gosuki=1.4.1-1

macOS (Homebrew)

brew tap blob42/gosuki
brew install blob42/gosuki/gosuki

# OR with system tray
brew install --cask blob42/gosuki/gosuki-app

From Source

Gosuki Daemon:

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

note: skip the tags flag if you don't need the systray feature

Suki:

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

Full Changelog: v1.4.0...v1.4.1

What Changed

Fixed

• suki: expand ~ and $HOME in database path before opening the database — closes #25

Installation

Arch Linux

paru install gosuki-git

You can build from the PKGBUILD file in packages/arch/PKGBUILD

Ubuntu / Debian

Full instructions at https://git.blob42.xyz/gosuki.net/-/packages/debian/gosuki

Setup this registry from the command line:

sudo curl https://git.blob42.xyz/api/packages/gosuki.net/debian/repository.key -o /etc/apt/keyrings/gosuki.asc

echo "deb [signed-by=/etc/apt/keyrings/gosuki.asc] https://git.blob42.xyz/api/packages/gosuki.net/debian trixie main" | sudo tee -a /etc/apt/sources.list.d/gosuki.list
sudo apt update

To install the package, run the following command:

sudo apt install gosuki=1.4.1-rc1-1

macOS (Homebrew)

brew tap blob42/gosuki
brew install blob42/gosuki/gosuki

# OR with system tray
brew install --cask blob42/gosuki/gosuki-app```

### From Source

**Gosuki Daemon:**

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

note: skip the tags flag if you don't need the feature

Suki:

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

Full Changelog: v1.4.0...v1.4.1-rc1

Gosuki v1.4.0 brings two major platform milestones: native Windows support and macOS Homebrew installation via a dedicated tap. Both make Gosuki easier to install and run on every major
desktop platform.

Windows package managers like Chocolatey are planned for a future release.

blog: read more about the changes

macOS Homebrew Tap

A new Homebrew tap is available at Gosuki/homebrew-gosuki with both a CLI formula and a GUI cask:

# CLI — installs `gosuki` and `suki`
brew tap blob42/gosuki
brew install blob42/gosuki/gosuki

# GUI — installs `gosuki.app` to /Applications
brew install --cask blob42/gosuki/gosuki-app

Supports both Apple Silicon (arm64) and Intel (x86_64).

What Changed

Added

• Windows platform support (build, file locking, base directories) — closes #13 #21
• Windows systray icon for system tray mode
• marktab: strip action tags when processing hooks
• suki: --sort/-s flag to sort results by modified, title, or url with optional :asc/:desc direction (e.g., suki -s modified, suki -s title:asc)
• suki: sorting also available on search and fuzzy subcommands
• API: sort query parameter on /api/bookmarks (e.g., ?sort=modified:asc)
• Custom daemon listening address with --listen flag or webui config section
• Distribution packages builds for Arch Linux and Debian
• [webui]: search bar now allows toggling currently select tag filter
• BSD platforms support: Gosuki can be built and run on Open/Net/Free-bsd
• New supported browsers: Zen Browser, IceCat, Pale Moon, Basilisk

Adding browsers definitions in a YAML file

Adding custom browsers has been revamped. Previously new browser definitions were hard coded in source code.

Now browsers can be defined in a simple Yaml file under pkg/browsers/browsers.yaml and running make gen to generate the appropriate definitions per platform.

Changed

• (security) Listen on 127.0.0.1 by default
• upgraded to database schema v4: added composite index on gskbookmarks(version, node_id) for P2P sync change detection performance

Fixed

• Database: LIKE query wildcards (%) consumed as format verbs, causing silent query failures
• Mozilla profiles.ini parsing: profile sections not detected correctly
• Installing gosuki from source with go install (@kimjune01)
• Ensure cleaning of residual temp files that can cumulate if gosuki is
  not restarted

Installation

Arch Linux

paru install gosuki-git

You can build from the PKGBUILD file in packages/arch/PKGBUILD

Debian

Full instructions at https://git.blob42.xyz/gosuki.net/-/packages/debian/gosuki

Setup this registry from the command line:

sudo curl https://git.blob42.xyz/api/packages/gosuki.net/debian/repository.key -o /etc/apt/keyrings/gosuki.asc

echo "deb [signed-by=/etc/apt/keyrings/gosuki.asc] https://git.blob42.xyz/api/packages/gosuki.net/debian trixie main" | sudo tee -a /etc/apt/sources.list.d/gosuki.list
sudo apt update

To install the package, run the following command:

sudo apt install gosuki=1.4.0-1

From Source

Gosuki Daemon:

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

note: skip the tags flag if you don't need the feature

Suki:

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

New Contributors

• @kimjune01 made their first contribution in #23

Full Changelog: v1.3.0...v1.4.0

Added

• Windows platform support (build, file locking, base directories) — closes #13 #21
• Windows systray icon for system tray mode
• marktab: strip action tags when processing hooks
• suki: --sort/-s flag to sort results by modified, title, or url with optional :asc/:desc direction (e.g., suki -s modified, suki -s title:asc)
• suki: sorting also available on search and fuzzy subcommands
• API: sort query parameter on /api/bookmarks (e.g., ?sort=modified:asc)
• Custom daemon listening address with --listen flag or webui config section
• Distribution packages builds for Arch Linux and Debian
• [webui]: search bar now allows toggling currently select tag filter
• BSD platforms support: Gosuki can be built and run on Open/Net/Free-bsd
• New supported browsers: Zen Browser, IceCat, Pale Moon, Basilisk

Adding browsers definitions in a YAML file

Adding custom browsers has been revamped. Previously new browser definitions were hard coded in source code.

Now browsers can be defined in a simple Yaml file under pkg/browsers/browsers.yaml and running make gen to generate the appropriate definitions per platform.

Changed

• (security) Listen on 127.0.0.1 by default
• upgraded to database schema v4: added composite index on gskbookmarks(version, node_id) for P2P sync change detection performance

Fixed

• Database: LIKE query wildcards (%) consumed as format verbs, causing silent query failures
• Mozilla profiles.ini parsing: profile sections not detected correctly
• Installing gosuki from source with go install (@kimjune01)
• Ensure cleaning of residual temp files that can cumulate if gosuki is not restarted

chore: generate release notes

This version brings many fixes and improvements to Gosuki. The most important addition is the ability to archive bookmarks using ArchiveBox.

ArchiveBox Integration

This is a temporary third-party solution for archiving until native archiving features are available in Gosuki. It relies on ArchiveBox, a popular self-hosted web archival solution.

The integration between Gosuki and ArchiveBox uses the Marktab feature:

• Enable the archivebox marktab action
• Add a bookmark tagged with, or stored within a folder named @archivebox
• The marktab rule is triggered
• The archivebox-docker-ssh script is executed
• The script connects to your ArchiveBox instance locally or remotely (via Docker or SSH)
• The URL is added to ArchiveBox with the appropriate tags

Improved suki cli search

The suki CLI search functionality has been significantly enhanced with the following features:

• New suki search command for comprehensive bookmark searching
• Advanced tag filtering capabilities:
  • suki fuzzy|search [term...] :tag1,tag2 - Filter by multiple tags with logical AND
  • suki fuzzy|search [term ...] :OR tag1,tag2 - Filter by multiple tags with logical OR
• Updated queries and API support for filtering by query terms and multiple tags simultaneously
• Fuzzy search functionality for more flexible keyword matching
• Enhanced search results display with improved tag-based filtering options

These improvements provide users with powerful new ways to discover and filter their bookmarks through the cli and API.

What's Changed

Added

• ArchiveBox integration using @ArchiveBox tag or folder
• internal: call bookmark hooks from anywhere using bit flags
• new export formats: pocket-html, json(pinboard/wallabag), generic XML-RSS
• suki search command
• sudki fuzzy|search [term...] :tag1,tag2 to filter by tags with logical AND
• sudki fuzzy|search [term ...] :OR tag1,tag2 to filter by tags with logical OR
• updated queries and api to filter by query and many tags
• Add unix manpages for gosuki and suki commands

Fixed

• import: fix pocket import from csv format
• html-autoimport: parse hash tags from title
• Display browser flavor in bookmark's module field

New Contributors

• @mariusrugan made their first contribution in #16

Full Changelog: v1.2.1...v1.3.0

Added

• [ArchiveBox][01] integration using @archivebox tag or folder
• internal: call bookmark hooks from anywhere using bit flags
• new export formats: pocket-html, json(pinboard/wallabag), generic XML-RSS
• suki search command
• suki fuzzy|search [term...] :tag1,tag2 to filter by tags with logical AND
• suki fuzzy|search [term ...] :OR tag1,tag2 to filter by tags with logical OR
• updated queries and api to filter by query and many tags
• Add unix manpages for gosuki and suki commands

Fixed

• import: fix pocket import from csv format
• html-autoimport: parse hash tags from title
• Display browser flavor in bookmark's module field

What's Changed

Added

• Watefox browser support for Linux by @weiss-d in #10

Fixed

• broken default db path on startup

New Contributors

• @weiss-d made their first contribution in #10

Full Changelog: v1.2.0...v1.2.1

Added

• Waterfox browser support thanks to @weiss-d

Fixed

• broken default db path on startup

Project Updates

This is a massive release that introduces multi-device synchronization capability using two methods:

P2P Auto Sync (gosuki+)

• Real-time peer-to-peer sync across any number of devices without third-party tools
• Synchronizes and merges all bookmark metadata data, including tags, across all devices
• Possibility to run gosuki as a self-hosted container node for a centralized access to all your bookmarks
• Exclusive to Gosuki+ owners and Patreon Gosuki+ tier supporters
• For mobile, you can use the syncthing workaround described below.

Using Syncthing (free alternative)

• Uses the existing HTML export / auto-import feature
• Only synchronizes URL, Title, and Description (tags not synchronized)
• Relies on Syncthing for file-based synchronization
• Requires manual setup but works on all devices including mobile

Breaking Changes

config.toml

• database.db-path is now named database.path and should point to the database file
• [global] section is now at the root of the config file

Update your config.toml from the old to the new format.

config.toml (old format)

[global]
watch-all = true

[database]
db-path = "~/.local/share/gosuki"

config.toml (new format)

watch-all = true

[database]
path = "~/.local/share/gosuki/gosuki.db"

Added

• tui: improved tui ux: toggle logs, expand/collapse details, total db bookmarks
• cli: export to netscape html format
• cli: --db flag parameter to set a custom path for gosuki database
• browsers: ability to set a custom profile path for firefox/chrome based browsers
• message/goroutine based inter-module communication

Changed

• config: global config options moved to root of toml file
• cli: improved gosuki profile list and gosuki modules list commands
• upgraded to schema v3: introduced the version and node_id on the gskbookmarks table that is used by multi-device synchronization
• refactored logging to allow setting levels per subsystem
• added Trace level for very noisy log

Fixed

• cli: many fixes to cli flag behavior
• enable generated imports modules in /mods package (enables mods for installs from source)
• Log browser profile path errors as warnings
• Reduce log verbosity on default level

Full Changelog: v1.1.1...v1.2.0

Added

• tui: improved tui ux: toggle logs, expand/collapse details, total db bookmarks
• cli: export to netscape html format
• cli: --db flag parameter to set a custom path for gosuki database
• browsers: ability to set a custom profile path for firefox/chrome based browsers
• message/goroutine based inter-module communication

Changed

• config: global config options moved to root of toml file
• cli: improved gosuki profile list and gosuki modules list commands
• upgraded to schema v3: introduced the version and node_id on the gskbookmarsk table that is used by multi-device synchronization
• refactored logging to allow setting levels per subsystem
• added Trace level for very noisy log

Fixed

• cli: many fixes to cli flag behavior
• enable generated imports modules in /mods package (enables mods for installs from source)
• Log browser profile path errors as warnings
• Reduce log verbosity on default level

Minor fix release to reduce the log verbosity and show errors related to browser profile paths as warnings (see #8)

Full Changelog: v1.1.0...v1.1.1

Added

• github module: periodic import of starred repos
• import bookmarks from Pocket csv export with buku import pocket
• cli: --silent and -S to fully disable any log
• Added support for brave browser (linux, snap, flatpak)
• Flatpak support for: google-chrome, chromium, firefox, librewolf
• Database schema upgrade to v2 with xhsum column for efficient synchronization and conflict resolution
• Two-level database cache (L1/L2) for improved performance and consistent data state
• CLI command buku import for importing a buku DB to gosuki
• Schema versioning tracking in schema_version table
• bookmarks view with INSTEAD OF triggers for Buku compatibility
• Example bookmark launcher with rofi contrib/rofi.sh

Changed

• gosuki buku import becomes gosuki import buku
• Refactored cli to use urfave cli v3
• BREAKING: Database schema modified to allow future upgrades
• Schema migration: gskbookmarks table replaces bookmarks (legacy bookmarks remains as a view)
• Hide helper script from public doc

Fixed

• UpsertBookmark: does not unset the title if the new value is empty
• Description field not being updated in some cases
• CLI: use custom path to config file
• CLI: fix watch-all flag
• TUI: disable tui code in daemon mode

Changes to DB Schema

Previously there was only a bookmarks table which contained a few extra column compared to Buku. This table is renamed to gskbookmarks which will be the native gosuki table schema.

Instead we provide a bookmarks view into gskbookmarks with INSERT and UPDATE trigger (INSTEAD OF) that allow Buku programs to use Gosuki DB as a buku database while still benifiting from gosuki specific features that will eventually be added to the schema.

Added also schema versioning that will be tracked in the table creatively named schema_version.

Added

• example bookmark launcher with rofi contrib/rofi.sh

Fixed

• cli: use custom path to config file
• cli: fix watch-all flag
• tui: disable tui code in daemon mode

Initial public release