An open API service indexing awesome lists of open source software.

https://github.com/colorcop/colorcop

a multi-purpose color picker for Windows
https://github.com/colorcop/colorcop

colorpicker cpp cpplint github-actions inno-setup mfc visual-studio win32 windows-application

Last synced: about 2 months ago
JSON representation

a multi-purpose color picker for Windows

Awesome Lists containing this project

README

          

# ColorCop

A Windows-based color picker utility built with Microsoft Foundation Classes (MFC).

## Features

- System tray color picker for Windows
- Real-time color sampling from anywhere on screen
- Multiple color format support (RGB, HEX, HSV)

## Requirements

- **Windows 10/11** (x86/x64)
- **Visual Studio 2022** with the following components:
- MSVC v143 compiler toolset
- Windows 10/11 SDK
- MFC for latest v143 build tools (x86 & x64)

## Building

### Quick Build

```bash
build.bat
```

### Manual Build

```bash
# Using MSBuild directly
MSBuild.exe ColorCop.sln /p:Configuration=Release /p:Platform=Win32

# Or open in Visual Studio 2022
start ColorCop.sln
```

### Build Configurations

- **Debug**: Development build with debugging symbols
- **Release**: Optimized production build

## Installation

1. Build the project using the steps above
2. Run `ColorCop.exe` from the `Release/` directory
3. The application will appear in your system tray

## Release Workflow

ColorCop uses Git tags to trigger automated GitHub releases and publish compiled binaries.

### Listing existing tags

```bash
git tag --list
```

## Development

### Project Structure

- `ColorCop.cpp/h` - Main application class
- `ColorCopDlg.cpp/h` - Main dialog implementation
- `SystemTray.cpp/h` - System tray functionality
- `colorspace.cpp/h` - Color conversion utilities
- `Res/` - Application resources and icons

## Code Linting

This project uses `[cpplint](https://github.com/cpplint/cpplint)` to enforce C++ style guidelines.

**Install:**
```bash
pip install cpplint
```

**Run linting:**
```bash
./lint.sh
```

### Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly on Windows 10/11
5. Submit a pull request

## License

See [LICENSE.TXT](LICENSE.TXT) for details.

## Troubleshooting

**Build Errors:**

- Ensure MFC components are installed in Visual Studio 2022
- Verify Windows SDK is installed
- Check that platform toolset is set to v143

**Runtime Issues:**

- Install Visual C++ Redistributable for Visual Studio 2022