Skip to content

Repository files navigation

FileBrowser - iOS Finder-style file browser in Swift

Build StatusVersionCarthage compatible

FileBrowser

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

Features

Features
📱Browse and select files and folders with a familiar UI on iOS.
🔍Pull down to search.
👓Preview most file types. Including plist and json.
📝Edit/delete files.
👆3D touch support for faster previews with Peek & Pop.
💮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:

letfileBrowser=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.

letfileBrowser=FileBrowser(initialPath: customPath)

You can also allow editing/deleting files.

letfileBrowser=FileBrowser(initialPath: customPath, allowEditing:true)

You can show/hide files and directories sizes (true by default).

letfileBrowser=FileBrowser(initialPath: documentsUrl,
allowEditing:true,
showCancelButton:true,
showSize:true)

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

fileBrowser.didSelectFile ={(file:FBFile)->Voidinprint(file.displayName)}

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

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

Setting up with SPM

letpackage=Package(dependencies: [.package(url: "https://github.com/Nuglif/FileBrowser.git",from: "1.3.0"),],targets: [.target(name: "YourTarget",dependencies: ["FileBrowser",])])

Setting up with CocoaPods

pod'FileBrowser',git: 'https://github.com/Nuglif/FileBrowser'

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 "Nuglif/FileBrowser"

About

Finder-style iOS file browser written in Swift

Resources

Stars

19 stars

Watchers

8 watching

Forks

Releases

Packages

Used by

Contributors

Languages