Configuration

Tune behavior for your workflow.

Configure retention, preview sizes, Quick Picker behavior, privacy filters, storage, and appearance with GUI settings or direct config file edits.

Data paths

  • Linux database: ~/.local/share/yanklog/history.db
  • Linux config: ~/.config/yanklog/config.toml
  • macOS database: ~/Library/Application Support/YankLog/history.db
  • macOS config: ~/Library/Application Support/YankLog/config.toml

Settings surface

  • History: max entries, preview length, and retention period.
  • Quick Picker: picker items, opacity, and shortcut command/reference.
  • Privacy: secret-like values, one-time codes, text length limits, and ignored patterns.
  • Appearance: system, dark, or light theme.

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
retention_days = 0
theme = "system"

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

[privacy]
ignore_secret_like = true
ignore_one_time_codes = false
min_text_length = 1
max_text_length = 0
ignored_patterns = []

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.

# Linux
rm -rf ~/.local/share/yanklog
# macOS
rm -rf "$HOME/Library/Application Support/YankLog"