Configuration

Tune behavior for your workflow.

Configure retention, polling cadence, preview sizes, and keybinding behavior with GUI settings or direct config file edits.

Data paths

  • Database: ~/.local/share/yanklog/history.db
  • Config: ~/.config/yanklog/config.toml

Settings surface

  • Keybindings: shortcut, picker items, picker opacity.
  • History: max entries and preview length.
  • Performance: clipboard polling interval.

Config file format

Advanced users can edit settings directly in config.toml. 

max_history_size = 1000
poll_interval_ms = 500
max_preview_length = 100
window_width = 500
window_height = 600

[keybindings]
quick_pick = "Ctrl+Shift+V"
quick_pick_items = 10
quick_pick_opacity = 0.95

Troubleshooting

Error: "Failed to initialize database: file is not a database"

This usually means older unencrypted data is still present. Remove the old local data directory and start fresh.

rm -rf ~/.local/share/yanklog