Metadata-Version: 2.4
Name: dbbasic-copypaste
Version: 0.1.0
Summary: Clipboard manager with history for macOS
Author: askrobots
License: MIT
Project-URL: Homepage, https://github.com/askrobots/dbbasic-copypaste
Project-URL: Repository, https://github.com/askrobots/dbbasic-copypaste
Project-URL: Issues, https://github.com/askrobots/dbbasic-copypaste/issues
Keywords: clipboard,manager,history,macos,tool
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pillow>=10.0.0
Requires-Dist: PyQt5>=5.15.0
Dynamic: license-file

# dbbasic-copypaste

A clipboard manager with history for macOS. View your current clipboard, browse through clipboard history, and restore previous items.

![Screenshot](screenshot.png)

## Features

- **Real-time monitoring** - Automatically tracks clipboard changes
- **Text and image support** - Handles both text and image clipboard content
- **History browsing** - View up to 100 previous clipboard items
- **Easy restoration** - Click to restore any previous item to your clipboard
- **Preview** - See full content before restoring
- **Pause/Resume** - Control when monitoring is active
- **Clean interface** - Simple, easy-to-use PyQt5 interface

## Installation

### From source

```bash
# Clone or navigate to the repository
cd dbbasic-copypaste

# Install dependencies
pip install -r requirements-qt.txt

# Install the package
pip install -e .
```

## Usage

Run the application:

```bash
dbbasic-copypaste
```

Or run directly with Python:

```bash
python -m dbbasic_copypaste
```

### Controls

- **History List** - Shows your clipboard history with timestamps
- **Preview** - Displays the full content of the selected item
- **Restore to Clipboard** - Copies the selected item back to your clipboard
- **Delete Item** - Removes the selected item from history
- **Pause/Resume Monitoring** - Temporarily stop tracking clipboard changes
- **Clear History** - Removes all items from history

## How it works

The app monitors your system clipboard every 500ms for changes. When new content is copied:
- Text content is stored and displayed in the preview pane
- Images are captured and shown as thumbnails
- Items are added to the history list with timestamps

Click any item in the history to preview it, then use "Restore to Clipboard" to copy it back.

## Requirements

- Python 3.7+
- PyQt5 >= 5.15.0
- Pillow >= 10.0.0
- macOS (tested on macOS, may work on other platforms)

## License

MIT License - see LICENSE file for details

## Author

askrobots
