Unity Standalone File Browser

A simple wrapper for native file dialogs on Windows/Mac/Linux.

Works in editor and runtime.
Open file/folder, save file dialogs supported.
Multiple file selection.
File extension filter.
Mono/IL2CPP backends supported.
Linux support by Ricardo Rodrigues.
Basic WebGL support.
Merged

Installation

Add from OpenUPM | via scoped registry, recommended

To add OpenUPM to your project:

open Edit/Project Settings/Package Manager
add a new Scoped Registry:

Name: OpenUPM
URL:  https://package.openupm.com/
Scope(s): io.github.gkngkc.unity-standalone-file-browser

click Save
open Package Manager
Select My Registries in dropdown top left
Select Unity Standalone File Browser and click Install

Add from GitHub | not recommended, no updates through PackMan

You can also add it directly from GitHub on Unity 2019.4+. Note that you won't be able to receive updates through Package Manager this way, you'll have to update manually.

open Package Manager
click +
select Add from Git URL
paste https://github.com/shiena/UnityStandaloneFileBrowser.git?path=Packages/StandaloneFileBrowser#upm
click Add

Example usage:

// Open file
var paths = StandaloneFileBrowser.OpenFilePanel("Open File", "", "", false);

// Open file async
StandaloneFileBrowser.OpenFilePanelAsync("Open File", "", "", false, (string[] paths) => {  });

// Open file with filter
var extensions = new [] {
    new ExtensionFilter("Image Files", "png", "jpg", "jpeg" ),
    new ExtensionFilter("Sound Files", "mp3", "wav" ),
    new ExtensionFilter("All Files", "*" ),
};
var paths = StandaloneFileBrowser.OpenFilePanel("Open File", "", extensions, true);

// Save file
var path = StandaloneFileBrowser.SaveFilePanel("Save File", "", "", "");

// Save file async
StandaloneFileBrowser.SaveFilePanelAsync("Save File", "", "", "", (string path) => {  });

// Save file with filter
var extensionList = new [] {
    new ExtensionFilter("Binary", "bin"),
    new ExtensionFilter("Text", "txt"),
};
var path = StandaloneFileBrowser.SaveFilePanel("Save File", "", "MySaveFile", extensionList);

See Sample/BasicSampleScene.unity for more detailed examples.

Mac Screenshot

Windows Screenshot

Linux Screenshot

Notes:

Windows
- Requires .NET 3.5 or higher api compatibility level
- Async dialog opening not implemented, ..Async methods simply calls regular sync methods.
- Plugin import settings should be like this;
Mac
- Sync calls are throws an exception at development build after native panel loses and gains focus. Use async calls to avoid this.

WebGL:

Basic upload/download file support.
File filter support.
Not well tested, probably not much reliable.
Since browsers require more work to do file operations, webgl isn't directly implemented to Open/Save calls. You can check CanvasSampleScene.unity and canvas sample scripts for example usages.

Live Demo: https://gkngkc.github.io/

License

shiena/UnityStandaloneFileBrowser

ErrorLooks like something went wrong!

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages