Skip to content

Configuration

TaintedAngel edited this page Mar 16, 2026 · 1 revision

Configuration

Config lives at ~/.config/linuxshot/config.json. You can edit it directly, use the CLI, or use the Settings dialog from the tray.

Viewing Config

linuxshot config             # show everything
linuxshot config --get KEY   # show one value
linuxshot config --path      # show file path

Changing Values

linuxshot config --set KEY VALUE

Examples:

linuxshot config --set upload_service catbox
linuxshot config --set auto_upload true
linuxshot config --set image_format jpg
linuxshot config --set screenshot_dir ~/Screenshots

Reset to Defaults

linuxshot config --reset

All Options

Upload

Option Default Values
upload_service catbox catbox, 0x0, imgur
auto_upload false true / false
copy_url_to_clipboard true true / false

Capture

Option Default Description
image_format png png, jpg, webp
jpg_quality 95 1-100, only used for jpg
copy_image_to_clipboard true copies the image itself
show_notification true desktop notification popup
capture_delay 0 seconds to wait before capture
include_cursor false show cursor in screenshot

Storage

Option Default Description
screenshot_dir (empty) defaults to ~/Pictures/LinuxShot
filename_pattern LinuxShot_%Y-%m-%d_%H-%M-%S strftime pattern
save_to_disk true save screenshot to disk

Shortcuts (KDE)

Option Default Description
shortcut_region Print key for region capture
shortcut_fullscreen Ctrl+Print key for fullscreen
shortcut_window Alt+Print key for window capture
override_spectacle true take over Spectacle's PrtSc keys

After changing shortcut values, run linuxshot setup or restart the tray to apply.

Imgur

Option Default Description
imgur_client_id (empty) your Imgur API client ID
imgur_client_secret (empty) your Imgur API secret
imgur_anonymous true upload without account

History

Option Default
save_history true
max_history_entries 1000

Clone this wiki locally