Latest 1.0.0
Homepage https://github.com/marmelroy/FileBrowser
License MIT
Platforms ios 8.0, requires ARC
Frameworks QuickLook, WebKit
Authors

FileBrowser - iOS Finder-style file browser in Swift

Build Status Version
Carthage compatible

iOS Finder-style file browser in Swift 4.0 with search, file previews and 3D touch. Simple and quick to use.

Features

:sparkles: Features
:iphone: Browse and select files and folders with a familiar UI on iOS.
:mag: Pull down to search.
:eyeglasses: Preview most file types. Including plist and json.
:pencil: Edit/delete files.
:point_up_2: 3D touch support for faster previews with Peek & Pop.
:white_flower: Fully customizable.

Usage

Import FileBrowser at the top of the Swift file.

import FileBrowser

To show the file browser, all you need to do is:

let fileBrowser = FileBrowser()
present(fileBrowser, animated: true, completion: nil)

By default, the file browser will open in your app’s documents directory. When users select a file, a preview will be displayed – offering an action sheet of options based on the file type.

Advanced Usage

You can open FileBrowser in a different root folder by initialising with an NSURL file path of your choice.

let fileBrowser = FileBrowser(initialPath: customPath)

You can also allow editing/deleting files.

let fileBrowser = FileBrowser(initialPath: customPath, allowEditing: true)

Use the didSelectFile closure to change FileBrowser’s behaviour when a file is selected.

fileBrowser.didSelectFile = { (file: FBFile) -> Void in
    print(file.displayName)
}

To exclude a certain file type or a specific file path:

fileBrowser.excludesFileExtensions = ["zip"]
fileBrowser.excludesFilepaths = [secretFile]

Setting up with CocoaPods

source 'https://github.com/CocoaPods/Specs.git'
pod 'FileBrowser', '~> 1.0'

Setting up with Carthage

Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate FileBrowser into your Xcode project using Carthage, specify it in your Cartfile:

github "marmelroy/FileBrowser"

Latest podspec

{
    "name": "FileBrowser",
    "version": "1.0.0",
    "summary": "Powerful iOS file browser in Swift.",
    "description": "A Swift file browser for iOS. Supports QuickLook, search and 3D touch.",
    "homepage": "https://github.com/marmelroy/FileBrowser",
    "license": "MIT",
    "authors": {
        "Roy Marmelstein": "[email protected]"
    },
    "source": {
        "git": "https://github.com/marmelroy/FileBrowser.git",
        "tag": "1.0.0",
        "submodules": true
    },
    "social_media_url": "http://twitter.com/marmelroy",
    "platforms": {
        "ios": "8.0"
    },
    "requires_arc": true,
    "source_files": "FileBrowser",
    "resources": "FileBrowser/Resources/*.*",
    "pod_target_xcconfig": {
        "SWIFT_VERSION": "4.0"
    },
    "frameworks": [
        "QuickLook",
        "WebKit"
    ],
    "pushed_with_swift_version": "4.0"
}

Pin It on Pinterest

Share This