/00 — boot sequence

Hello.

cd ../open-source

aiyu-ayaan/Findex

Findex

Beautiful open-source Android file manager built with Jetpack Compose and Material 3 Expressive. Multi-tab and dual-pane browsing, storage analyzer, duplicate finder, cleaner, archive tools, recycle bin. Fast, fluid and privacy-focused.

  • active
  • 5 stars
  • 1 forks
  • Kotlin
  • Apache-2.0
  • pushed 5d ago
Findex preview

// readmeaiyu-ayaan/Findex

Findex logo

Findex

Last commit License Release

Kotlin Jetpack Compose Material 3 Expressive Min SDK

A modern, native Android file explorer built with Jetpack Compose and Material 3 Expressive design. Findex combines fluid motion, expressive shape morphing, multi-tab multitasking, deep storage analytics, an encrypted vault, network storage (SMB, WebDAV, FTP, SFTP), and powerful archive utilities into a fast, privacy-respecting file manager. It can also share your phone's files with a computer's browser over Wi-Fi.


🎬 Intro video

Findex intro video (click for the full MP4)


📸 Screenshots

Findex Home Screen    Findex Push Drawer    Findex Explorer

Multi-Selection & Floating Toolbar    Storage Analyzer    Media Categories


✨ Features

Explore & organize

  • Explorer: list/grid, sort, hidden files, thumbnails for images, video, PDF, APK and audio art, predictive back and shared-axis motion.
  • Multi-tab multitasking: open many folders at once, copy/cut/paste across tabs through one clipboard, tabs restored on cold start.
  • Dual pane: two folders side by side (stacked on phones). Copy, move and delete across panes. Folder compare marks only-here, newer, older, different and same, and can select what the other pane is missing.
  • Selection like Google Photos: long-press, swipe to range-select, or tap items after the first. Floating toolbar for copy, cut, compress, delete, share.
  • Global search over the MediaStore index, recent files, favorites and colored tags, shortcuts, recent changes.
  • Batch rename with preview and conflict checks.
  • Recycle Bin: per-volume .FindexTrash, undo, 30-day purge.

Storage tools

  • Storage analyzer: circular gauge, category breakdown (Photos, Videos, Audio, Documents, Apps, Archives), growth history.
  • Large file finder and duplicate finder (staged hashing, keep-one guard).
  • Storage Cleaner: junk, obsolete APKs, cache artifacts, empty folder trees and empty files.
  • App Cleaner: leftover folders of uninstalled apps in Android/media, data, obb, plus reachable app caches.
  • Social media cleaners: WhatsApp, Telegram and Instagram media by type and direction.
  • Image compression in batch.

Archives

  • Create ZIP (AES-256 password), 7z, TAR, TAR.GZ.
  • Extract ZIP, 7z, RAR/RAR5, TAR, TAR.XZ/BZ2.
  • Browse an archive and open single entries without full extraction.
  • 16 KB page-size compliant native binaries for Android 15+.

Network & sharing

  • Network storage: SMB, WebDAV, FTP, SFTP. Shares open as normal Explorer tabs, with live status, thumbnails and video streaming. Passwords are Keystore-encrypted, or session-only.
  • Share this phone: local web server with address and random 6-digit PIN. Browse, preview, download, upload, rename and delete from a computer's browser. Access presets (View / Download / Full) apply live. Stops itself after an idle timeout. Plain HTTP: trusted networks only.

Privacy & viewers

  • Encrypted Vault: password and biometric unlock, encrypted at rest, locks when the app leaves the screen.
  • Built-in viewers: image/video gallery, text/code, PDF, audio player, plus a file hash calculator and media metadata inspector.

Platform & design

  • Material 3 Expressive: dynamic color, shape morphing (Cookie, Scallop, Clover, Pill), wavy progress, push drawer with spring physics.
  • Foreground operation queue: copy, move, compress, extract, delete and clean run in FileOperationForegroundService, cancellable, with notification progress.
  • Adaptive tablet layout: navigation rail, permanent drawer, list-detail with inspector pane.
  • In-app updates: daily background check, release notes, Updates screen.

🧭 How it works

Modules

graph TD
    app[":app<br/>FindexApp · MainActivity"] --> ui[":ui<br/>Compose screens · ViewModels · strings.xml"]
    ui --> core[":core<br/>repositories · Room · DataStore · operations · network · share server"]
    bp[":baselineprofile<br/>profile generation, not shipped"] -. measures .-> app

Long file operations

sequenceDiagram
    actor User
    participant VM as ViewModel
    participant Mgr as OperationManager
    participant FGS as ForegroundService
    participant Exec as FileOperationExecutor
    User->>VM: Copy / Move / Delete / Compress / Extract / Clean
    VM->>Mgr: enqueue(operation)
    Mgr->>FGS: startForegroundService
    loop until queue empty
        FGS->>Mgr: poll()
        FGS->>Exec: execute (IO dispatcher)
        Exec-->>FGS: progress
        FGS-->>VM: progress banner + result snackbar
    end

Storage sources

graph LR
    Explorer --> Local[Internal / SD card]
    Explorer --> Net[Network drive]
    Net --> SMB & WebDAV & FTP & SFTP
    Explorer --> Vault[(Encrypted Vault)]
    Browser[Computer browser] -- LAN + PIN --> Share[Share this phone server] --> Explorer

More diagrams: ARCHITECTURE.md.


🏗️ Architecture

Findex follows Clean Architecture principles with decoupled Gradle modules:

├── app/    # Application entry point, Hilt Android App, MainActivity, Permissions
├── core/   # File engines, Room DB (SQLite), DataStore, network clients, share server, Foreground Services, Repositories
├── ui/     # Jetpack Compose UI, Material 3 Expressive Theme, ViewModels, centralized strings.xml
└── baselineprofile/  # Baseline + startup profile generation (not shipped)
ModuleResponsibilityLocalization Rule
:appApp manifest, Hilt injection root, application lifecycleNo strings (merges from :ui)
:coreStorage engines, SQLite Room DB, background operationsNo strings (delegates via OperationStrings interface)
:uiCompose screens, expressive components, navigationSingle source of truth: all strings live in ui/src/main/res/values/strings.xml

🚀 Getting Started

Prerequisites

  • Android SDK with platform 37 (compileSdk 37); runs on Android 8.0+ (minSdk 26)
  • Java 17+ (or OpenJDK 17)
  • Connected Android device or running emulator

Build & Run

Use the included helper script run.sh to build, install, and launch the application directly:

# Build, install, and launch Findex on your connected device/emulator
./run.sh

# Build, launch, and follow logcat output
./run.sh --logs

# Clean build and launch
./run.sh --clean --logs

Building Release APK

To build an optimized, R8-minified release APK:

./build-release.sh

🖥️ Emulator Display & DPI Resolution

If your emulator was previously toggled to a tablet resolution or has custom window manager overrides, you may notice black bars or tablet desktop layout on a mobile emulator.

You can instantly restore your emulator to its native physical resolution and density:

# Option 1: Using run.sh
./run.sh --reset-display

# Option 2: Using adb directly
adb shell wm size reset
adb shell wm density reset

Note: ./run.sh automatically checks for active display overrides and resets them to the device's physical defaults.


📄 License

This project is licensed under the Apache License 2.0, Copyright 2026 Ayaan. See LICENSE for details.

// stack

  • Kotlin
  • Android
  • Android APP
  • Android File Manager
  • Archive Manager
  • Compose UI
  • Dual Pane
  • Duplicate Finder
  • android
  • android-app
  • android-file-manager
  • archive-manager
  • compose-ui
  • dual-pane
  • duplicate-finder
  • file-explorer
  • file-manager
  • file-sharing
  • foss
  • jetpack-compose

// specs

status
Working
type
Mobile
year
2026
language
Kotlin
license
Apache-2.0
stars
5
forks
1
branch
master

Repository data last synced