README.md

Pika

Pika (pronounced pi·kuh, like picker) is an easy to use, open-source, native colour picker for macOS. Pika makes it easy to quickly find colours onscreen, in the format you need, so you can get on with being a speedy, successful designer.

Download the latest version of the app at:
superhighfives.com/pika

Or you can install it with Homebrew:

brew install --cask pika

Learn more about the motivations behind the project, and the product vision.

---

Requirements

OS

• macOS Catalina (Version 10.15+) and newer

Keyboard Shortcuts

As of version 0.0.17, Pika supports the following keyboard shortcuts:

Pick colors

• ⌘ D: Pick foreground
• ⌘ ⇧ D: Pick background

Copy colors

• ⌘ C: Copy foreground
• ⌘ ⇧ C: Copy background

Change formats

• ⌘ 1: Format Hex
• ⌘ 2: Format RGB
• ⌘ 3: Format HSB
• ⌘ 4: Format HSL

Change colors

• ⌘ Z: Undo last pick
• ⌘ ⇧ Z: Redo last pick
• X: Swap colors

URL Triggers

As of version 0.0.17, you can trigger Pika using the pika:// URL scheme.

You can also change the format by appending it to the URL when picking or copying. For example, pika://pick/foreground/hex (or rgb, hsl, hsb).

Pick colors

• Pick foreground:
  • pika://pick/foreground
• Pick background:
  • pika://pick/background
• Pick colour with specific format:
  • pika://pick/foreground/hex (or rgb, hsl, hsb)
  • pika://pick/background/hex (or rgb, hsl, hsb)

Copy colors

• Copy foreground:
  • pika://copy/foreground
• Copy background:
  • pika://copy/background
• Copy colour with specific format:
  • pika://copy/foreground/hex (or rgb, hsl, hsb)
  • pika://copy/background/hex (or rgb, hsl, hsb)
• Copy text
  • pika://copy/text
• Copy JSON
  • pika://copy/json

Change formats

• Format Hex
  • pika://format/hex
• Format RGB
  • pika://format/rgb
• Format HSB
  • pika://format/hsb
• Format HSL
  • pika://format/hsl

Change colors

• Undo last pick
  • pika://undo
• Redo last pick
  • pika://redo
• Swap colors
  • pika://swap

Development

• Xcode 12.3
• Swift Package Manager
• Mint

Getting started with contributing

Make sure you have mint installed, and bootstrap the toolchain dependencies:

brew install mint
mint bootstrap

Open Pika.xcodeproj and to run the project. Sparkle requires that you have a team and signing profile set for the project, or it will crash with a dyld / signal SIGABRT error.

If you run into any problems, please detail them in an issue.

Contributions

Any and all contributions are welcomed. Check for open issues, look through the project roadmap, and submit a PR.

Dependencies and thanks

• Sparkle software update framework
• Defaults
• Keyboard Shortcuts
• Launch At Login
• NSWindow+Fade
• Sweetercolor colour extension library for Swift (slightly tweaked for NSColor, rather than UIColor)
• Color names
• Metal shader code in part thanks to Smiley

And a huge thank you to Stormnoid for the incredible 2D vector field visualisation on Shadertoy.