Skip to content

Latest commit

Β 

History

History
106 lines (74 loc) Β· 4.61 KB

README.md

File metadata and controls

106 lines (74 loc) Β· 4.61 KB

Pixel Picker Banner

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
  • ✨

demo of pixel-picker

Installation

Via Homebrew:

brew install --cask pixel-picker

Via GitHub Releases

Simply download the dmg from the 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: 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:

# 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
  4. πŸŽ‰

License

GPLv3