命令行选项

Snipaste 支持使用命令行选项进行功能调用，但除了带 * 标记的选项（如 --config）外，其他选项只在 Snipaste 启动后才有效。

专业版支持将命令行参数与全局快捷键绑定，可以根据自己的需要将任意功能绑定到快捷键！

粗体字标出的命令也需要专业版。

此文档的在线版可能超前于你所使用的软件版本，请以软件内置文档为准。

调用方法

snipaste.exe [OPTIONS]

示例：

复制全屏截图：

• Windows 桌面版：X:/path/to/your/Snipaste.exe snip --full -o clipboard
• 微软商店版：Snipaste snip --full -o clipboard
• Mac 版：/Applications/Snipaste.app/Contents/MacOS/Snipaste snip --full -o clipboard

截图命令

snip                              开始截屏
snip --area X Y WIDTH HEIGHT      开始截屏，并把选区左上角设为 (X, Y)，
                                  宽度为 WIDTH，高度为 HEIGHT
snip --size WIDTH HEIGHT          开始截屏，并把选区宽度设为 WIDTH，
                                  高度为 HEIGHT，选区中心为当前的光标位置
snip --full                       开始截屏，并把选区设定为全屏
snip --last                       开始截屏，并把选区设定为上一次成功截屏的区域
snip --active-window              开始截屏，并把选区设定为当前活动窗口
snip --custom                     弹出自定义截屏对话框（可指定截图位置、大小、延迟时间）

以上截图选项还可：

1. 结合 --delay TIME 指定延迟时间（单位为秒），如 snipaste.exe snip --delay 1.5 表示延迟 1.5 秒后开始截屏。
2. 结合 --shadow 获取带阴影截图；结合 --no-shadow 获取不带阴影截图。
3. 结合 --output 或 -o 指定截图的输出方式：

-o pin                           将截图贴到屏幕上
-o clipboard                     复制截图
-o FILE_NAME                     将截图保存到指定文件 FILE_NAME，支持使用变量
                                 (如含有空格需用双引号括起)
-o quick-save                    将截图保存到快捷保存文件夹
-o file-dialog                   截图后弹出文件保存对话框
-o printer                       将截图发送到打印机
-o no-auto-save                  不触发自动保存
-o success                       不将截图保存到任何地方，仅仅将其标记为成功
                                 成功的截图会进入截图记录（可以被回放），
                                 并且可以触发自动保存（需在选项中勾选自动保存）
-o exec(COMMAND)                 截屏成功后执行指定命令 COMMAND

对于专业版，以上输出选项可使用 ; 进行组合，但输出顺序是预定义的，与命令中的书写顺序无关。

输出顺序：FILE_NAME -> file-dialog -> printer -> quick-save -> clipboard -> pin -> success -> exec(COMMAND)

如： snip -o file-dialog;clipboard 会在截屏选区确定后自动复制截图，并弹出文件保存对话框。

贴图命令

paste                             将剪贴板内容转化为贴图贴出
paste --clipboard                 同 paste
paste --plain TEXT                将纯文本 TEXT 贴出
                                  (如含有空格需用双引号括起)
paste --html TEXT                 将 TEXT 视作 HTML 格式贴出
                                  (如含有空格需用双引号括起)
paste --files FILE1 FILE2 ...     将图像文件 FILE1, FILE2 等贴出
paste --files FOLDER1 FILE1       将图像文件 FILE1, FILE2, FILE3 等贴出
  FILE2 FOLDER2 FILE3 ...         如果 FILE1 是个相对路径，那么它是相对于文件夹 FOLDER1 的，
                                  同理 FILE3 是相对于文件夹 FOLDER2.
                                  文件夹路径需要以 / 或 \ 结尾

以上贴图选项还可结合 --pos 指定贴图位置：

--pos X Y                         指定贴图左上角的屏幕位置

其他命令

