# Bookmarks
Bookmarks in your terminal.
## Install
uv (recommended):
```bash
uv tool install bookmarks
```
cargo:
```bash
cargo install dkdc-bookmarks --features app,webapp
```
You can use `uvx` to run it without installing:
```bash
uvx bookmarks
```
## Usage
```bash
bookmarks [OPTIONS] [LINKS]...
```
### Configuration
Configuration lives at `$HOME/.config/bookmarks/bookmarks.toml`. Example:
```toml
[links]
github = "https://github.com"
linkedin = "https://linkedin.com"
[aliases]
gh = "github"
li = "linkedin"
[groups]
socials = ["github", "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:
| `--config` | `-c` | Open configuration file in `$EDITOR` |
| `--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 |