An open-source implementation for picking files/folders out of an online API
Objective-C Ruby
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
TODocumentPickerViewController Merge pull request #3 from a2/patch-2 Apr 26, 2018
TODocumentPickerViewControllerExample.xcodeproj Updated project for Xcode 10 Jun 26, 2018
TODocumentPickerViewControllerExample Restored test time Dec 30, 2017
TOSearchBar Reconfigured layout for iOS 11 Dec 30, 2017
.gitignore Added DS_Store to gitignore May 7, 2017
LICENSE Initial commit. Jan 2, 2015 Updated README Dec 30, 2017
TODocumentPickerViewController.podspec Bumped podspec Dec 30, 2017
screenshot.jpg Updated screenshot Dec 30, 2017


Beerpay PayPal

TODocumentPickerViewController is an open source UIViewController framework that takes a list of files as input, and displays a navigable file system on iOS devices.

The goal of this project is to provide a completely generic, modular frontend UI for a variety of file services, both online, and locally. With services like Dropbox and Google Drive exposing their file systems via a REST API, and more low-level protocols like SMB and FTP requiring direct object serialisation, TODocumentPickerViewController is being engineered in such a way that any file source can be integrated.


  • Uses a delegate / data source model in order to integrate with any file source.
  • Can be configured using a configuration object passed to it upon init.
  • Self-replicates as users drill down folders, keeping configuration consistent between copies.
  • Data source provides an asynchronous mechanism to allow long lasting requests (like REST APIs) to not block the main thread.


As a CocoaPods Dependency

Add the following to your Podfile:

pod 'TODocumentPickerViewController'

Manual Installation

All of the necessary source files are in TODocumentPickerViewController. Simply copy that folder to your app project folder, and then import it into Xcode.

TODocumentPickerViewController also relies on the following libraries:

While copies have been placed in this repo to minimise the need to download multiple other repos, be sure to check to see if there have been updates on their main repos.

Technical Requirements

iOS 9.0 or above.


TODocumentPickerViewControlleris licensed under the MIT License. Please see the LICENSE file for more information. analytics