Bookmarks #

Bookmarks in your filesystem.

Install #

Recommended:

curl -LsSf https://dkdc.sh/bookmarks/install.sh | sh

Pre-built binaries are available for Linux and macOS via Python (uv). Windows users should install via cargo or use macOS/Linux.

uv:

uv tool install dkdc-bookmarks

cargo:

cargo install dkdc-bookmarks --features app,webapp

Verify installation:

bookmarks --version

You can use uvx to run it without installing:

uvx --from dkdc-bookmarks bookmarks

Usage #

bookmarks [OPTIONS] [URLS]...

Configuration #

Bookmarks looks for a config file in this order:

1. --bookmarks-file / -f flag (explicit path)
2. --local / -l flag (creates ./bookmarks.toml if missing)
3. bookmarks.toml in the current directory (must exist)
4. $HOME/.config/bookmarks/bookmarks.toml (global, auto-created)

Example:

[urls]
dkdc-bookmarks = "https://github.com/dkdc-io/bookmarks"
github = { url = "https://github.com", aliases = ["gh"] }

[urls.linkedin]
url = "https://linkedin.com"
aliases = ["li"]

[groups]
socials = ["gh", "linkedin"]

URLs can be plain strings, inline tables with aliases, or expanded tables. Groups reference url names or aliases.

Use the --config or --app or --webapp option to edit the configuration file.

Open urls #

Open urls by name, alias, or group:

bookmarks github
bookmarks gh linkedin
bookmarks socials

You can input multiple url names, aliases, or groups at once. They will be opened in the order they are provided.

Options #

Available options: