Advanced Configs

These are settings without user interface. Please use them with caution.

Usage

1. Quit Snipaste.
2. Open config.ini with any text editor.
3. Add corresponding lines of settings under the correct group (the name in between square brackets).
   • Note: Text behind the semicolon is only comments.
4. Save and close config.ini.
5. Open Snipaste.

[General]

; Set the history directory (since v1.8.2)
; Snipaste will not create the folder for you. Please make sure it exists, otherwise "./history" will be used
; Slash should be / or \\
; Support environment variables, e.g. %username%
; No need to use quotes if there exist spaces in the path; do not support non-English characters
; Examples for relative paths:
; abc
; ./abc
; ../abc
; Examples for absolute paths:
; D:/configs/sphistory
; D:\\abc def\\history

history_dir=c:/abc

; Hide the tray icon (since v1.8)
; After hidden, if you want to open the Preferences Dialog,
; just press Ctrl + Shift + P (Windows) / Cmd + , (macOS) on the image window
; Valid vaules: true, false

hide_tray_icon=true

; Set the process priority (since v1.13.3)
; Valid values:
; 0: Normal 1: Above normal 2: High 3: Realtime
; If this option is not present or has an invalid value, the default value will be used:
; if the number of CPU cores is no less than 2, the default value is 1, otherwise it is 0
; Windows ONLY

process_priority=2

[Snip]

; The threshold to hide anchors automatically (since v1.13)
; If set to 100, the anchors will be automatically hidden when the width or height
; of the snipping area is larger than 100 pixels
; Use 0 to disable automatically hiding the anchors
; The default value is 80 * DPI scale factor

anchors_threshold=80

; Do not omit sythesized key 'C' (since v1.8.4)
; Some of the dictionary programs sends synthesized Ctrl + C when mouse left button is released,
; so Snipaste needs to omit the synthesized 'C' to make snipping work properly.
; If this feature, on the contrary, annoys you (for example, a GoldenDict user, or Snipaste
; is running in a virtual machine / controlled remotely by TeamViewer, etc.), you should set this option to true
; Windows ONLY
; Valid vaules：true, false

do_not_omit_synthesized_c=true

; Exclude the windows of specific programs from window detection (since v1.10.2)
; For example, when we use LICEcap for screen recording, the window of LICEcap will be detected and
; prevents Snipaste from detecting the window / interface elements beneath the LICEcap window.
; You can append 'licecap.exe' (case-insensitive) here to avoid the situation
; Use comma to separate the program names
; Windows ONLY

exclude_from_detection=a.exe, b.exe

; Use another interface element detection algorithm for the windows of specific programs (since 1.10.2)
; Detecting the interface elements of some programs may cause Snipaste to be unresponsive or even crash
; To avoid this, you can put their program names here, Snipaste will use another algorithm for them,
; which is less likely to cause a crash, with the disadvantage of less detected elements
; Use comma to separate the program names
; Windows ONLY

crashes=a.exe, b.exe

[Paste]

; Force line wrap when converting HTML to image (since v1.13.2)
; So that the resulted image satisfies the 'Max width' setting for text-to-image conversion
; Valid values: true, false

force_html_wrap=true

; Specify the distance threshold for edge attachment for image windows, in pixels (since v2.3)
; The default value is 20 * DPI scale factor

magnetic_attach_threshold=50

; Disable frame resizing for image windows (since v2.3)
; The default value is false

disable_frame_resize=true

[Update]

; Fake software version (since v1.12)
; Only for debug purpose
; You can fake a lower version to force the download of the latest version when checking for updates
; You can also fake a higher version to skip certain versions (for example, if specified to 1.99,
; Snipaste will be updated only when its version reaches 1.99)

fake_version=1.11.0

[Hotkey2]

; Exchange the functions of W A S D keys and arrow keys (since v1.13)
; The default value is 'false', which means WASD keys are for moving the cursor,
; and the arrow keys will move the snipping area or the image windows
; If set to 'true', their functions will be changed
; Note: Keys with modifiers are not affected,
; i.e. 'Ctrl + →' (Expand to right border of the snipping area) is still 'Ctrl + →'
; Valid values: true, false

exchange_wasd_and_arrow_keys=true

; Allow simple hotkeys to be used as global hotkeys (>= v2.2.4)
; Simple hotkeys include:
; single letter keys, number keys, punctuation keys, arrow keys and keys like Esc, Enter, etc.
; and also Shift + letter keys, number keys, punctuation keys
; The default value is false
; Valid values: true, false

allow_simple_hotkeys=true

[Annotate]

; Automatically select the annotation after creating it (>= v2.2)
; The default value is 
; Valid vaules：true, false

auto_select_on_creation=true

[Output]

; When saving an image, examine if it has any translucent pixels. If no, remove its alpha channel to reduce the file size (>= v2.2)
; The default value is true
; Valid vaules：true, false

auto_alpha_channel_removal=true

[Misc]

; Use uppercase letters for Hex colors (since v1.13.2）
; Valid values：true, false

uppercase_hex_color=true

; Set the maximum image file size for auto download (by dragging an image on the webpage to an image window) (since v2.1)
; The default value is 20.0 (MB)

auto_download_max_image_size_mb=20

; Specify the time interval threshold for key double-tap, in ms (>= v2.3)
; The default value is 400

double_tap_interval=500

[Log]

; Specify the log file name (since v1.12)

file=splog.txt

; Set the flush interval of logs (in seconds) (since v1.12)
; The default value is 0, which means it will automatically be flushed whenever it sees fit to achieve good performance
; Note: If the log level is 'Trace' or 'Debug', this setting has no effect.

flush_interval=2

; Set the log rotate (since v1.12)
; 0 means no rotate
; The default value is 1

rotate=1

; Set the maximum log file size for rotation (since v1.12)
; The default value is 2.0 (MB)

rotate_size_mb=2.0