• Stars
    star
    1,419
  • Rank 33,151 (Top 0.7 %)
  • Language
    Swift
  • License
    Other
  • Created about 8 years ago
  • Updated over 3 years ago

Reviews

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

Repository Details

๐Ÿ“น Your next favorite image and video picker

Gallery Banner

Version Carthage Compatible License Platform Swift

Description

Gallery Icon

We all love image pickers, don't we? You may already know of ImagePicker, the all in one solution for capturing pictures and selecting images. Well, it has a sibling too, called Gallery. Based on the same engine that powers ImagePicker, Gallery has a clearer flow based on albums and focuses on the use case of selecting video. If this suits your need, give it a try ๐Ÿ˜‰

Gallery has 3 tabs with easy navigation through swipe gesture

  • Images: select albums and images. Handle selection with hightlighted numbers so your users don't forget the order
  • Camera: your photographer skill goes here
  • Videos: display all videos and select. For now the use case is to select one video at a time

And, it has zero dependencies ๐Ÿ˜Ž

Usage

Presenting

GalleryController is the main entry point, just instantiate and give it the delegate

let gallery = GalleryController()
gallery.delegate = self
present(gallery, animated: true, completion: nil)

The content controller is not loaded until the users navigate to, which offers a much faster experience.

Delegate

The GalleryControllerDelegate requires you to implement some delegate methods in order to interact with the picker

func galleryController(_ controller: GalleryController, didSelectImages images: [Image])
func galleryController(_ controller: GalleryController, didSelectVideo video: Video)
func galleryController(_ controller: GalleryController, requestLightbox images: [Image])
func galleryControllerDidCancel(_ controller: GalleryController)

The lightbox delegate method is your chance to display selected images. If you're looking for a nice solution, here is the Lightbox that we use and love

Resolving

The delegate methods give you Image and Video, which are just wrappers around PHAsset. To get the actual asset informations, we offer many convenient methods. See example

Image

  • Use instance method resolve to get the actual UIImage
  • Use static method Image.resolve to resolve a list of images

Video

  • Use instance method fetchDuration, fetchPlayerItem, fetchAVAsset, fetchThumbnail to get more information about the selected video.

Permission

Gallery handles permissions for you. It checks and askes for photo and camera usage permissions at first launch. As of iOS 10, we need to explicitly declare usage descriptions in plist files

<key>NSCameraUsageDescription</key>
<string>This app requires access to camera</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>This app requires access to photo library</string>

Configuration

There are lots of customization points in Config structs. For example

Config.Permission.image = UIImage(named: ImageList.Gallery.cameraIcon)
Config.Font.Text.bold = UIFont(name: FontList.OpenSans.bold, size: 14)!
Config.Camera.recordLocation = true
Config.tabsToShow = [.imageTab, .cameraTab]

Video Editor

Gallery cares more about video with its editing functionalities. We have VideoEditor and AdvancedVideoEditor to trim, resize, scale and define quality of the selected video

func galleryController(_ controller: GalleryController, didSelectVideo video: Video) {
  controller.dismiss(animated: true, completion: nil)

  let editor = VideoEditor()
  editor.edit(video: video) { (editedVideo: Video?, tempPath: URL?) in
    DispatchQueue.main.async {
      if let tempPath = tempPath {
        let controller = AVPlayerViewController()
        controller.player = AVPlayer(url: tempPath)

        self.present(controller, animated: true, completion: nil)
      }
    }
  }
}

With the Video object, you can fetchPlayerItem, fetchAVAsset and fetchThumbnail as well

And, of course, you have the ability to customize it

Config.VideoEditor.maximumDuration = 30
Config.VideoEditor.savesEditedVideoToLibrary = true

Installation

Gallery is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'Gallery'

Gallery is also available through Carthage. To install just write into your Cartfile:

github "hyperoslo/Gallery"

Gallery can also be installed manually. Just download and drop Sources folders in your project.

Author

Hyper Interaktiv AS, [email protected]

Contributing

We would love you to contribute to Gallery, check the CONTRIBUTING file for more info.

License

Gallery is available under the MIT license. See the LICENSE file for more info.

More Repositories

1

ImagePicker

๐Ÿ“ท Reinventing the way ImagePicker works.
Swift
4,867
star
2

Whisper

๐Ÿ“ฃ Whisper is a component that will make the task of display messages and in-app notifications simple. It has three different views inside
Swift
3,754
star
3

Presentation

๐Ÿ“‘ Presentation helps you to make tutorials, release notes and animated pages.
Swift
3,046
star
4

Cache

๐Ÿ“ฆ Nothing but Cache.
Swift
2,969
star
5

BarcodeScanner

๐Ÿ”Ž A simple and beautiful barcode scanner.
Swift
1,688
star
6

Lightbox

๐ŸŒŒ A convenient and easy to use image viewer for your iOS app
Swift
1,640
star
7

Sugar

โ˜• Something sweet that goes great with your Cocoa
Swift
1,068
star
8

Compass

๐ŸŒ Compass helps you setup a central navigation system for your application
Swift
826
star
9

Imaginary

๐Ÿฆ„ Remote images, as easy as one, two, three.
Swift
614
star
10

Pages

๐Ÿ“„ UIPageViewController made simple
Swift
495
star
11

iOS-playbook

Hyper's iOS playbook
228
star
12

capistrano-foreman

Capistrano tasks for foreman and upstart.
Ruby
136
star
13

Tabby

โ›ฉ A fancy tabbar
Swift
103
star
14

Keychains

๐Ÿ”‘ A keychain wrapper that is so easy to use that your cat could use it.
Swift
75
star
15

Aftermath

๐Ÿ”ฎ Stateless message-driven micro-framework in Swift.
Swift
71
star
16

novel

๐Ÿ“– A content management system (CMS) built in Swift
Swift
68
star
17

OhMyAuth

๐Ÿ” Simple OAuth2 library with a support of multiple services.
Swift
66
star
18

Brick

๐Ÿ’ง A generic view model for both basic and complex scenarios
Swift
59
star
19

gamification

Gamification is a collection of models for Ruby on Rails that allows you to make anything a game
Ruby
51
star
20

Signature

UIView with signature support
Objective-C
49
star
21

playbook

How we do things, and why
42
star
22

SwiftPackage

๐Ÿ† Template to make a Swift package
Ruby
38
star
23

hyper-alerts

Hyper Alerts notifies people whenever someone posts to Facebook or Twitter
Ruby
34
star
24

knowledge_base

Knowledge Base is a bunch of models for Ruby on Rails that you probably need to build your own
Ruby
31
star
25

SwiftProject

๐Ÿ† Generate Swift project with necessary toolings
Swift
30
star
26

github-s3

Shell scripts that make it really easy to archive and restore repositories between GitHub and AWS S3
Shell
20
star
27

cellular

Sending and receiving SMSs with Ruby through pluggable backends.
Ruby
20
star
28

mingle

Social media integration for Ruby on Rails
Ruby
20
star
29

activeadmin_polymorphic

Ruby
20
star
30

HYPEventManager

HYPEventManager is the easiest way to add, update and remove iOS calendar events.
Objective-C
17
star
31

hyper-recipes

Ruby
16
star
32

Contract

The easiest way to sign your soul away
Objective-C
15
star
33

Postman

ยซYou're nothing but a drifter who found a bag of mailยป
Objective-C
15
star
34

Minced

Convert JSON keys to camelCase
Objective-C
14
star
35

code-review

A simple application that selects a random commit for code review.
Ruby
14
star
36

CardStack

A container view controller implementing a stack of "cards" (each card is a view controller)
Objective-C
13
star
37

hyper-radar

๐Ÿ’ก Research and development at Hyper
12
star
38

Offline

๐Ÿ“ดOffline request storage.
Swift
11
star
39

TimeAgo

Swift
11
star
40

Scatter

Customizable Scatter Chart for iOS
Objective-C
11
star
41

AftermathCompass

Message-driven navigation system built on top of Aftermath and Compass.
Swift
10
star
42

AsyncWall

Swift
10
star
43

heroku-deploy

Deploying your applications to Heroku should never involve manually chaining shell commands together
Ruby
10
star
44

HYPLocalNotificationManager

Handle local notifications like a pro
Objective-C
9
star
45

hyper-content-for-angular

Inject content into a different part of your page
JavaScript
9
star
46

tasuku

Tasks for Ruby on Rails
Ruby
9
star
47

CollectionAnimations

UICollectionView animations
Swift
9
star
48

UIViewController-HYPKeyboardToolbar

Snap a toolbar to a keyboard like a pro
Objective-C
8
star
49

refile-input

Refile support for Formtastic
Ruby
8
star
50

singleton-rails

Adds singleton functionallity to ActiveRecord models
Ruby
8
star
51

Champagne

The Champagne Web Framework.
Swift
7
star
52

obix

