命令行选项

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 --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. 结合 --output 或 -o 指定截图的输出方式：

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

例如：

snipaste.exe snip -o clipboard 表示截屏时松开鼠标左键后自动将截图复制到剪贴板

snipaste.exe snip --last -o pin 表示自动对上一次的截图区域进行截图并马上把截图贴到屏幕上

贴图命令

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 的贴图组
                                  (如含有空格需用双引号括起)
                                  如未指定组名，则切换到下一贴图组
no-click-through                  取消所有贴图的鼠标穿透模式
toggle-click-through              切换贴图的鼠标穿透模式
show-tray-menu                    在当前鼠标位置下显示托盘菜单
whiteboard                        进入白板模式（注意：Esc 退出截图将被禁用；工具条会被自动隐藏，
                                  如果需要它，可以通过空格键切换出来）
--config=/path/to/config.ini      *指定配置文件路径 (支持绝对路径/相对路径) 
                                  (如路径含有空格需用双引号括起)

专业版命令

除以上命令外，专业版还支持这些命令：

external COMMAND                  调用外部程序
                                  如 external notepad c:/123.txt 将调用记事本打开文件 c:/123.txt
pick-color                        选取并复制屏幕某像素的颜色值
paste-as-image                    尝试将剪贴板内容（如文字）转化成图像并执行发送 Ctrl-V
                                  (仅 Windows)
paste-as-plain-text               将剪贴板中的 HTML 内容转化成不带格式的纯文本并发送 Ctrl-V
                                  (仅 Windows)
transparent-whiteboard            透明白板模式（屏幕内容不会冻住）
switch-group-prev                 切换到上一次激活的贴图组
disable-hotkeys                   禁用全局快捷键
enable-hotkeys                    启用全局快捷键
toggle-hotkeys                    禁用/启用全局快捷键
clear-snip-history                清空截图记录
open-preferences                  打开首选项
docs                              打开帮助窗口
exit                              退出 Snipaste