Full-featured Android file manager with root access, archive support, network protocols, cloud storage, built-in editor, and app manager. OLED dark theme. Zero-config.

git clone https://github.com/SysAdminDoc/FileExplorer.git
cd FileExplorer

1. Open in Android Studio Ladybug (2024.2.1+)
2. Sync Gradle
3. Run on device or emulator (API 26+)
4. Grant All Files Access when prompted

                           ┌─────────────────────────────────────────────┐
                           │                  :app                       │
                           │  Application, Navigation (8 routes),        │
                           │  Permission flow, MainActivity              │
                           └──────┬──────┬──────┬──────┬──────┬─────────┘
                                  │      │      │      │      │
              ┌───────────────────┼──────┼──────┼──────┼──────┼───────────────┐
              │                   │      │      │      │      │               │
     ┌────────▼──┐  ┌─────▼──┐ ┌─▼────┐ │ ┌────▼──┐ ┌▼─────┐│  ┌──────┐ ┌──▼────┐
     │ :feature: │  │:feature│ │:feat: │ │ │:feat: │ │:feat:││  │:feat:│ │:feat: │
     │  browser  │  │:search │ │transf │ │ │:netw  │ │cloud ││  │:edit │ │:apps  │
     │           │  │        │ │       │ │ │       │ │      ││  │      │ │       │
     └──┬──┬─────┘  └───┬────┘ └──┬────┘ │ └──┬────┘ └──┬───┘│  └──┬───┘ └──┬────┘
        │  │             │        │      │    │         │    │     │        │
     ┌──▼──▼─────────────▼────────▼──────▼────▼─────────▼────▼─────▼────────▼──┐
     │                        Core Layer                                        │
     │  :core:data        FileRepositoryFactory → Local / Root / Archive        │
     │  :core:storage     PermissionHelper, StorageVolumeHelper, RootHelper     │
     │  :core:network     SMB / SFTP / FTP / WebDAV + ConnectionManager         │
     │  :core:cloud       Google Drive / Dropbox / OneDrive + AccountManager    │
     │  :core:database    Room (bookmarks, recents, history, connections)        │
     │  :core:model       FileItem, SortOrder, TransferTask, ClipboardContent   │
     │  :core:ui          FileIcon, BreadcrumbBar, FileListItem                 │
     │  :core:designsystem  OLED dark theme, Material 3 colors                 │
     └─────────────────────────────────────────────────────────────────────────┘

18 Gradle modules. MVVM + Clean Architecture. FileRepositoryFactory routes file operations to the correct backend based on path type and device capabilities.

Cloud providers require OAuth configuration. Each is optional and the app works without them.

Google Drive: Create OAuth 2.0 client in Google Cloud Console, add your app's package name and SHA-1 fingerprint.

Dropbox: Register an app at Dropbox App Console, copy the App Key.

OneDrive: Register an app in Azure AD Portal, add Files.ReadWrite.All offline_access scope.

Theme mode is selectable in Settings: System, Light, Dark, OLED / True Black, or Material You on Android 12+.

OLED remains available as the high-contrast AMOLED option, while System follows the device theme.

• Android Studio Ladybug (2024.2.1+)
• Android SDK 36, JDK 17
• Device or emulator running Android 8.0+ (API 26)
• Rooted device for root features (optional)

Backup rules exclude the Room database (contains Keystore-encrypted network credentials), security preferences, and vault files from Android cloud backup.

Q: Why does it need All Files Access? A: Android requires MANAGE_EXTERNAL_STORAGE to browse outside app-specific directories. Without it, you can only see your own app's files.

Q: Is root required? A: No. Root features are optional and auto-detected. The app works as a standard file manager without root.

Q: Which archive formats are supported? A: ZIP (with AES-256 encryption), 7z, TAR, GZ, BZ2, XZ, and Zstandard. Archives can be browsed as virtual folders without extracting.

Q: Are my cloud credentials stored securely? A: Network passwords are encrypted before database storage with Android Keystore-backed AES-GCM. Cloud OAuth tokens stay in memory unless you choose Stay signed in, which stores account tokens in Keystore-encrypted app preferences.

Issues and PRs welcome. This project follows the "maximum feature density" philosophy — if it belongs in a file manager, it should be here.

MIT