ClipDexter - Clipboard Management with Python Scripts

ClipDexter is a powerful desktop application built with Jetpack Compose that transforms your clipboard into a programmable text processing powerhouse. Write Python scripts to manipulate clipboard content instantly - perfect for developers, content creators, and power users who need quick text transformations.

🎯 Core Concept

Copy → Process → Paste - That's it! Copy any text to your clipboard, run a Python script on it, and get the processed result instantly copied back to your clipboard. No more switching between applications or manually processing text.

Features

🐍 Python-Powered Clipboard Processing

• 20 Pre-built Python Scripts for common text processing tasks
• Custom Script Editor - Write, edit, and save your own Python scripts
• Instant Execution - Run Python code directly on clipboard content
• Persistent Storage - All your custom scripts saved locally

📋 Available Scripts

Text Transformation

• Convert to Uppercase - Transform text to uppercase
• Convert to Lowercase - Transform text to lowercase
• Capitalize Each Word - Capitalize first letter of each word
• Trim Extra Whitespace - Remove extra spaces and normalize whitespace
• Remove All Line Breaks - Convert multi-line text to single line
• Convert Tabs to Spaces - Replace tab characters with spaces

Data Extraction

• Extract First URL - Find the first URL in text
• Extract All URLs - Find all URLs in text
• Extract All Email Addresses - Find all email addresses
• Extract All Numbers - Find all numbers (integers and decimals)

JSON & CSV Processing

• Convert CSV to JSON - Transform CSV data to JSON format
• Pretty-print JSON - Format JSON with proper indentation
• Minify JSON - Remove all whitespace from JSON

Encoding & Decoding

• Encode to Base64 - Encode text to base64
• Decode from Base64 - Decode base64 text

Analysis & Counting

• Count Words and Characters - Provide character, word, and line counts

HTML Processing

• Remove All HTML Tags - Strip HTML tags from text
• Escape for HTML - Escape special characters for HTML

Text Organization

• Sort Lines Alphabetically - Sort lines in alphabetical order
• Deduplicate Lines - Remove duplicate lines while preserving order

🎨 Modern Jetpack Compose UI

• Material 3 Design - Beautiful and intuitive interface
• Real-time Script Editor - Edit Python code with syntax highlighting
• Instant Feedback - See results immediately after execution
• Responsive Layout - Adapts to different screen sizes

🚀 Quick Start

Prerequisites

• Java 11+ - Required for Kotlin Multiplatform
• Python 3 - Required for executing Python scripts
• Gradle - Build system (included in project)

Running the Application

1. Clone the repository:

   git clone <repository-url>
   cd ClipDexter

2. Run the application:

   ./gradlew run

3. First-time setup:

   • The application will automatically create the data store on first run
   • Initial scripts will be loaded into ~/.clipdexter/utilities.json

📖 Usage

Running Scripts

1. Copy text to clipboard that you want to process
2. Open ClipDexter and browse the list of scripts
3. Click "Run" on any script to process your clipboard content
4. Result is automatically copied back to your clipboard

Writing Custom Scripts

1. Click "Edit" on any script in the list
2. Modify the Python code in the editor
3. Click "Save Changes" to update the script
4. Changes are persisted to the data store

Python Scripting Guide

📚 Complete Python Scripting Guide - Learn how to write effective Python scripts for clipboard processing, including:

• Using the $clip variable to access clipboard content
• Common patterns and best practices
• Data processing examples
• Error handling techniques
• Advanced scripting techniques

🔧 Development

Project Structure

composeApp/src/jvmMain/kotlin/dev/pinaki/clipdexter/
├── App.kt                           # Main application entry point
├── PyUtilitiesRepository.kt         # Repository for managing Python scripts
├── PythonExecutor.kt               # Python script execution engine
├── ClipboardUtil.kt                # Clipboard operations
├── di/
│   └── AppModule.kt                # Dependency injection setup
├── navigation/
│   └── Navigation.kt               # Screen navigation
├── services/
│   └── PythonUtilitiesDataStore.kt # Data persistence layer
├── ui/screens/
│   ├── ListScreen.kt               # Scripts list view
│   └── DetailScreen.kt             # Python script editor
└── viewmodels/
    └── UtilitiesViewModel.kt       # UI state management

Key Technologies

• Jetpack Compose - Modern declarative UI framework
• Kotlin Multiplatform - Cross-platform development
• Python Integration - Execute Python scripts on clipboard data
• Koin - Dependency injection
• Kotlinx Serialization - JSON serialization
• Kotlinx Coroutines - Asynchronous programming

Adding New Scripts

1. Edit PyUtilitiesRepository.kt
2. Add script to getInitialUtilities() map
3. Provide unique ID and Python code
4. Update getUtilityName() method with display name

Building for Distribution

# Build for macOS
./gradlew packageDmg

# Build for Windows
./gradlew packageMsi

# Build for Linux
./gradlew packageDeb

🧪 Testing

# Run all tests
./gradlew test

# Run JVM tests only
./gradlew jvmTest

# Run with verbose output
./gradlew test --console=verbose

⚙️ Configuration

Python Path

The application uses python3 command. If your system uses a different command, update PythonExecutor.kt:

val processBuilder = ProcessBuilder("python3", tempFile.absolutePath)

Data Store Location

To change the data store location, modify PythonUtilitiesDataStore.kt:

private val dataFile = File(System.getProperty("user.home"), ".clipdexter/utilities.json")

🔍 Troubleshooting

Common Issues

1. Python not found: Ensure Python 3 is installed and accessible via python3 command
2. Permission errors: Check write permissions for ~/.clipdexter/ directory
3. Build failures: Ensure Java 11+ is installed and JAVA_HOME is set correctly

Debug Mode

Run with debug logging:

./gradlew run --debug

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Transform your clipboard into a programmable tool with Python and Jetpack Compose! 🐍✨