FastMediaSorter v2 🚀

Kotlin Android

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

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 various sources: local device folders, network drives (SMB, SFTP, FTP), and cloud storage (Google Drive, OneDrive, Dropbox).

The key idea of v2 is to combine viewing, playback, and organization of files in one intuitive interface, eliminating the shortcomings and limitations of the previous version.

Windows Version 🖥️

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

🔗 FastMediaSorter LITE for Windows

Features include:

Table of Contents

Product Flavors 🎯

FastMediaSorter v2 is available in 4 different flavors to suit different needs and reduce app size:

Flavor Description Features
Standard Full-featured version Broadest feature set for media, documents, OCR, and integrations
Lite Lightweight daily-use version Core media workflows with reduced complexity
Photos Image-centric version Focused experience for photo browsing and organization
Legacy Compatibility-focused version Optimized for older Android devices (API 23-25)

Which Flavor Should I Download?

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

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 local media (Android 6/7 compatibility, API 23-25)

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 → Audio, enable “Slideshow Background Music” 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.

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: