Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/acheronfail/pixel-picker
A tiny menu bar application that helps you pick colours from your screen! 🔍✨
https://github.com/acheronfail/pixel-picker
color color-picker picker pixel pixel-picker shortcut
Last synced: about 1 month ago
JSON representation
A tiny menu bar application that helps you pick colours from your screen! 🔍✨
- Host: GitHub
- URL: https://github.com/acheronfail/pixel-picker
- Owner: acheronfail
- License: gpl-3.0
- Created: 2018-05-19T14:14:27.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2021-10-20T08:16:19.000Z (about 3 years ago)
- Last Synced: 2024-08-02T13:35:02.552Z (4 months ago)
- Topics: color, color-picker, picker, pixel, pixel-picker, shortcut
- Language: Swift
- Size: 6.91 MB
- Stars: 394
- Watchers: 9
- Forks: 34
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- Mac-Menubar-Megalist - Pixel Picker
README
Pixel Picker is like Digital Color Meter, but lives in your menu bar and lets you get the color of any pixel easily. Just hit your shortcut, up comes a magnifying glass, and away you go!
### Features
* 📸 Pick *any* pixel on your screen with ease
* 🔎 Different magnification levels
* ✏ Multiple color export formats
* 🖥 Multi-monitor support
* 🎨 Supports different color spaces
* ⌨️ Global keyboard shortcut activation
* 🌄 Customisable preview
* 🌓 WCAG contrast level checker
* ✨
## Installation
#### Via Homebrew:
```bash
brew install --cask pixel-picker
```
#### Via GitHub Releases
Simply download the dmg from the [releases](https://github.com/acheronfail/pixel-picker/releases) tab and drag "PixelPicker.app" into your `/Applications` folder.
## Usage
After you've installed Pixel Picker, it will live in your menu bar. You have many different ways of activating the picker:
* Configure a keyboard shortcut in the dropdown menu and press that to activate the picker
* Select the "Pick a Pixel" item in the dropdown menu to activate the picker
* Simply right-click the menu item and the picker will activate
* _Pro-tip:_ Use the H, J, K and L keys to move the picker pixel by pixel
Once you have the picker open, it should be quite straightforward! Move your mouse around the screen and click (or press space on the pixel you want.
You can also hold down the control (⌃) key (this can be changed to another key) while the picker is open, and the picker will enter "Focus Mode". This will zoom the pixel preview even further, and will slow down the picker's movement to make it easier to pick that hard-to-get pixel!
**ProTip:** Remember, you can use the left or right arrow keys to cycle between color formats while the picker is open.
### Options
All of Pixel Picker's options are in its menubar dropdown. Simply click on the menu bar item, and you can configure the picker right there in your menu.
Pixel Picker provides some neat options:
* 🔳 **Show Grid**
* Whether or not to show a grid around the pixels in the picker's preview.
* 🎨 **Color Space**
* Computer screens are complex things, and have various color spaces. You can either leave this setting as its default (it will choose the default color space of your screen) or you can specify a specific color space and Pixel Picker will try and use that instead (compatibility depends on your computer's screen/monitor).
* ✏️ **Color Format**
* How should the color be copied when you select it? Examples include CSS Hex: `#aabbcc`, or Java RGB: `new Color(158, 198, 117)`, etc.
* 🔍 **Magnification**
- How far in should the preview zoom/how big should each pixel be?
* 🧐 **Focus Modifier**
* Choose which modifier activates focus mode. When focus mode is active, the picker zooms even closer in, and your mouse moves slower to help you pick the right pixel.
* 🔢 **Float Precision**
* This controls how many digits will come after the decimal point when using float-based color formats.
* ⌨️ **Picker Shortcut**
* The global keyboard shortcut to use that will activate Pixel Picker.
* 🚀 **Launch at Login**
* If this is enabled then Pixel Picker will be launched when you log into your computer.
* 🌓 **WCAG Constrast Level**
* If enabled, will compare the current and last picked color and show the [WCAG constrast level](https://www.w3.org/TR/WCAG20/): Fail, OK, AA, or AAA.
#### Extra Overrides or Hidden Settings
In some releases Pixel Picker might have some experimental overrides that can be toggled via the Terminal (`defaults write ...`, etc). Look under the "Experimental Overrides" section at `Pixel Picker` -> `About` for more information.
## Questions/Concerns
None yet!
## Developing
#### Setting up the project
Pixel Picker uses `carthage` to manage its dependencies (you can install it with `brew`). To build Pixel Picker on your machine:
```bash
# Clone the repository
git clone [email protected]:acheronfail/pixel-picker && cd pixel-picker
# Install dependencies with carthage
carthage update --platform macos
# Open the project
open "Pixel Picker.xcodeproj"
```
Once you've opened the Xcode project, it should be enough to make your changes and then just hit the build/run button and go from there.
#### Creating a DMG
The process to create build artefacts for this app is extremely simple:
1. Archive a build in Xcode (`Products` -> `Archive`)
2. Export the app
3. Run [`create-dmg`](https://github.com/sindresorhus/create-dmg)
4. 🎉
## License
[GPLv3](./LICENSE)