ClipDrop: Turn Your Mac Clipboard Into Files Instantly

What ClipDrop does

ClipDrop saves clipboard content, including screenshots, code snippets, and API responses, to a file. Copy the content and run clipdrop filename in your terminal. The command handles the save without opening another app and working through its save dialog.

Getting started

Install Python if it is not already available, then run:

pip install clipdrop

For YouTube transcript support, install the optional dependency:

pip install 'clipdrop[youtube]'

To test the installation, copy any text and run:

clipdrop test

This creates a test.txt file in your current directory containing the copied text.

Basic commands

Save clipboard content

To save clipboard content, give the command a filename:

clipdrop notes          # Creates notes.txt (or .md, .json - it figures it out)
clipdrop report.pdf     # Creates a PDF
clipdrop screenshot.png # After taking a screenshot

Append to a document

Use append mode to collect notes or research in one file:

clipdrop journal.md -a

Each run adds the clipboard content with a separator. I use this for meeting notes: copy a point I want to keep, run clipdrop meeting.md -a, and continue taking notes.

Preview before saving

Preview the clipboard content before saving:

clipdrop something.txt -p

This shows what the command would save, which helps when you are unsure what you last copied.

Detection, transcripts, and summaries

Format detection

ClipDrop inspects the clipboard to suggest a format. For JSON, clipdrop data saves as data.json. Markdown with headers and lists can be detected as .md.

Detection can be wrong. Plain text is the fallback; specify an extension when you need a particular format.

Audio transcription

On macOS 26.0 or later, ClipDrop can transcribe audio files using Apple Intelligence. Record something on your iPhone, AirDrop it to your Mac, copy the file, then:

clipdrop

It automatically detects it's audio and creates a transcript with timestamps. The project documents this transcription as running on-device.

To save plain text instead of SRT subtitles:

clipdrop notes.txt

Transcription streams in real time. Words appear as it processes.

YouTube transcripts

To download an available YouTube transcript, copy the video URL, then run:

clipdrop -yt

This downloads a transcript from YouTube and requires a network connection. You can request a language:

clipdrop -yt lecture.md --lang es  # Spanish

Use the saved transcript for research or tutorial notes. Availability depends on the video and requested language.

On-Device summaries

On macOS 26.0 or later, the --summarize flag runs Apple Intelligence locally to compress long content:

clipdrop notes.md --summarize

Hierarchical processing handles long inputs (full meeting transcripts, long articles) by chunking and re-summarizing. The summarization runs on-device.

Use it as a fast first pass before you edit. The output is a starting point, not a final draft.

Secret scanning

I once almost saved an AWS key to a shared folder. That prompted me to add secret scanning:

clipdrop config.env -s

The -s flag scans for:

• AWS credentials
• Recognized API-key patterns, including OpenAI and Stripe
• GitHub tokens
• Private keys
• Other patterns that resemble secrets

If it finds something, it asks what you want to do. You can redact the secrets, skip saving, or save anyway if you know what you're doing.

clipdrop keys.txt --scan-mode redact  # Auto-replaces secrets with [REDACTED]

It has caught secrets I would otherwise have saved. It can still miss credentials, so review sensitive content before sharing it.

Example workflows

For developers

Save stack traces, API responses, and code snippets as you debug:

# Copy error message
clipdrop debug.log -a
 
# Copy API response
clipdrop response.json
 
# Building a snippets file
clipdrop snippets.py -a

Add an append alias to your .zshrc:

alias cda='clipdrop -a'  # Use: cda debug.log

For PMs and designers

Save screenshots with filenames that describe what they show:

# Take screenshot with CMD+CTRL+SHIFT+4
clipdrop feature-x.png
 
# Building a visual changelog
clipdrop changelog/v2.1.png

For competitive research, copy images from websites and save them with meaningful names.

For writers and researchers

I use append mode to collect research and build drafts:

# Find interesting paragraph, copy it
clipdrop research.md -a
 
# YouTube video with good info
clipdrop -yt sources.md -a
 
