🔖 GoMarks

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
• Support multiple databases
• Restore deleted bookmarks
• 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
• Encrypt database _priority
• Add docker|podman support _priority
• ...

📦 Installation

go install github.com/haaag/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:
  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.

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/menu.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