FastMediaSorter v2 🚀

Kotlin Android License

📖 Other Languages: 🇷🇺 Русский 🇺🇦 Українська

📦 Download: Get it on IzzyOnDroid

About the Project

FastMediaSorter v2 is a powerful Android application for quick and convenient sorting of media files (images, videos, GIFs, audio, documents). It is designed as a single center for managing files from local folders, network drives (SMB, SFTP, FTP), and cloud storage (Google Drive, OneDrive, Dropbox).

This manual now follows the same public vocabulary as the canonical feature inventory in FEATURES.md and the doc map in DOCS_MAP.md. Use those two pages as the current source of truth for the app story, available flavors, and current feature surface.

Windows Version 🖥️

Looking for a desktop solution? Check out Fast Media Sorter for Windows (formerly FastMediaSorter LITE) - a lightweight Windows Forms application for quickly sorting, viewing, and managing image and video files:

🔗 Fast Media Sorter for Windows

📄 How to publish PC folders to Android - share your PC folders with the app over SFTP (companion import / QR scan on the phone).

Features include:

Table of Contents

Product Flavors 🎯

FastMediaSorter v2 ships 5 main app flavors for phones and tablets, plus the XR / noLegal sideload surface for headset use. The current public matrix is the one documented in FEATURES.md and HOW_TO.md:

Flavor Description Notes
Standard Full-featured release Broadest feature set for media, documents, OCR, translation, and cloud access
Lite Lightweight release Smaller install, core media workflows, fewer optional integrations
Photos Photo-first release Optimized for browsing, sorting, and organizing images
Legacy Compatibility-focused release Full media plus SMB/FTP/SFTP and cloud (Google Drive, Dropbox, OneDrive); built for Android 6/7 (API 23+)
VR / noLegal XR and sideload surface OpenXR / VR-capable build path on supported headsets and sideload-only extras

Which Flavor Should I Download?

For exact feature-by-flavor availability, use the canonical documentation:

🧭 First launch: right under the language picker, the app lets you pick a device profile (phone, tablet, TV, car, photo frame, VR, and more) that tailors the starting defaults for you - changeable anytime in Settings. See First Launch: Choose Your Device Profile.

Download 📥

📲 Get it on Google Play

Compiled APK files are NOT stored in this GitHub repository. All builds are available on Google Drive:

🔗 Download All Builds from Google Drive

Flavor File Name Description
Standard FastMediaSorter_standard_release.zip Full features (Cloud, OCR, EPUB, Translation)
Lite FastMediaSorter_lite_release.zip Local media focus (Videos, Audio, Images; no cloud/documents)
Photos FastMediaSorter_photos_release.zip Images only (with cloud support)
Legacy FastMediaSorter_legacy_release.zip Full media + network (SMB/FTP/SFTP) + cloud; Android 6/7 (API 23+)

Note: All builds are automatically uploaded to Google Drive after successful compilation.

🔐 ZIP Password: 1 (APK files are packaged as password-protected ZIP archives to bypass Google Drive restrictions)

Screenshots 📱

Main Screen File Actions Settings
Player View    
   

Full-size images:

Key Features

Supported Media Formats 🎞️

FastMediaSorter v2 supports a wide range of formats:

Usage Scenarios 💡

Here are a few ways FastMediaSorter v2 can help you:

1. 📸 Organizing Camera Photos

Connect your phone or open a local camera folder. Set up a “Best Photos” destination folder. Open the viewer, quickly swipe through thousands of photos, and tap the destination button to instantly copy the best shots.

2. 🏠 Network Backup (NAS)

Add your home NAS via SMB. Browse your local media files. Select multiple files or a range, and “Move” them to your NAS for safe keeping, freeing up space on your device.

3. ☁️ Cloud Management

Connect your Google Drive, Dropbox, or OneDrive account. Browse your cloud files without downloading them all. Delete unwanted files or organize them into folders directly in the cloud.

4. 📺 Slideshow & Presentation

Open a folder with family photos or presentation slides. Hit “Play” to start a slideshow. Use the per-resource settings to adjust the slide duration to your liking.

5. ⭐ Managing Favorites

Mark important files with the star button while browsing. Later, tap the “Favorites” tab in the main menu to instantly access all your favorite files from all sources in one place - perfect for creating a curated collection of your best media.

6. 🎶 Slideshow with Background Music

Add your music collection as a resource. In Settings → Media → Images, enable “Play music during slideshow” and select your music resource. Now when you start a slideshow of your photos, your favorite tracks will play in the background. Tap the track name to skip to a different random song, creating the perfect ambiance for your photo presentations.

7. 🖼️ Digital Photo Frame on a Tablet

Turn any Android tablet into a beautiful always-on digital photo frame. Place it on a stand, connect to your home PC (SMB) or cloud storage - photos stream directly without occupying any local storage. Adjust the slide interval, keep the screen always on, add background music, and enjoy your memories. Even old, slow budget tablets work perfectly for this purpose - the app is optimized for low-resource continuous playback.

8. 🍿 Home Cinema & VR

Watch your favorite series stored on your PC or cloud directly on your phone or VR headset. No need to wait for copying or worry about free space. Just press play, and the next episode will start automatically.

VR Headset Use Cases - FastMediaSorter runs natively on Android-based VR headsets (Meta Quest, Pico, and similar) without any modifications:

9. 🧹 Download Organizer