Ruby OBIX parser
Ruby
6
star
53

android-playbook

6
star
54

feeder

Provides simple feed functionality through an engine
Ruby
6
star
55

hyper-says

Heard @hyperoslo
JavaScript
6
star
56

embeddable

Embeddable makes it easier to embed videos
Ruby
6
star
57

tv

The TV in our lobby
HTML
6
star
58

hyper_admin

Admin solution for Ruby on Rails.
Ruby
6
star
59

openid-token-proxy

Retrieves and refreshes OpenID tokens on behalf of a user when dealing with complex authentication schemes, such as client-side certificates
Ruby
6
star
60

Flasker

๐Ÿถ Secure User Defaults
Swift
6
star
61

ImageCrop

android library to zoom, pan and crop pictures
Java
6
star
62

facebook-messenger-demo

A demo rails app for facebook-messenger gem
Ruby
6
star
63

yr

Yr makes it easy to get weather forecast from Yr.no.
Ruby
5
star
64

Orchestra

Swift
5
star
65

date-interval-picker

A nice little date interval picker for Android
Java
5
star
66

NSString-HYPWordExtractor

The easiest way of extracting all words from a string
Objective-C
5
star
67

Transition

Swift
5
star
68

pissuu

Python client for the Issuu API
Python
5
star
69

javascript-playbook

A place to define our conventions for working with JavaScript
5
star
70

NSString-HYPFormula

Creating and running string-based formulas have never been this easy
Objective-C
5
star
71

heroku-pages

Easily inspect, view and upload your Heroku error and maintenance pages
Ruby
5
star
72

ios-foundation

๐Ÿ…An established foundation within iOS team
Ruby
5
star
73

bot

Bot all the thingsโ„ข
CoffeeScript
5
star
74

slack-andreasbot

A bot that is always typing. Just like the non-bot Andreas.
Ruby
5
star
75

deviser

Allows impersonation straight from the command line for Devise projects
Ruby
4
star
76

DistributedSpaceLayout

This is a tiny library extending LinearLayout to automatically distribute evenly spaces between children
Java
4
star
77

django-mobile

Simple, easy to use Django SMS app with support for pluggable backends
Python
4
star
78

hyper-validator-base

Enables validation for inputs in conjunction with hyper-validator modules.
JavaScript
4
star
79

api-playbook

A place to define the conventions we use to build APIs
4
star
80

NSManagedObjectContext-HYPSafeSave

Warns you of unsafe NSManagedObjectContext saves
Objective-C
4
star
81

HYPLocationManager

The easiest way to use CLLocationManager.
Objective-C
4
star
82

gulp-frontend-starterkit

Gulp Frontend StarterKit is a minimal mix of tasks and tools integrated with [Gulp](http://gulpjs.com/) to form a asset pipeline. It provides an efficient and modular workflow to develop and deploy static websites quickly.
JavaScript
4
star
83

one-repo-split-angular-rails-example

this is a prototype of playing together with angular and rails on the same repo, but without mixing their code together (heroku deployed)
Ruby
3
star
84

eslint-config

Hyper's ESLint config
JavaScript
3
star
85

reverse-proxy

Simple reverse proxy application.
Ruby
3
star
86

Sequent

Sequent iOS Framework
Swift
3
star
87

spot-hyper

Spot Hyper shares where you are and what you working on in realtime with other team members, right from any slack channel
Ruby
3
star
88

AftermathSpots

Swift
3
star
89

mysql-s3

A shell script that archives a MySQL database to AWS S3
Shell
3
star
90

Masquerade

Swift
3
star
91

grumbles-the-lame-wizard

"Grumbles the Lame Wizard" game
Ruby
3
star
92

hyper-guides

Miscellaneous guides from Hyper
Ruby
3
star
93

Depot

A convenience storage/caching library for Android.
Java
2
star
94

HYPInputValidators

Objective-C
2
star
95

HYPPopoverBackgroundView

Makes popover controllers look so good you'll want to lick them
Objective-C
2
star
96

HYPImagePicker

UIImagePickerController without the tears
Shell
2
star
97

AsyncMediaSlider

A simple to use media slider that loads remote images asynchronously on demand
Objective-C
2
star
98

HYPWebView

WebView++
Objective-C
2
star
99

amazon-s3-backup

Utility that creates storage buckets and transfer jobs that backup Amazon S3 Buckets to Google Cloud Storage
JavaScript
2
star
100

AftermathTools

Development tools for Aftermath.
Swift
2
star