README.md

imgcopy & imgpaste

通过命令行复制与粘贴图片到 macOS 剪贴板的 Swift 工具集。

项目简介

本项目提供两个 Swift 编写的 CLI 工具：

• imgcopy：将图片文件或标准输入的图像数据复制到系统剪贴板。
• imgpaste：从系统剪贴板中获取图像数据并以数据流的形式输出。

适用于在 macOS 上进行图像处理、脚本自动化或提升终端工作效率的场景。

使用场景举例

• 将本地或网络图片快速复制到剪贴板，用于粘贴到微信、Slack、浏览器等。
• 编写自动化截图、上传、分享脚本。
• 从剪贴板提取图片做图像识别、OCR 或二维码扫描处理。
• 在本机与远程 Mac 之间通过 SSH 跨设备复制图像。

安装方法

确保你已安装 Swift 编译器（Xcode Command Line Tools）：

xcode-select --install

编译方式：

./build.sh

编译完成后会生成两个可执行文件：

• imgcopy
• imgpaste

可将它们复制到系统 PATH 中：

sudo cp imgcopy imgpaste /usr/local/bin/

使用示例

以下是常见用法示例，展示如何结合 imgcopy 与 imgpaste 进行图像复制与提取操作。

---

1. 通过标准输入将本地 JPEG 文件复制到剪贴板

cat result.jpeg | imgcopy -

等价于 imgcopy result.jpeg，适用于需要从管道中传输图像数据的场景。

---

2. 直接将本地 PNG 文件复制到剪贴板

imgcopy result.png

适用于常规图像文件快速复制到剪贴板。

---

3. 将在线图片通过 URL 下载后直接复制到剪贴板

curl 'https://images.unsplash.com/photo-1569158049406-6dc6f71ccd48' | imgcopy -

无需保存图片，直接将网络图片复制到剪贴板。

---

4. 从剪贴板中粘贴图像并保存为 PNG 文件

imgpaste > result.png

将当前剪贴板中的图像保存到 result.png 文件中。

---

5. 从剪贴板中提取图像并进行二维码识别

imgpaste | zbarimg -

适用于扫码类脚本，从剪贴板中提取图像后直接分析二维码/条形码。

---

6. 从本机剪贴板读取图像并通过 SSH 复制到远程主机的剪贴板

imgpaste | ssh [email protected] '/usr/local/bin/imgcopy -'

7. 从其他地方复制的图片使用 base64 编码提供给 API 使用

imgpaste | base64 | pbcopy

imgpaste|base64 -w 0| jq -Rs '{"model":"gpt-4o","messages":[{"role":"user","content":[{"type":"text","text":"请识别这张图片的内容"},{"type":"image_url","image_url":{"url":("data:image/jpeg;base64," + .)}}]}]}'|http https://api.openai.com/v1/chat/completions "Authorization:Bearer $OPENAI_API_KEY"|jq '.choices[0].message.content'
{
  "id": "chatcmpl-Bwh3QbzqhHaOTMe7WSEBqcSVjQOaK",
  "object": "chat.completion",
  "created": 1753328224,
  "model": "gpt-4o-2024-08-06",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "这是一个表情符号风格的插图，展示了一个人坐在一台带有苹果标志的笔记本电脑前面。这个人有深色头发和大眼睛，正在注视着电脑屏幕。",
        "refusal": null,
        "annotations": []
      },
      "logprobs": null,
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 270,
    "completion_tokens": 53,
    "total_tokens": 323,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "audio_tokens": 0
    },
    "completion_tokens_details": {
      "reasoning_tokens": 0,
      "audio_tokens": 0,
      "accepted_prediction_tokens": 0,
      "rejected_prediction_tokens": 0
    }
  },
  "service_tier": "default",
  "system_fingerprint": "fp_a288987b44"
}

imgpaste|base64 -w 0| jq -Rs '{"model":"gpt-4o","messages":[{"role":"user","content":[{"type":"text","text":"请识 别这张图片的内容"},{"type":"image_url","image_url":{"url":("data:image/jpeg;base64," + .)}}]}]}'|http https://api.openai.com/v1/chat/completions "Authorization:Bearer $OPENAI_API_KEY"|jq '.choices[0].message.content'
"这是一个表情符号样式的图像，显示一个人正在使用一台苹果笔记本电脑。这个人物的设计是卡通化的，似乎集中精力于屏幕。"

实现跨设备复制图片到远程 macOS 主机的剪贴板（需双方都安装本工具）。

build.sh

swiftc -o imgcopy imgcopy.swift
swiftc -o imgpaste imgpaste.swift

imgcopy.swift

import Cocoa

func copyToClipboard(from path: String) -> Bool {
    var image: NSImage?

    if path == "-" {
        // 从标准输入读取
        let inputData = FileHandle.standardInput.readDataToEndOfFile()
        image = NSImage(data: inputData)
    } else {
        image = NSImage(contentsOfFile: path)
    }

    guard let validImage = image else {
        print("Failed to load image.")
        return false
    }

    let pasteboard = NSPasteboard.general
    pasteboard.clearContents()
    return pasteboard.writeObjects([validImage])
}

// MARK: - Main

if CommandLine.argc < 2 {
    print("""
    Usage:

    Copy file to clipboard:
        ./imgcopy path/to/image.png

    Copy stdin to clipboard:
        cat image.png | ./imgcopy -
    """)
    exit(EXIT_FAILURE)
}

let path = CommandLine.arguments[1]
let success = copyToClipboard(from: path)
exit(success ? EXIT_SUCCESS : EXIT_FAILURE)

imgpaste.swift

import Cocoa

func pasteFromClipboard() -> Data? {
    let pasteboard = NSPasteboard.general
    guard let image = pasteboard.readObjects(forClasses: [NSImage.self], options: nil)?.first as? NSImage else {
        return nil
    }

    guard let tiffData = image.tiffRepresentation,
          let bitmap = NSBitmapImageRep(data: tiffData),
          let pngData = bitmap.representation(using: .png, properties: [:]) else {
        return nil
    }

    return pngData
}

// MARK: - Main

if let imageData = pasteFromClipboard() {
    FileHandle.standardOutput.write(imageData)
    exit(EXIT_SUCCESS)
} else {
    fputs("No valid image found in clipboard.\n", stderr)
    exit(EXIT_FAILURE)
}