Downloads folder cluttered? Open it in the source panel, set up destination buttons for “Documents”, “Images”, and “Installers”. Quickly scan through files, preview them, and sort them into the right places with a single tap. You can even sort files directly on your network computer using your phone as a remote control.

10. 🚗 In-Car Music with Android Head Unit

Install FastMediaSorter on your Android-powered car stereo or head unit. Add USB drive or SD card music folders - or use the built-in All Music virtual resource to instantly access your entire collection with zero setup. Hardware media buttons (steering wheel controls, volume knobs) work seamlessly via the background audio service: play/pause, next/previous track, all without touching the screen. The app remembers playback position and resumes automatically on startup.

With the Streams screen enabled, the same head unit also plays internet radio stations directly over mobile data or Wi-Fi - no separate TuneIn or RadioDroid app needed. Add any radio URL, or import a curated station catalog from the Extensions screen. The sticky mini-control shows the current ICY track name while the station list stays visible.

11. 📺 Media Center on an Android TV Box

Install FastMediaSorter on any Android TV box (Xiaomi Mi Box, Nvidia Shield, Amazon Fire TV, or a generic Android box). Connect to a home NAS over SMB, add Google Drive or Dropbox, or plug in a USB drive - all from one app. Control the full flow with a remote or Bluetooth keyboard: the D-pad moves focus, OK opens items, Back returns to the previous level, and Backspace moves one folder up in the browser. The remote’s colored buttons map to common file actions (Red = Delete, Green = Copy, Yellow = Move, Blue = Rename). Start a fullscreen slideshow with background music on the TV, or switch to audio playback with album art and lyrics. No touchscreen is required.

Documentation 📚

🗺️ Documentation Map / Карта документации: View all docs / Все документы

🌐 Official Website: https://serzhyale.github.io/FastMediaSorter_mob_v2/

Canonical Sources (Single Source of Truth)

The following files should be treated as the authoritative sources for user-facing details:

Detailed guides are available in multiple languages:

🇺🇸 English:

🇷🇺 Русский:

🇺🇦 Українська:

Technical / Developer Docs:

Wear OS Companion ⌚

FastMediaSorter includes a Wear OS companion app designed for quick access on smartwatch form factors.

Wear OS docs:

Build Instructions

Requirements

Build

  1. Clone the repository:

     git clone https://github.com/SerZhyAle/FastMediaSorter_mob_v2.git
 cd FastMediaSorter_mob_v2
  2. Open the project in Android Studio.
  3. Wait for Gradle synchronization to complete.
  4. Run the app on an emulator or physical device.

Preferred Build Commands (Windows / PowerShell)

.\build-debug.PS1
.\gradlew.bat assembleStandardDebug
.\gradlew.bat testStandardDebugUnitTest
.\gradlew.bat lintStandardDebug

Built APKs 📦

After every successful build, the generated APK file is automatically copied to the DOWNLOADS folder in the project root with a timestamp. You can find all your build history there.

Testing 🧪

FastMediaSorter v2 uses Maestro for end-to-end testing to ensure app quality and reliability.

Quick Test Run

# Install Maestro - macOS/Linux (Homebrew)
brew tap mobile-dev-inc/tap
brew install maestro

# Or Linux/macOS (curl)
curl -Ls "https://get.maestro.mobile.dev" | bash

# Windows (PowerShell as Administrator)
Invoke-WebRequest -Uri "https://get.maestro.mobile.dev/install.ps1" -OutFile install.ps1
.\install.ps1
Remove-Item install.ps1

# Run smoke tests (2-3 minutes)
./maestro/run-tests.sh smoke    # Linux/macOS
.\maestro\run-tests.ps1 smoke   # Windows

# Or use shortcut
.\scripts\utils\run-maestro-smoke.ps1  # Windows

Note: DO NOT use npm install -g maestro-cli - that’s a different, unrelated package!

Test Suites

Documentation

CI/CD Integration

Tests run automatically on every push via GitHub Actions. See .github/workflows/maestro-tests.yml.

First Steps (Quick Usage Guide) 🚀

  1. Adding a Folder (Resource):
    • On the main screen, press the button with the “Plus” (+) icon to add a new resource.
    • Select the resource type (e.g., “Local Folder”).
    • Use scanning or add the folder manually. After adding, it will appear in the list on the main screen.
  2. Viewing Files:
    • Double-tap (or long press) on the added resource in the list.
    • The browse screen will open, where you will see all media files from this folder as a list or grid.
    • Use the buttons on the top panel for sorting, filtering, or switching view.
  3. Playback and Sorting:
    • Tap on any file to open it in the full-screen player.
    • Use swipes left/right or touch zones for navigation between files.
    • For operations (copy, move), use the corresponding touch zones or buttons on the control panel.
  4. Configuring Destination Folders (Destinations):
    • In settings, on the “Destinations” tab, you can specify up to 30 folders that will be used for quick sorting.
    • Alternatively, enable “Is Destination” in any resource’s edit screen to add it to the quick sort list.
    • After that, buttons for quick copying or moving files to these folders will appear on the player screen.

Technology Stack

Build Version

Version format: Y.YM.MDDH.Hmm (e.g., 2.60.1102.207 for 2026/01/10 20:07)

See dev/CHANGELOG.md for detailed release notes.

Contributing 🤝

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Contact 📧

License 📄

Project legal information: