• Stars
    star
    240
  • Rank 168,181 (Top 4 %)
  • Language
    Swift
  • License
    Apache License 2.0
  • Created over 4 years ago
  • Updated over 1 year ago

Reviews

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

Repository Details

A fresh new color picker, with a gentle, fun, and dead simple user interface.

Alderis Color Picker

Try it yourself: pod try Alderis

Alderis is a fresh new color picker, with a gentle, fun, and dead simple user interface. It aims to incorporate the usual elements of a color picker, in a way that users will find easy and fun to use.

The user can start by selecting a color they like on the initial color palette tab, and either accept it, or refine it using the color wheel and adjustment sliders found on the two other tabs.

Alderis is named for the Alderamin (Alpha) star in the Cepheus (Cephei) constellation. (There is no dependency on the Cephei project.)

Documentation


Click for full-quality MP4

Why do I want this? Isnโ€™t there already a color picker in iOS?

Alderis was originally released before iOS 14 was unveiled with a built-in color picker feature, which seems to be heavily inspired by Alderis. However, rather than throw in the towel here, Iโ€™m considering this an opportunity to continue building what I feel is a better, less cluttered user experience, with more configuration options for apps to fine-tune a color picker UI suitable for each use case and target market.

If this doesnโ€™t seem important to you, the answer is simple: skip Alderis and use UIColorPickerViewController. If it does, read on.

Feature Comparison

Alderis UIKit
Minimal UI โœ”๏ธ โœ–๏ธ
Drag and drop colors within app โœ”๏ธ โœ”๏ธ *
Drag and drop colors across apps โœ”๏ธ โœ–๏ธ
Color grid โœ”๏ธ โœ”๏ธ
Color spectrum/wheel โœ”๏ธ โœ”๏ธ
RGB sliders โœ”๏ธ โœ”๏ธ
HSB sliders โœ”๏ธ โœ–๏ธ
Grayscale slider โœ”๏ธ โœ–๏ธ
Opacity slider โœ”๏ธ โœ”๏ธ
Hex color code support โœ”๏ธ โœ”๏ธ
Color space support (Display P3) โœ–๏ธ โœ”๏ธ
Save favorite colors โœ–๏ธ โœ”๏ธ
Saved colors shared across apps โœ–๏ธ โœ”๏ธ
Grab color from screen (eyedropper) โœ–๏ธ โœ”๏ธ
Customise title label โœ”๏ธ โœ–๏ธ
Customise tab row visibility โœ”๏ธ โœ–๏ธ
Customise visible tabs โœ”๏ธ โœ–๏ธ
Customise initially selected tab โœ”๏ธ โœ–๏ธ
Customise opacity slider visibility โœ”๏ธ โœ”๏ธ
Customise color grid โœ–๏ธ โœ–๏ธ
Interface Builder support โœ–๏ธ โœ–๏ธ
SwiftUI support w/o UIKit bridging โœ–๏ธ โœ–๏ธ
Observe value change with KVO โœ–๏ธ โœ”๏ธ

* UIColorWell supports dragging colors onto it, but not out of it. Alderis supports both directions, which are separately configurable. The default Alderis ColorWell behavior matches UIColorWell. Alderis supports drag and drop on the color picker window; UIKit does not.

Installation

CocoaPods

Add to your Podfile:

pod 'Alderis', '~> 1.2.0'

And then run pod install.

Carthage

Add to your Cartfile:

github 'hbang/Alderis' ~> 1.2.0

And then run carthage update.

Swift Package Manager

  1. Click File โ†’ Swift Packages โ†’ Add Package Dependency.
  2. Enter http://github.com/hbang/Alderis.git.
  3. Specify 1.2 as the version filter.

Or, manually add it to your Package.swift:

dependencies: [
	.package(url: "http://github.com/hbang/Alderis.git", from: "1.2.0")
]

And then run swift package update.

Jailbreak packages

Add ws.hbang.alderis (>= 1.2) to your Depends: list.

Preference Bundles and libcolorpicker Compatibility

Alderis acts as a drop-in replacement for libcolorpicker, an abandoned but still very popular color picker library on jailbroken iOS. Packages can simply change their dependencies list to replace org.thebigboss.libcolorpicker with ws.hbang.alderis (>= 1.2) to switch their color picker to Alderis. No other changes required!

For more information, refer to the docs.

