• Stars
    star
    395
  • Rank 109,040 (Top 3 %)
  • Language
    Swift
  • License
    GNU General Publi...
  • Created over 6 years ago
  • Updated about 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A tiny menu bar application that helps you pick colours from your screen! 🔍✨

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

More Repositories

1

xi-electron

A front-end for the xi-editor built with modern web technologies.
TypeScript
344
star
2

repgrep

An interactive replacer for ripgrep that makes it easy to find and replace across files on the command line.
Rust
256
star
3

apptivator

A macOS menubar app which activates applications via global shorcuts ⌨️
Swift
81
star
4

ia-writer-sublime

A sublime color scheme which aims to match iA Writer as much as possible
15
star
5

k1

Notes for using the Keychron K1 Mechanical RGB keyboard
14
star
6

ColorCode

The Cross-Browser Syntax Highlighter Extension! 🎉
JavaScript
9
star
7

karabinux

An attempt to port (as much as possible) the functionality of https://github.com/tekezo/Karabiner-Elements to Linux.
Rust
6
star
8

i3stat

A lightweight and batteries-included status_command for i3 and sway
Rust
5
star
9

rotp

A simple HOTP and TOTP generator on the command line
Rust
5
star
10

pyatvui

A terminal UI for pyatv
Python
4
star
11

VSCodeColumnSelection

A Sublime Text plugin for creating column selections like VSCode
Python
4
star
12

trrs

A simple command line tool to convert between common encodings
Rust
4
star
13

human_id

Generate human readable identifier strings by chaning common (short) words of the english language.
Rust
4
star
14

easy_collections

Wrappers around standard collections for ease of use and quick prototyping
Rust
3
star
15

ftrace

Easily discover which files/directories a program accesses.
Rust
3
star
16

gash

A little tool to create custom prefixes on every git commit you make!
Rust
2
star
17

aurrs

An experimental wrapper for pacman.
Rust
2
star
18

rttw

Return true to win clone
TypeScript
2
star
19

timeRS

Like GNU time but in Rust! (timeRS) loaded with more features!
Rust
2
star
20

vscode-arithmetic

Perform easy operations on multiple selections like Sublime Text
TypeScript
2
star
21

convert-apple-loops

A simple script that converts the Apple Loops from Garageband from `caf` into `aiff` so other programs (like Ableton) can use them.
Shell
2
star
22

oryx-stats

A simple tool to analyse data about users' layouts from Oryx
TypeScript
2
star
23

aoc

advent of code
Rust
2
star
24

max_rss

Rust
2
star
25

keyboard-music

Rust
1
star
26

travis-rs

Shell
1
star
27

neli-async-hang

Rust
1
star
28

fakeroot

Rust
1
star
29

cydia

https://acheronfail.github.io/cydia/
Objective-C
1
star
30

i3-plasma-integration

An IPC addon for i3 to integrate it better with plasma
Rust
1
star
31

netwatch

Rust
1
star
32

electron-bookmarks

Hacky implementation of MAS security-scoped bookmarks for electron
JavaScript
1
star
33

di

Rust
1
star
34

file-duplicate-finder

Simple script to find duplicate files
JavaScript
1
star
35

count

Just
1
star
36

pulse-stream-segfault

Rust
1
star
37

plasma-pong

Rust
1
star
38

pulse-rs

Rust
1
star
39

makepkg

Docker container to be able to run Arch's `makepkg` on non-Arch distributions
Dockerfile
1
star
40

acpi_call_finder

JavaScript
1
star
41

zero-check

check the percentage of zero bytes in a file
Rust
1
star
42

lgogdownloader-docker

Dockerfile
1
star
43

morrsse

BSD's `morse` but with more `rs`!
Rust
1
star
44

mdbook-dynamic-templates

This is an addon for `mdbook` which adds support for "Dynamic Templates".
JavaScript
1
star
45

acheronfail.github.io

TypeScript
1
star
46

nxkit

TypeScript
1
star
47

float-view

A tool to view rides recorded with Float Control
Svelte
1
star
48

gnome-application-toggle

A simple extension to toggle an application in gnome easily
JavaScript
1
star
49

atv-ui

Simple HTTP server for a gesture-based AppleTV Remote UI
TypeScript
1
star
50

galaga

Rust
1
star
51

kobo

A simple tool which makes using kobopatch and kobopatch-patches much simpler.
Go
1
star
52

bitport

A program to export all of your bitwarden data, including attachments!
TypeScript
1
star
53

c

Rust
1
star
54

vscode-tree

Description to be updated...
TypeScript
1
star
55

templater.js

A super simple file templater
JavaScript
1
star
56

opng

A tiny program to take a screenshot in X11, then convert it to greyscale and pixelate it; use it with other tools for screensaver backgrounds!
Rust
1
star