https://github.com/haaag/gm
🔖 Simple tool for manage your bookmarks
https://github.com/haaag/gm
bookmark bookmark-manager bookmarkmanager bookmarks manager sqlite3
Last synced: 7 months ago
JSON representation
🔖 Simple tool for manage your bookmarks
- Host: GitHub
- URL: https://github.com/haaag/gm
- Owner: haaag
- License: gpl-3.0
- Created: 2023-10-29T14:30:05.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-03-26T21:07:21.000Z (7 months ago)
- Last Synced: 2025-03-26T21:34:49.227Z (7 months ago)
- Topics: bookmark, bookmark-manager, bookmarkmanager, bookmarks, manager, sqlite3
- Language: Go
- Homepage:
- Size: 1.05 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
🔖 GoMarks
Simple cli tool for manage your bookmarks 🚧 WIP
> [!WARNING]
> This repo is a work in progress!
> Needing both cleaning up and documenting.
https://github.com/user-attachments/assets/b8d8f0fa-e453-421b-b27d-eebb3da7f51f
### ✨ Features
- [x] Powered by [`Fzf`](https://github.com/junegunn/fzf)
- [x] Support multiple `databases`
- [x] Restore `deleted` bookmarks
- [x] Import `bookmarks` from `firefox` based browsers
- [x] Import `bookmarks` from `chromium` based browsers
- [x] Fetch `title` and `description` from added URL
- [x] Check bookmark `status` _(http status)_
- [x] Support for [`NO_COLOR`](https://no-color.org/) env variable.
- [x] Configure menu `keybinds`, `prompt`, `header`, `preview` _(fzf)_ using a `YAML` file.
- [x] Migrate items from one database to another
- [ ] Encrypt database _priority_
- [ ] Add `docker|podman` support _priority_
- [ ] ...
### 📦 Installation
```sh
go install github.com/haaag/gm@latest
```
_To uninstall the program remove the binary in your `go env GOPATH`_
### 📖 Usage (🚧WIP)
```sh
$ gm --help
Simple yet powerful bookmark manager for your terminal
Usage:
gm [flags]
gm [command]
Available Commands:
backup backup management
config configuration management
database database management
help Help about any command
import import bookmarks from various sources
records records management
remove Remove databases/backups
version print version information
Flags:
--color string output with pretty colors [always|never] (default "always")
--force force action | don't ask confirmation
-h, --help help for gm
-n, --name string database name (default "bookmarks.db")
-v, --verbose verbose mode
```
### 🔑 Supported Env Vars
| Name | type | Description | Status |
| ------------------------ | ---- | ---------------------------------------- | ----------------------------------------- |
| `GOMARKS_HOME` | str | Path to database/yaml | **done** |
| `GOMARKS_EDITOR` | str | Preferred text editor | **done** |
| `NO_COLOR` | int | Disable all colors | **done** |
| ~~`GOMARKS_BACKUP_MAX`~~ | int | Maximum number of backups _(def: **3**)_ | **done** |
📜 Menu support
Single/multiple selection for open, copy, edit, delete, check status.
https://github.com/user-attachments/assets/b8d8f0fa-e453-421b-b27d-eebb3da7f51f
➕ Add a bookmark
https://github.com/user-attachments/assets/436b7553-b130-4114-8638-2e8a9b3ea2ce
📝 Edit a bookmark
https://github.com/user-attachments/assets/059dd578-2257-4db4-b7b1-1267d0375470
🔳 Create QR-Code
https://github.com/user-attachments/assets/f531fdc9-067b-4747-9f31-4afd5252e3cb
☑️ Check status
https://github.com/user-attachments/assets/a3fbc64a-87c1-49d6-af48-5c679b1046b1
⚙️ Configuration
- [x] `$GOMARKS_HOME/menu.yml` file
#### YAML file structure
```yaml
prompt: " Gomarks> "
header: true
preview: true
keymaps:
edit:
bind: ctrl-e
description: edit
enabled: true
hidden: false
open:
bind: ctrl-o
description: open
enabled: true
hidden: false
preview:
bind: ctrl-/
description: toggle-preview
enabled: true
hidden: false
qr:
bind: ctrl-k
description: QRcode
enabled: true
hidden: false
toggle_all:
bind: ctrl-a
description: toggle-all
enabled: true
hidden: true
yank:
bind: ctrl-y
description: yank
enabled: true
hidden: false
```
⏳ TODO
## TODO
### ❗ Priority
- [ ] Use a ORM
- [x] Add multiple databases option _(default.db, work.db, client.db)_
- [ ] Add `Sync` to remote repo???
#### XDG
- [x] Store `db` in `XDG_DATA_HOME`
- [ ] Store `menu config` in `XDG_CONFIG_HOME` _(WIP: for now in `XDG_DATA_HOME`)_
### 📦 Packages
- [x] `terminal` package
- [x] `color` package
- [x] `files` package
### 🟨 Redo
- [ ] Backups
- [ ] Databases
### ⛓️ Import
- [ ] From firefox
- [ ] From ~~chrome~~ chromium
### ♻️ Misc
- [ ] Add a logging library
- [x] Support `NO_COLOR` env var. [no-color](https://no-color.org/)