Clipboard Monitor - CustomTkinter Edition

A modern clipboard monitoring application with a beautiful UI built with CustomTkinter.

Features

• Real-time clipboard monitoring
• Text-to-speech readback with stop capability
• Code snippet filtering
• Markdown normalization
• Modern UI with dark/light mode support
• Volume and speed controls for TTS
• System tray integration

Requirements

• Python 3.7+
• Dependencies listed in requirements.txt

Setup with uv

1. Create a virtual environment using uv:

uv venv

2. Activate the virtual environment:

# On Windows
.venv\Scripts\activate

3. Install dependencies with uv:

uv pip install -r requirements.txt

4. Run the application:

python src/main.py

Traditional Setup (pip)

1. Create a virtual environment (optional but recommended):

python -m venv venv
venv\Scripts\activate  # On Windows

2. Install dependencies:

pip install -r requirements.txt

3. Run the application:

python src/main.py

Usage

• The app runs in the background, monitoring your clipboard
• When something is copied, a modern popup appears with processing options
• Select an option to process and read back the clipboard content
• Use the stop button to immediately stop text-to-speech playback
• Adjust speech rate and volume using sliders
• Toggle between light and dark mode
• The system tray icon provides access to additional controls

Customization

• Edit text_processors.py to add new text processing methods
• Modify ui/app.py to change the UI layout
• Configure TTS settings in tts_engine.py