📑 GoMarks

_{💙 Gopher image by Maria Letta}

Simple CLI tool for manage your bookmarks _{🚧 WIP}

Warning

This repo is a work in progress! Needing both cleaning up and documenting.

gm-menu.mp4

Features

• Powered by Fzf
• Track bookmarks with git
  • Sync bookmarks as JSON files
  • Encrypt bookmarks with GPG and push to remote
• Encrypt local database with AES-GCM
• Support multiple databases
• Import bookmarks from firefox based browsers
• Import bookmarks from chromium based browsers
• Fetch title and description from added URL
• Check bookmark status (http status)
• Support for NO_COLOR env variable.
• Configure menu keybinds, prompt, header, preview (fzf) using a YAML file.
• Migrate items from one database to another
• Add docker|podman support _priority

Installation

go install github.com/mateconpizza/gm@latest

_{To uninstall the program remove the binary in your go env GOPATH}

Usage _(🚧WIP)

$ gm --help
Simple yet powerful bookmark manager for your terminal

Usage:
  gm [flags]
  gm [command]

Available Commands:
  conf        Configuration management
  rec         Records management
  db          Database management
  new         New bookmark, database, backup
  git         Git commands
  imp         Import from various sources
  help        Help about any command

Flags:
      --color string    output with pretty colors [always|never] (default "always")
  -c, --copy            copy bookmark to clipboard
  -e, --edit            edit with preferred text editor
  -f, --field string    output by field [id|url|title|tags]
      --force           force action | don't ask confirmation
  -H, --head int        the <int> first part of bookmarks
  -h, --help            help for gm
  -j, --json            output in JSON format
  -m, --menu            menu mode (fzf)
  -M, --multiline       output in formatted multiline (fzf)
  -n, --name string     database name (default "main.db")
  -O, --oneline         output in formatted oneline (fzf)
  -o, --open            open bookmark in default browser
      --qr              generate qr-code
  -r, --remove          remove a bookmarks by query or id
  -s, --status          check bookmarks status
  -t, --tag strings     list by tag
  -T, --tail int        the <int> last part of bookmarks
  -u, --update          update a bookmarks
  -v, --verbose count   Increase verbosity (-v, -vv, -vvv)
      --version         version for gm

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

📜 Menu support

Single/multiple selection for open, copy, edit, delete, check status.

gm-menu.mp4

➕ Add a bookmark

gm-add.mp4

📝 Edit a bookmark

gm-edit.mp4

🔳 Create QR-Code

gm-qr.mp4

☑️ Check status

gm-status.mp4

⚙️ Configuration

• $GOMARKS_HOME/config.yml file

YAML file structure

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
  • Add multiple databases option (default.db, work.db, client.db)
• Add Sync to remote repo???

XDG

• Store db in XDG_DATA_HOME
• Store menu config in XDG_CONFIG_HOME (WIP: for now in XDG_DATA_HOME)

📦 Packages

• terminal package
• color package
• files package

🟨 Redo

• Backups
• Databases

⛓️ Import

• From firefox
• From chrome chromium

♻️ Misc

• Add a logging library
• Support NO_COLOR env var. no-color