A powerful Python script that scans directories and copies files with specified extensions to your clipboard in a well-formatted Markdown structure. Perfect for sharing code with LLMs, code reviews, or documentation.

🎉 What's New in v2.1.0:

• One-Command Setup: Run setup.bat (Windows) or ./setup.sh (Unix) to automatically install Python, configure PATH, and install dependencies!
• Zero Configuration: No manual Python installation or PATH editing needed
• All Platforms: Windows, macOS, and Linux support with platform-specific installers

• 📁 Smart Extension Filtering: Specify extensions in the filename itself (e.g., copy.cs.md.py.py)
• 🚫 Folder Exclusion: Exclude specific folders from scanning (e.g., node_modules, dist)
• 🎯 One-Command Setup: Automatic installation scripts for all platforms
• 🌳 Recursive Scanning: Automatically scans subdirectories
• 📊 Detailed Statistics: Shows file count, size, and estimated LLM tokens
• 🎨 Syntax Highlighting: Outputs Markdown with proper language tags
• 🔍 Auto-ignore: Skips common junk folders (.git, node_modules, etc.)
• 🖥️ Cross-Platform: Works on Windows, macOS, and Linux

Windows:

# Download the repository and run:
setup.bat

This will automatically:

• ✅ Download and install Python if needed
• ✅ Add Python to PATH
• ✅ Install pyperclip
• ✅ Verify everything works
• ✅ Run Type Copy

Windows (PowerShell):

# Run as Administrator for best results
.\setup.ps1

macOS/Linux:

# Make executable and run:
chmod +x setup.sh
./setup.sh

1. Install Python (3.7 or higher)

   • Windows: Download from python.org
   • macOS: brew install python3 or download from python.org
   • Linux: Usually pre-installed, or sudo apt install python3

2. Install dependencies:

   pip install pyperclip

3. Download the script:

   • Copy copy.cs.md.py.py to any folder you want to scan

The extensions you want to copy are specified in the filename itself:

copy.cs.md.py.py → Copies .cs, .md, .py files
copy.js.ts.json.py → Copies .js, .ts, .json files
copy.html.css.py → Copies .html, .css files

Simply run the script:

python copy.cs.md.py.py

Exclude specific folders:

python copy.cs.md.py.py --exclude test
python copy.cs.md.py.py --exclude node_modules --exclude dist
python copy.cs.md.py.py -e test -e docs  # Short flag

Get help:

python copy.cs.md.py.py --help

D:\type_copy\copy.cs.md.py.py
Scanning: D:\type_copy...
Added: README.md
Added: test\dir.test.cs
Added: test\dir.test.md
Added: test\dir.test.py
--------------------------------------------------
✔ Success! Copied to clipboard.
  Files:  4
  Size:   1.67 KB
  Tokens: ~426 (LLM Context)
--------------------------------------------------

Press Enter to close...

With exclusions:

python copy.cs.md.py.py --exclude test
Scanning: D:\type_copy...
Excluding: test
Added: README.md
--------------------------------------------------
✔ Success! Copied to clipboard.
  Files:  1
  Size:   0.85 KB
  Tokens: ~213 (LLM Context)
--------------------------------------------------

• Python 3.7 or higher
• pyperclip library (pip install pyperclip)

Linux: Requires a clipboard utility:

# Ubuntu/Debian
sudo apt install xclip

# Fedora
sudo dnf install xclip

# Arch
sudo pacman -S xclip

macOS: No additional requirements (uses built-in pbcopy)

Windows: No additional requirements (uses built-in clipboard API)

On Windows, you may need to allow Python script execution. If you see an error like "cannot be loaded because running scripts is disabled", follow these steps:

python copy.cs.md.py.py

Open PowerShell as Administrator and run:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

This allows locally created scripts to run. This is safe and recommended by Microsoft.

powershell -ExecutionPolicy Bypass -File copy.cs.md.py.py

For easy access, create a .bat file:

1. Create run_copy.bat in the same folder:

   @echo off
   python copy.cs.md.py.py %*
   pause

2. Double-click run_copy.bat to run

Or with exclusions:

@echo off
python copy.cs.md.py.py --exclude node_modules --exclude dist %*
pause

Run the test suite to verify everything works on your platform:

python test_copy.py

The test suite includes:

• ✅ Basic file collection
• ✅ Folder exclusion (single and multiple)
• ✅ Cross-platform path handling
• ✅ Windows permissions
• ✅ Special characters in paths
• ✅ Edge cases

See TESTING.md for detailed testing guide.

Three setup scripts are provided for easy installation:

Running setup scripts:

# Windows - Double-click or run:
setup.bat

# Windows PowerShell (as Admin):
powershell -ExecutionPolicy Bypass -File setup.ps1

# macOS/Linux:
chmod +x setup.sh && ./setup.sh

All setup scripts will:

1. Check if Python is installed
2. Install Python if missing (with user consent)
3. Add Python to PATH
4. Install required packages (pyperclip)
5. Verify installation
6. Run Type Copy

The script automatically ignores these common folders:

• .git, .vs, .idea (version control & IDEs)
• Library, Temp, obj, Builds (Unity/build artifacts)
• __pycache__, node_modules (Python/Node packages)

• .DS_Store (macOS)
• Thumbs.db (Windows)

The script includes syntax highlighting for 20+ languages including: C#, JavaScript, TypeScript, Python, Java, C/C++, HTML, CSS, SCSS, XML, YAML, JSON, Markdown, Bash, SQL, GLSL/HLSL, and more.

For a quick one-liner without this library:

find . -type f \( -name "*.cs" -o -name "*.md" \) -exec cat {} \; | xclip -selection clipboard

Note: Requires xclip installed

Recording 2024-12-23 021135.mp4

1. For AI/LLM Context: Use the token estimate to stay within context limits
2. Large Projects: Exclude build/dependency folders with --exclude
3. Windows Dev Home: Try with Windows Dev Home for enhanced features
4. Git Integration: Check out git-copy.sh for git-aware copying

Found a bug or want to contribute? Feel free to open an issue or PR!

Free to use and modify for any purpose.

• Quick Reference - Command cheat sheet
• Setup Scripts Guide - Automatic installation details
• Windows Setup Guide - Detailed Windows instructions
• Testing Guide - How to run and write tests
• Changelog - Version history and updates