$ show yasirkula/UnitySimpleFileBrowser
This repository is a Unity plugin that provides a fully-featured file browser dialog for save/load operations during gameplay. It supports file and folder selection, multi-selection, search, filtering, context menu operations (rename, delete, create folder), window drag/resize, and runtime theming. The plugin uses a singleton pattern to ensure only one dialog is open at a time and offers coroutine-based methods (WaitForSaveDialog/WaitForLoadDialog) for seamless integration with Unity's async system. The architecture is structured as a set of Unity scripts, prefabs, and assets. The main controller is FileBrowser.cs, which manages the dialog lifecycle and UI interactions. FileBrowserHelpers.cs abstracts file system operations across platforms, with special handling for Android's Storage Access Framework (SAF) via native Java code compiled into an .aar. The UI is built with Unity's uGUI system and includes a recycled list view for efficient rendering of large directories. Skinning is handled by UISkin.cs, a ScriptableObject that defines colors, fonts, and sprites. The plugin also includes Android-specific Java classes for directory picking and permission requests. Key patterns include object pooling (RecycledListView), platform abstraction (FileBrowserHelpers), theming via scriptable objects (UISkin), and coroutine support. The Android integration is particularly noteworthy, as it handles the complexities of the Storage Access Framework for file operations on modern Android versions. The plugin is designed to be embedded in any Unity project and is distributed as a Unity package via the Asset Store or OpenUPM.
The LLM identified 4 files worth highlighting for reuse:
Implements a virtual, object-pooled list view that recycles ListItem instances to efficiently render large directories without creating excessive GameObjects. It uses an adapter interface (IListViewAdapter) for decoupling, making it reusable in any Unity UI that needs a scrollable list with dynamic content.
Defines a theming system as a Unity ScriptableObject, with properties for colors, fonts, sprites, and file type icons. The ApplyTo methods style UI elements consistently. This pattern can be extracted and used in other Unity projects to provide runtime-swappable skins.
Provides static methods for file system operations (read, write, copy, move, delete) that transparently handle platform differences, including Android's Storage Access Framework. It encapsulates the complexity of SAF document URIs and permission checks, offering a clean API that can be reused in other Unity projects needing cross-platform file I/O.
Implements native Android file browsing using the Storage Access Framework, including directory picking, permission requests, and file operations. These Java classes communicate with Unity via callbacks and can be reused as a standalone Android library for SAF-based file dialogs.