dkdc-bookmarks 0.2.1

Bookmarks in your filesystem
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

# Bookmarks

Bookmarks in your filesystem.

[![PyPI](https://img.shields.io/pypi/v/dkdc-bookmarks?color=blue)](https://pypi.org/project/dkdc-bookmarks/)
[![crates.io](https://img.shields.io/crates/v/dkdc-bookmarks?color=blue)](https://crates.io/crates/dkdc-bookmarks)
[![CI](https://img.shields.io/github/actions/workflow/status/lostmygithubaccount/bookmarks/ci.yml?branch=main&label=CI)](https://github.com/lostmygithubaccount/bookmarks/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/license-MIT-8A2BE2.svg)](https://github.com/lostmygithubaccount/bookmarks/blob/main/LICENSE)

## Install

uv (recommended):

```bash
uv tool install --from dkdc-bookmarks bookmarks
```

cargo:

```bash
cargo install dkdc-bookmarks --features app,webapp
```

You can use `uvx` to run it without installing:

```bash
uvx --from dkdc-bookmarks bookmarks
```

## Usage

```bash
bookmarks [OPTIONS] [LINKS]...
```

### Configuration

Bookmarks looks for a config file in this order:

1. `--bookmarks-file` / `-f` flag (explicit path)
2. `bookmarks.toml` in the current directory
3. `$HOME/.config/bookmarks/bookmarks.toml` (global, auto-created)

Example:

```toml
[links]
github = "https://github.com"
linkedin = "https://linkedin.com"

[aliases]
gh = "github"
li = "linkedin"

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

Links map to URLs, aliases map to links, and groups map to a list of aliases or links.

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

### Open links

Open links by name or alias or group:

```bash
bookmarks github
bookmarks gh linkedin
bookmarks socials
```

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

### Options

Available options:

| Flag | Short | Description |
|------|-------|-------------|
| `--bookmarks-file <PATH>` | `-f` | Use a specific bookmarks file |
| `--global` | `-g` | Use global config, ignore local bookmarks.toml |
| `--config` | `-c` | Open active bookmarks file in `$EDITOR` (use `-gc` for global) |
| `--app` | `-a` | Open desktop app (requires `app` feature) |
| `--webapp` | `-w` | Open the web app in browser (requires `webapp` feature) |
| `--help` | `-h` | Print help |
| `--version` | `-V` | Print version |