License

Licensed under the Apache License, version 2.0. Refer to LICENSE.md.

Header backdrop photo credit: John-Mark Smith on Unsplash

More Repositories

1

NewTerm

NewTerm is a terminal emulator app with first-class iPhone, iPad, and Mac support.
Swift
453
star
2

libcephei

Useful functions for tweak developers
Objective-C
205
star
3

TermHere

Finder extension for opening a terminal from the current directory
Swift
109
star
4

TypeStatus

iMessage typing and read receipt indicators for the iOS status bar
Logos
73
star
5

iOS-7-CSS

Basic iOS 7 CSS
SCSS
57
star
6

Pheromone

Various tweaks for Cydia
Objective-C
39
star
7

libopener

Developer library for overriding link destinations
Logos
32
star
8

TypeStatus-Mac

The TypeStatus iOS tweak, for OS X
Logos
29
star
9

LinkOpener

Open web pages in their App Store apps.
Objective-C
29
star
10

TypeStatus-Plus

Status bar typing alerts for 3rd-party apps and more!
Logos
26
star
11

StopCrashingPls

Workaround for iOS 13 jetsam crash issue
Logos
16
star
12

UXKit-Headers

Cleaned up headers derived from reverse engineering UXKit.framework
Objective-C
15
star
13

hbhackertools

Command line tools I install after jailbreaking
Makefile
10
star
14

SpringBoard-Dumps

SpringBoard. All the way back to 2.0.
Makefile
10
star
15

MapsOpener

Open map links in the Google Maps app
Logos
10
star
16

DailyPaper

Daily wallpapers courtesy of Bing
Logos
10
star
17

App-Cache-Trigger

Speed up Cydia installations
Makefile
9
star
18

SwitchSpring

Quick system actions from the iOS 7 app switcher.
Logos
9
star
19

BrightVol

Control brightness with volume buttons
Logos
8
star
20

Quanta

Better status bar support for Apple Smart Battery Case
Logos
8
star
21

FlagPaint-2

Tint notifications based on icon color
Logos
8
star
22

homebrew-repo

HASHBANG Productions Homebrew Repository
Ruby
7
star
23

Plugication

Automatically play music when headphones are connected
Objective-C
7
star
24

StoreAlert

Ask before opening iTunes/App Store
Logos
7
star
25

YTOpener

Open YouTube videos in the new App Store app
Python
7
star
26

Cobalia

Toggles in the iOS 8 app switcher
Logos
6
star
27

iterm2-shell-integration

iTerm2 Shell Integration, packaged up for iOS
Shell
6
star
28

GroupQuiet

Intelligent iMessage group chat muting
Logos
5
star
29

NotiQuiet

Hide banner notifications while inside particular apps
Objective-C
5
star
30

ActiContact

Add contacts to your address book from anywhere
Objective-C
5
star
31

Bugger

Access iOSโ€™s built in UI debugger
Logos
5
star
32

InFolder

Create folders-in-folders on iOS 7
C
4
star
33

Aphelion

Objective-C
4
star
34

hbang.github.io

Open source home page
HTML
3
star
35

Clock

OS X menu bar clock
Objective-C
3
star
36

MonoBar

Disable double height status bars
Logos
3
star
37

LockKeyboard

iOS 7.1 lock screen keyboard globally
Logos
3
star
38

NCPad

Resizes notification banners to the full width of the iPad screen.
Logos
3
star
39

Codling

Blurred Cydia loading HUDs
Logos
2
star
40

DeDirect

Block malicious Mail redirects
Logos
2
star
41

Carrox

Velox folder for the CARROT to-do list app
Logos
2
star
42

WritingALetter

Clippit on iOS, because why not?
Objective-C
2
star
43

FolderBlur

Blur wallpaper when opening folders
Logos
2
star
44

debby

Debby - a fat, ugly, DPKG Deb Packager
Java
2
star
45

Fontee

Lighten iOS fonts, like iOS 7 beta 1. Or lighten them even more, in iOS 7.
Logos
1
star
46

FlagPaint

Tint banners based on icon color (iOS 5 and 6)
Objective-C
1
star
47

TotesActivated

Disable all activation errors
Makefile
1
star
48

Canzone

Logos
1
star
49

ScreenFade

Fade in/out screen like iOS 7 on previous versions
Logos
1
star