Metadata-Version: 2.4
Name: quick-colorpicker
Version: 1.0.0
Summary: A professional cross-platform color picking utility
Home-page: https://github.com/Monstertov/quick-colorpicker
Author: Monstertov
Author-email: rob@monstertov.nl
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
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: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: pynput==1.7.6
Requires-Dist: pyautogui==0.9.54
Requires-Dist: Pillow==10.2.0
Requires-Dist: pyperclip>=1.8.2
Requires-Dist: rich>=12.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Python Quick Colorpicker

A professional cross-platform color picking utility that lets you instantly grab colors from anywhere on your screen. Perfect for developers, designers, and digital artists who need quick access to color values.

<img src="https://tov.monster/host/pythoncolorpicker.png?t=20250530" alt="colorpickimg">

## Features

- Pick colors anywhere on screen with Ctrl + F1
- Automatic clipboard copying of color values
- Multiple color formats supported (HEX, RGB, HSL)
- Color history with visual previews
- Cross-platform compatibility (Windows, macOS, Linux)
- Configurable hotkeys
- Beautiful terminal UI with color previews
- Lightweight and fast

## Requirements

- Python 3.x
- Required packages:
  ```bash
  pip install -r requirements.txt
  ```

## Installation

1. Clone the repository:
   ```bash
   git clone https://github.com/Monstertov/quick-colorpicker.git
   cd quick-colorpicker
   ```

2. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

## Usage

Run the script:
```bash
python quick-color.py
```

### Keyboard Shortcuts
- **Ctrl + F1**: Pick color under cursor
- **Ctrl + H**: Show color history
- **Ctrl + C**: Exit application

### Features in Detail

#### Color Formats
Colors are displayed in multiple formats:
- HEX: `#RRGGBB`
- RGB: `rgb(R, G, B)`
- HSL: `hsl(H, S%, L%)`

#### Color History
- Automatically saves your last 10 picked colors
- Displays time of pick and all color formats
- Persists between sessions

#### Clipboard Integration
Colors are automatically copied to your clipboard in your preferred format (configurable in the script)

## ⚙️ Configuration

You can customize the following settings in the script:
```python
config = {
    "hotkey_modifiers": {keyboard.Key.ctrl},
    "hotkey_trigger": keyboard.Key.f1,
    "trigger_type": "keypress",
    "max_history": 10,
    "default_color_format": "hex",  # Options: hex, rgb, hsl
    "auto_copy": True
}
```

## Contributing

Contributions are welcome! Feel free to:
- Report bugs
- Suggest new features
- Submit pull requests

## License

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

---

Created by [Monstertov](https://github.com/Monstertov)
