Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/superhighfives/pika
An open-source colour picker app for macOS
https://github.com/superhighfives/pika
app macos swift swiftui xcode
Last synced: 5 days ago
JSON representation
An open-source colour picker app for macOS
- Host: GitHub
- URL: https://github.com/superhighfives/pika
- Owner: superhighfives
- License: mit
- Created: 2020-12-29T12:42:47.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-12-21T05:17:17.000Z (about 1 month ago)
- Last Synced: 2025-01-09T17:33:47.425Z (12 days ago)
- Topics: app, macos, swift, swiftui, xcode
- Language: Swift
- Homepage: https://superhighfives.com/pika
- Size: 2.38 MB
- Stars: 1,853
- Watchers: 6
- Forks: 61
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- open-source-mac-os-apps - Pika - Is an easy to use, open-source, native colour picker for macOS. ![swift_icon] ![metal_icon] (Applications / Utilities)
- open-source-mac-os-apps - Pika - Is an easy to use, open-source, native colour picker for macOS. ![swift_icon] ![metal_icon] (Applications / Utilities)
README
# 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](https://superhighfives.com/pika)**
Or you can install it with Homebrew:
```bash
brew install --cask pika
```
Learn more about the [motivations behind the project](https://medium.com/superhighfives/introducing-pika-d7725c397585), and the [product vision](https://github.com/superhighfives/pika/wiki).
---
## Requirements
### OS
- macOS Catalina (Version 10.15+) and newer
## Keyboard Shortcuts
As of version `0.0.18`, Pika supports the following keyboard shortcuts:
### Pick colors
- ⌘ D: Pick foreground
- ⌘ ⇧ D: Pick background
### Copy colors
- ⌘ C: Copy foreground
- ⌘ ⇧ C: Copy background
### Use the system colour picker
- ⌘ S: Use for foreground
- ⌘ ⇧ S: Use for 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)
- Use the system color picker for forground:
- `pika://system/foreground`
- Use the system color picker for background:
- `pika://system/background`
### 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](https://developer.apple.com/xcode/) 12.3
- Swift Package Manager
- [Mint](https://github.com/yonaskolb/Mint)
## Getting started with contributing
Make sure you have [mint](https://github.com/yonaskolb/Mint) installed, and bootstrap the toolchain dependencies:
```
brew install mint
mint bootstrap
```
Open `Pika.xcodeproj` and to run the project. [Sparkle](https://github.com/sparkle-project/Sparkle) requires that you have a [team and signing profile set](https://github.com/MonitorControl/MonitorControl/discussions/638) 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](https://github.com/superhighfives/pika/issues/new/).
## Contributions
Any and all contributions are welcomed. Check for [open issues](https://github.com/superhighfives/pika/issues), look through the [project roadmap](https://github.com/superhighfives/pika/projects/1), and [submit a PR](https://github.com/superhighfives/pika/compare).
## Dependencies and thanks
- [Sparkle](https://github.com/sparkle-project/Sparkle) software update framework
- [Defaults](https://github.com/sindresorhus/Defaults)
- [Keyboard Shortcuts](https://github.com/sindresorhus/KeyboardShortcuts)
- [Launch At Login](https://github.com/sindresorhus/LaunchAtLogin)
- [NSWindow+Fade](https://gist.github.com/BenLeggiero/1ec89e5979bf88ca13e2393fdab15ecc)
- [Sweetercolor](https://github.com/jathu/sweetercolor) colour extension library for Swift (slightly tweaked for NSColor, rather than UIColor)
- [Color names](https://github.com/meodai/color-names)
- Metal shader code in part thanks to [Smiley](https://github.com/aslr/Smiley)
And a huge thank you to [Stormnoid](https://twitter.com/stormoid) for the incredible [2D vector field visualisation](https://www.shadertoy.com/view/4tfSRj) on Shadertoy.