show-images                       显示所有贴图
hide-images                       隐藏所有贴图
toggle-images                     显示/隐藏所有贴图
create-group [GROUPNAME]          创建名为 GROUPNAME 的贴图组
                                  如未指定组名，则弹窗提示输入组名
switch-groups                     显示贴图组列表
switch-group [GROUPNAME]          切换到名为 GROUPNAME 的贴图组
                                  (如含有空格需用双引号括起)
                                  如未指定组名，则切换到下一贴图组
empty-group                       清空当前组
show-group-manager                打开"管理贴图组"窗口
no-click-through                  取消所有贴图的鼠标穿透模式
toggle-click-through              切换贴图的鼠标穿透模式
show-tray-menu                    在当前鼠标位置下显示托盘菜单
whiteboard                        进入白板模式（注意：Esc 退出截图将被禁用；工具条会被自动隐藏，
                                  如果需要它，可以通过空格键切换出来）
  --color [COLOR]                 指定白板模式的填充颜色，[COLOR] 可以是常见颜色名如 black, white, red 或十六进制颜色值如 #001122
  --active-screen                 仅在光标显示所在屏幕激活白板模式
transparent-whiteboard            透明白板模式（屏幕内容不会冻住）
external COMMAND                  调用外部程序 COMMAND
                                  如 external notepad c:/123.txt 将调用记事本打开文件 c:/123.txt
pick-color                        选取并复制屏幕某像素的颜色值
barcode-scan                      识别屏幕上的二维码/条形码并复制结果，如识别失败，将清空系统剪贴板
barcode-decode FILE               识别指定图片上的二维码/条形码并复制结果，如识别失败，将清空系统剪贴板
paste-as-image                    尝试将剪贴板内容（如文字）转化成图像并执行发送 Ctrl-V
                                  (仅 Windows)
paste-as-plain-text               将剪贴板中的 HTML 内容转化成不带格式的纯文本并发送 Ctrl-V
                                  (仅 Windows)
switch-group-prev                 切换到上一次激活的贴图组
disable-hotkeys                   禁用全局快捷键
enable-hotkeys                    启用全局快捷键
toggle-hotkeys                    禁用/启用全局快捷键
disable-hot-corners               禁用触发角
enable-hot-corners                启用触发角
toggle-hot-corners                禁用/启用触发角
clear-snip-history                清空截图记录
open-preferences                  打开首选项
docs                              打开帮助窗口
exit                              退出 Snipaste
--config=/path/to/config.ini      *指定配置文件路径 (支持绝对路径/相对路径)
                                  (如路径含有空格需用双引号括起)

示例

以下例子可直接填入专业版的 编辑命令 对话框中：

如果使用快捷方式、命令行窗口或脚本等方式进行外部调用，需在每条命令前面加上可执行程序的名字或路径，参考调用方法。

[静默] 表示该命令将在后台自动完成，不需要任何用户交互。

1. snip -o clipboard
   • 截屏，在选区确定后自动将截图复制到剪贴板
2. snip --last -o clipboard
   • 对上一次的截图区域进行截图并复制 [静默]
3. snip --full -o clipboard
   • 复制全屏截图 [静默]
4. snip --shadow --active-window -o clipboard
   • 对当前窗口进行截图，添加阴影后复制 [静默] [专业版]
5. snip -o d:\123.png;exec(d:\ocr.exe d:\123.png)
   • 开始截屏，在选区确定后将截图保存为 d:\123.png，并执行命令 d:\ocr.exe d:\123.png（请将 d:\ocr.exe 替换成你自己的外部程序的路径） [专业版]
6. snip -o "d:\temp\source.png";exec(cmd /c "d:\Tesseract-OCR\tesseract.exe" "d:\temp\source.png" "d:\temp\ocr_res" -c preserve_interword_spaces=1 --oem 1 --psm 1 -l eng+chi_sim && notepad "d:\temp\ocr_res.txt")
   • 开始截屏，在选区确定后用本地 tesseract 程序识别选区中的文字，识别成功后用记事本显示文字内容 [专业版]