Files
2025-10-02 09:50:39 +02:00

174 lines
4.5 KiB
Markdown

<p align="center">
<a href="https://colorpicker.fr">
<img src="build/icon.png" width="256" height="256" alt="ColorPicker icon" />
</a>
<h1 align="center">Colorpicker</h1>
<p align="center">Modern and powerful color management software</p>
<p align="center">
<img src="https://badgen.net/github/release/toinane/colorpicker/stable" />
<img src="https://img.shields.io/github/downloads/toinane/colorpicker/total.svg">
<img src="https://img.shields.io/github/downloads/toinane/colorpicker/latest/total.svg">
<img src="https://img.shields.io/github/release-date/Toinane/colorpicker.svg">
<img src="https://github.com/Toinane/colorpicker/actions/workflows/package.yaml/badge.svg">
<a href="https://snapcraft.io/colorpicker-app">
<img alt="colorpicker-app" src="https://snapcraft.io/colorpicker-app/badge.svg" />
</a>
<a href="https://crowdin.com/project/colorpicker">
<img src="https://badges.crowdin.net/colorpicker/localized.svg">
</a>
</p>
</p>
---
<h4 align="center">
Want to help with the localization of Colorpicker?
</h4>
<p align="center">
Please connect to <a href="https://crowdin.com/project/colorpicker" target="_blank">Crowdin and join the project</a>, your contribution is highly appreciated! 👍
</p>
---
Colorpicker is a desktop tool with _Electron_ to get and save colors code quickly for _OSX_, _Windows_ and _Linux_!
<p align="center">
<img src=".github/screenshots/colorpicker.png"
alt="ColorPicker App" />
</p>
Colorpicker's menu come with a lot of cool features :
- [Pin](#pin): pin Colorpicker to the foreground;
- [Picker](#picker): open an eyedropper who can pick a color from your desktop;
- [Colorsbook](#colorsbook): open Colorsbook, a color manager;
- [Shading](#shading): show three bar of shading — hue bar, natural bar and lightness bar;
- [Clean Vue](#clean-vue): unshow menu, ranges and inputs;
- [Magic color](#magic-color): show colors from the clipboard;
- [Random](#random): show a random color;
- [Settings](#settings): open the preferences panel.
## Pin
![Pin screenshot](.github/screenshots/pin.png)
With Pin, you can bring Colorpicker to the foreground. This makes it convenient to work quickly with different
applications at the same time.
---
## Picker
![Picker screenshot](.github/screenshots/picker.png)
The Picker allows you to quickly retrieve a color anywhere on the screen. Whether it's on your browser, Photoshop, or
whatever.
---
## Colorsbook
![Colorsbook screenshot](.github/screenshots/colorsbook.png)
Colorsbook is a full-fledged application. It allows you to store your colors, categorize them, and easily retrieve them.
It is destined to mature over time.
**Cool tip:** you can save color from colorpicker with `CMD+S` or `CTRL+S`!
---
## Shading
![Tint screenshot](.github/screenshots/tint.png)
With the shades, you can find the perfect color you need. You have a chromatic bar, a natural color bar and a shadow
bar.
---
## Focus Mode
![Focus screenshot](.github/screenshots/focus.png)
Need to compare a color or clean up the interface? This feature is for you, this will hide the sliders and make the menu
more transparent.
---
## Magic Color [WIP]
This functionality is still under development. Currently, it allows you to display the first color that is in your
clipboard. This works with hexadecimal and RGB codes
---
## Random
A traditional feature, it allows you to display a color randomly.
---
## Settings
![Settings screenshot](.github/screenshots/settings.png)
The settings menu allows you to customize your Colorpicker, I let you discover it yourself :)!
# Download
- You can download [on GitHub releases here.](https://github.com/Toinane/colorpicker/releases)
## Want to support me?
You can [buy me a coffee here](https://toinane.itch.io/colorpicker)! Thank you!
#### **_Happy Design !_**
# Development
### Prerequisites
#### Windows
You'll need to install Visual Studio Installer and install Development with C++ module.
Install latest Python version.
#### MacOS
You'll need the latest Xcode Command Line Tools installed.
Install latest Python version.
#### Linux
Install libxtst-dev libpng++-dev package:
`apt-get install libxtst-dev libpng++-dev`
Install latest Python version if already installed.
### How to compile
1. Install dependencies:
```shell
npm install
```
2. Rebuild C/C++ modules to the correct Electron version:
```shell
npm run rebuild
```
3. Launch Colorpicker in development mode:
```shell
npm start
```
4. To build a new version:
```shell
npm run release
```