Clipboard Manager (cb)

Description

A versatile command-line utility for copying file contents, directory contents, or STDIN input to the system clipboard. Supports both text and image files, with special features for Discord formatting and debug output.

Features

• Copy text from files to clipboard
• Copy text from STDIN to clipboard
• Copy contents of all files in a directory
• Copy images to clipboard
• Include headers with filenames
• Format output for Discord
• Verbose output option
• Debug mode

Requirements

• Python 3.x
• pyperclip
• PIL (for image support)
• xclip or xsel (Linux only)

Installation

1. Install package with pipx:

pipx install .

Uninstall

pipx uninstall copybuffer)

2. For Linux systems, install clipboard handlers:

sudo apt-get install xclip
# or
sudo apt-get install xsel

Usage

Basic Usage

# Copy file contents
cb filename.txt

# Copy from STDIN
echo "hello" | cb

# Copy directory contents
cb -d directory/

# Copy with Discord formatting
cb -a filename.txt

# Copy with headers
cb -i filename.txt

Options

• file: File to copy (optional - reads from STDIN if not provided)
• -i, --include-header: Include filename as header in copied text
• -d, --directory: Copy contents of all files in directory
• -v, --verbose: Display the copied contents
• -a, --attachment: Format output as Discord attachment
• --debug: Enable debug mode
• --version: Display application version

Image Support

Supports copying image files directly to clipboard:

• PNG
• JPG/JPEG
• BMP
• GIF (first frame)

cb image.png

Directory Mode

Copy contents of all text files in a directory:

cb -d /path/to/directory

• Automatically skips image files
• Optionally includes headers with -i flag
• Can format as Discord attachments with -a flag

Debug Mode

Enable detailed output for troubleshooting:

cb --debug filename.txt

Version Information

# Display version information
cb --version
# Output: cb.py version v1.5

Error Handling

The script provides clear error messages for common issues:

• Missing dependencies
• File not found
• Permission errors
• Invalid file types
• Directory access errors

Examples

Copy with Headers

cb -i document.txt
# Output includes: === document.txt ===

Discord Formatting

cb -a code.py
# Output format: [Attached file: code.py\nContent:\n```\n...\n```\n]

Verbose Directory Copy

cb -d -v -i /path/to/docs
# Shows all processed files and copied content

Troubleshooting

If you encounter issues:

1. Check dependencies with --debug flag
2. Verify clipboard system access
3. Check file permissions
4. Ensure proper Python version

License

This project is open source and available under the MIT License.

Contact

For issues or suggestions: [email protected]