# Building an article over time
clipdrop draft.md -a

Append mode adds separators in Markdown files, keeping the clips distinct as you collect them.

The daily journal pattern

For a daily journal:

# Morning
echo "$(date): Starting the day" | pbcopy && clipdrop journal.md -a
 
# Throughout the day
clipdrop journal.md -a
 
# End of day
clipdrop journal.md -a

The first command adds a dated opening entry. The later commands append whatever you have copied.

Other supported formats

Mixed content

If your clipboard contains both text and an image, you can save both to PDF or select one:

clipdrop report.pdf  # Creates PDF with both
clipdrop --text-only notes.txt  # Just the text
clipdrop --image-only screenshot.png  # Just the image

Format conversion

Specify the extension to request a supported conversion:

# Clipboard has JSON, but you want YAML
clipdrop config.yaml
 
# Markdown to plain text
clipdrop readme.txt

Check the saved file when converting between formats.

Large files

Size limits can affect saving and secret scanning. Do not assume a successful scan means every part of a large file was checked; review sensitive files before sharing them.

Platform requirements and limitations

The project documents these requirements:

• Basic features: macOS 10.15 or later.
• Audio transcription and on-device summaries: Needs macOS 26.0 or later with Apple Intelligence.
• YouTube transcripts: Works on any supported macOS. Needs the extra install: pip install 'clipdrop[youtube]'
• Windows: Not supported.
• Linux: Not supported.

Common issues and fixes

"No content in clipboard" - Copy the content again and retry.

"Cannot append to PDF" - PDFs aren't text files. Append only works with text-based formats.

"File exists" - Use -f to force overwrite or -a to append. Or pick a different name.

Audio transcription not working - Check your macOS version. Needs 26.0 or later. Also make sure you're copying the actual audio file from Finder, not just its name.

YouTube transcript fails - Some videos don't have transcripts. Also check you installed with [youtube] option.

Quick command reference

# Basics
clipdrop filename         # Save clipboard
clipdrop filename -a      # Append to file
clipdrop filename -p      # Preview first
clipdrop filename -f      # Force overwrite
 
# Sources
clipdrop -yt             # YouTube transcript
clipdrop --audio         # Force audio mode
 
# AI features (macOS 26.0+)
clipdrop --summarize     # On-device summary
 
# Security
clipdrop -s              # Scan for secrets
clipdrop --scan-mode redact  # Auto-redact secrets
 
# Filters
clipdrop --text-only     # Ignore images
clipdrop --image-only    # Ignore text
 
# Other
clipdrop --lang es       # Language for transcripts
clipdrop --version       # Version info
clipdrop --help          # Show help

Why it works this way

Command line. The command takes a filename and saves the clipboard without a separate editor or save dialog.

Python with native bridges. Python handles the command and clipboard libraries. Swift provides native macOS access for audio and Apple Intelligence.

Local processing. Clipboard processing and the AI features described here run on-device. YouTube transcript downloads use the network, and optional remote-image fetching for PDFs also makes network requests.

Local files. ClipDrop does not provide cloud sync or team sharing.

Tips from daily use

These are the habits I use:

1. Make an append alias. Use alias cda='clipdrop -a' to shorten repeated commands.

2. Use append mode for everything ongoing. Meeting notes, daily tasks, research. Just keep appending. You can clean it up later.

3. Name files when you save them. Choose a descriptive name instead of temp.

4. Preview when unsure. Use -p to check what you last copied.

5. Scan sensitive files. Use -s when content might contain secrets, then review the result.

6. Save YouTube transcripts for research. Append relevant transcripts to your research file.

What's next

The roadmap I outlined for ClipDrop includes:

• Windows support
• Linux support
• Browser extension (for web clipping)
• Better code-language detection

Other possibilities include:

• Smart folders based on content type
• Git integration for version-controlled notes
• Plugin system so people can add their own processors

These are plans, not available features or delivery commitments. The repository and usage guide document the current commands.

ClipDrop is open source. You can report bugs and suggest features in the repository.