Metadata-Version: 2.4
Name: quick-colorpicker
Version: 1.0.2
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: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
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

[![PyPI version](https://badge.fury.io/py/quick-colorpicker.svg)](https://badge.fury.io/py/quick-colorpicker)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/quick-colorpicker)](https://pypi.org/project/quick-colorpicker/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/quick-colorpicker)](https://pypi.org/project/quick-colorpicker/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

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=0138" 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

## Installation

### Via pip (Recommended)
```bash
pip install quick-colorpicker
```

### From source
```bash
git clone https://github.com/Monstertov/quick-colorpicker.git
cd quick-colorpicker
pip install -r requirements.txt
python setup.py install
```

## Requirements

- Python 3.6 or higher
- Dependencies are automatically installed with pip:
  - pynput
  - pyautogui
  - Pillow
  - pyperclip
  - rich

## Usage

### Quick Start
After installation, simply run:
```bash
quick-colorpicker
```

### 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)
