https://github.com/awkward/tatsi
A drop-in replacement for UIImagePickerController with the ability to select multiple images and/or videos
https://github.com/awkward/tatsi
photos swift uiimagepickercontroller
Last synced: about 1 year ago
JSON representation
A drop-in replacement for UIImagePickerController with the ability to select multiple images and/or videos
- Host: GitHub
- URL: https://github.com/awkward/tatsi
- Owner: awkward
- License: mit
- Created: 2017-07-12T09:06:11.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2024-01-17T15:12:02.000Z (over 2 years ago)
- Last Synced: 2024-10-31T15:49:35.391Z (over 1 year ago)
- Topics: photos, swift, uiimagepickercontroller
- Language: Swift
- Homepage:
- Size: 1.16 MB
- Stars: 110
- Watchers: 13
- Forks: 30
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Tatsi
A drop-in replacement for UIImagePickerController with more options and the ability to select multiple images and/or videos.
## Screenshots
## Introduction
Hi, we're Awkward. We created a customizable image picker for our iOS reddit client called Beam. UIImagePickerController only supports selecting 1 image at a time, but we needed more images in Beam. Tatsi has built in support for selecting multiple images. On top of that, we integrated a camera button directly into the picker. We welcome you to use Tatsi for your own projects.
## Features
- Multi selection of photos/videos using the photos library
- Ability to reverse the display order of images/videos
- Option to show a camera button inside the picker
- Assigning a max limit for the number of photos and videos
- Choosing the first view the user sees
- Ability to display the picker in a single view, merging the album view with the assets collection
- Accessibility (voice-over and switch control) is supported
- Easily Localizable
- Support for smart albums, user created albums and iCloud shared albums
- Support for dark mode by default
- Customization using the `TatsiColors` protocol
## Installation
### Submodules/Embedded frameworks (preferred)
1. Add Tatsi as a submodule to your repository.
2. Drag `Tatsi.xcodeproj` into your Xcode project
3. Go to your Project Settings -> General and add Tatsi under Embedded Frameworks
4. Add `NSPhotoLibraryUsageDescription` to your Info.plist with a proper description.
5. (Optional) if you want to use the camera option. You will also need to add `NSCameraUsageDescription` to your Info.plist
### Manual
1. Remove Tatsi.h and Info.plist from the Tatsi folder.
2. Add the contents of the Tatsi folder to your projects
3. Add `NSPhotoLibraryUsageDescription` to your Info.plist with a proper description.
4. (Optional) if you want to use the camera option. You will also need to add `NSCameraUsageDescription` to your Info.plist
### Carthage
1. Add `github "awkward/Tatsi"` to your `Cartfile`
2. Run `carthage update Tatsi`
3. Add Tatsi to your project's Embedded Binaries and to the Carthage build phase
4. Add `NSPhotoLibraryUsageDescription` to your Info.plist with a proper description.
5. (Optional) if you want to use the camera option. You will also need to add `NSCameraUsageDescription` to your Info.plist
### Cocoapods
1. Add `pod 'Tatsi'` to your `Podfile`
2. Run `pod install`
3. Add `NSPhotoLibraryUsageDescription` to your Info.plist with a proper description.
4. (Optional) if you want to use the camera option. You will also need to add `NSCameraUsageDescription` to your Info.plist
## Usage
1. Add `Import Tatsi` and `Import Photos` to your Swift file. You can skip this step if you used manual installation.
2. (Optional) Create an instance of `TatsiConfig` and configure the settings.
3. Create an instance of `TatsiPickerViewController`. `TatsiPickerViewController(config:)` allows you to use the config from the previous step
4. Implement `TatsiPickerViewControllerDelegate`
5. Set the `pickerDelegate` on `TatsiPickerViewController`
6. Present the `TatsiPickerViewController`
## Localization
Tatsi is localized in English by default but you can provide your own localization in your project. Simple include the keys in your project's localizable strings. For more information see [Localization](https://github.com/awkward/Tatsi/wiki/Localization) on the Wiki
## Misc
### Origin of name
Tatsi = Photos in Planco, the language spoken in the game Planet Coaster. [Source](https://twitter.com/JamesStant/status/882582597460799489)
### Missing parts
- [ ] The ability to color some elements
- [ ] Icons for the hidden and recently deleted albums
- [ ] Proper `init?(coder aDecoder: NSCoder)` support
- [ ] UI Tests
- [ ] Running Unit Tests on Travis
## Documentation
> We're trying to keep our documentation as updated as possible. Here you can find more information on Tatsi.
## License
> Tatsi is available under the MIT license. See the LICENSE file for more info.
## Links