26.10.09 14:52

FastMediaSorter v2 🚀

Kotlin Android Lizenz

📦 Download: Bei IzzyOnDroid erhältlich

Installierst du die APK direkt? Android warnt vor einem Paket, das es noch nicht kennt - warum die Warnung erscheint und worauf du tippen musst.

📘 Benutzerdokumentation: Schritt-für-Schritt-Anleitungen für jede Funktion, mit Suche

Über das Projekt

FastMediaSorter v2 ist eine komplette Shell für ein Android-Gerät. Sie übernimmt den Startbildschirm, spielt deine Medien ab, öffnet Live-Streams, startet deine Apps, spricht mit deiner Uhr, behält das Gerät im Blick und verwaltet jede Datei, die dir gehört - in lokalen Ordnern, auf Netzlaufwerken (SMB, SFTP, FTP) und in Cloud-Speichern (Google Drive, OneDrive, Dropbox).

Sie basiert auf acht Säulen: Geräte-Shell, Medienplayer, Live-Streams, App-Start, Ersatz für Standard-Apps, Begleiter auf der Uhr, Geräteüberwachung und ein vollwertiger Dateimanager. Das Sortieren von Dateien über all diese Quellen hinweg war der Ausgangspunkt der App und ist immer noch das Fundament, auf dem alles andere aufbaut - aber längst nicht mehr alles.

Dieses Handbuch folgt jetzt demselben öffentlichen Wortschatz wie das maßgebliche Funktionsverzeichnis in FEATURES.md und die Dokumentenübersicht in DOCS_MAP.md. Nutze diese beiden Seiten als aktuelle verlässliche Quelle für die App-Story, die verfügbaren Editionen und den aktuellen Funktionsumfang.

Windows-Version 🖥️

Suchst du eine Desktop-Lösung? Wirf einen Blick auf Fast Media Sorter & Sharing for Windows - eine schlanke Windows-Forms-Anwendung zum schnellen Sortieren, Anzeigen und Verwalten von Bild- und Videodateien:

🔗 Fast Media Sorter & Sharing for Windows

📄 So veröffentlichst du PC-Ordner für Android - teile deine PC-Ordner mit der App über SFTP (Companion-Import / QR-Scan auf dem Handy).

Zu den Funktionen gehören:

Inhaltsverzeichnis

Editionen 🎯

FastMediaSorter v2 erscheint in sieben Editionen - fünf für Alltags-Smartphones und -Tablets (Standard, Lite, Photos, Legacy, FOSS) sowie zwei Headset- und Sideload-Builds, VR und noLegal. Das maßgebliche Funktionsraster wird direkt aus dem Build generiert in FLAVOR_MATRIX.md:

Edition Beschreibung Hinweise
Standard Vollständige Version Größter Funktionsumfang für Medien, Dokumente, OCR, Übersetzung und Cloud-Zugriff
Lite Schlanke Version Nur lokale Dateien - Video, Audio und Bilder; keine Netzwerkquellen, Cloud, Dokumente oder Streams
Photos Foto-fokussierte Version Nur Bilder, mit SMB/FTP/SFTP und Cloud; kein Video und kein Audio
Legacy Kompatibilitätsorientierte Version Gleicher Funktionsumfang wie Standard, einschließlich SMB/FTP/SFTP und Cloud (Google Drive, Dropbox, OneDrive); gebaut für Android 6/7 (API 23+)
FOSS F-Droid-Katalogversion Keine proprietären SDKs: lokale Medien, Dokumente, EPUB und SMB/FTP/SFTP; keine Cloud, keine Streams, kein OCR, keine Übersetzung und kein Wear OS Begleiter
VR Store-konformer Headset-Build Vollständiges Medienangebot für Headsets; ohne Google Cast und ohne Wear OS Begleiter
noLegal Sideload-Build Alles aus Standard plus der immersive OpenXR-Player und Sideload-exklusive Extras

Welche Edition sollte ich herunterladen?

Für die genaue Funktionsverfügbarkeit pro Edition nutze die maßgebliche Dokumentation:

🧭 Erster Start: direkt unter der Sprachauswahl lässt dich die App ein Geräteprofil wählen (Smartphone, Tablet, TV, Auto, Bilderrahmen, VR und mehr), das die Startvorgaben für dich anpasst - jederzeit änderbar in den Einstellungen. Siehe Erster Start: Wähle dein Geräteprofil.

Download 📥

📲 Bei Google Play holen

Kompilierte APK-Dateien werden NICHT in diesem GitHub-Repository gespeichert. Alle Builds sind auf Google Drive verfügbar:

🔗 Alle Builds von Google Drive herunterladen

Edition Dateiname Beschreibung
Standard FastMediaSorter_standard_release.zip Voller Funktionsumfang (Cloud, OCR, EPUB, Übersetzung)
Lite FastMediaSorter_lite_release.zip Nur lokale Medien (Videos, Audio, Bilder; kein Netzwerk, keine Cloud, keine Dokumente oder Streams)
Photos FastMediaSorter_photos_release.zip Nur Bilder, mit Netzwerk (SMB/FTP/SFTP) und Cloud
Legacy FastMediaSorter_legacy_release.zip Gleiche Funktionen wie Standard, einschließlich Netzwerk (SMB/FTP/SFTP) und Cloud; Android 6/7 (API 23+)

Hinweis: Alle Builds werden nach erfolgreicher Kompilierung automatisch zu Google Drive hochgeladen.

🔐 ZIP-Passwort: 1 (APK-Dateien werden als passwortgeschützte ZIP-Archive verpackt, um Google-Drive-Beschränkungen zu umgehen)

Screenshots 📱

Hauptbildschirm Dateiaktionen Einstellungen
Player-Ansicht    
   

Bilder in voller Größe:

Hauptfunktionen

Unterstützte Medienformate 🎞️

FastMediaSorter v2 unterstützt eine breite Palette an Formaten:

Anwendungsszenarien 💡

Hier sind einige Möglichkeiten, wie FastMediaSorter v2 dir helfen kann:

1. 📸 Kamerafotos organisieren

Verbinde dein Handy oder öffne einen lokalen Kameraordner. Richte einen Zielordner “Beste Fotos” ein. Öffne den Betrachter, wische schnell durch tausende Fotos und tippe auf die Zielschaltfläche, um die besten Aufnahmen sofort zu kopieren.

2. 🏠 Netzwerk-Backup (NAS)

Füge dein Heim-NAS über SMB hinzu. Durchsuche deine lokalen Mediendateien. Wähle mehrere Dateien oder einen Bereich aus und “Verschiebe” sie zur sicheren Aufbewahrung auf dein NAS, um Speicherplatz auf deinem Gerät freizugeben.

3. ☁️ Cloud-Verwaltung

Verbinde dein Google-Drive-, Dropbox- oder OneDrive-Konto. Durchsuche deine Cloud-Dateien, ohne sie alle herunterzuladen. Lösche unerwünschte Dateien oder organisiere sie direkt in der Cloud in Ordner.

4. 📺 Diashow & Präsentation

Öffne einen Ordner mit Familienfotos oder Präsentationsfolien. Tippe auf “Wiedergabe”, um eine Diashow zu starten. Nutze die Einstellungen pro Ressource, um die Foliendauer nach Wunsch anzupassen.

5. ⭐ Favoriten verwalten

Markiere wichtige Dateien beim Durchsuchen mit der Sternschaltfläche. Tippe später im Hauptmenü auf den Tab “Favoriten”, um sofort auf alle deine Favoriten aus allen Quellen an einem Ort zuzugreifen - perfekt, um eine kuratierte Sammlung deiner besten Medien zu erstellen.

6. 🎶 Diashow mit Hintergrundmusik

Füge deine Musiksammlung als Ressource hinzu. Aktiviere in Einstellungen → Medien → Bilder die Option “Musik während Diashow abspielen” und wähle deine Musikressource. Wenn du nun eine Diashow deiner Fotos startest, spielen deine Lieblingstitel im Hintergrund. Tippe auf den Titelnamen, um zu einem anderen zufälligen Titel zu springen und die perfekte Stimmung für deine Fotopräsentationen zu schaffen.

7. 🖼️ Digitaler Bilderrahmen auf einem Tablet

Verwandle jedes Android-Tablet in einen wunderschönen, dauerhaft aktiven digitalen Bilderrahmen. Stelle es auf einen Ständer, verbinde es mit deinem Heim-PC (SMB) oder Cloud-Speicher - Fotos werden direkt gestreamt, ohne lokalen Speicherplatz zu belegen. Passe das Diashow-Intervall an, halte den Bildschirm dauerhaft an, füge Hintergrundmusik hinzu und genieße deine Erinnerungen. Selbst alte, langsame Budget-Tablets funktionieren hierfür einwandfrei - die App ist für ressourcenschonende Dauerwiedergabe optimiert.

8. 🍿 Heimkino & VR

Sieh deine Lieblingsserien von deinem PC oder deiner Cloud direkt auf deinem Handy oder VR-Headset. Kein Warten aufs Kopieren, keine Sorge um freien Speicher. Einfach auf Wiedergabe drücken, und die nächste Folge startet automatisch.

Anwendungsfälle für VR-Headsets - FastMediaSorter läuft nativ auf Android-basierten VR-Headsets (Meta Quest, Pico und ähnlichen) ohne jede Änderung:

9. 🧹 Download-Organizer

Ist dein Downloads-Ordner unübersichtlich? Öffne ihn im Quellenpanel, richte Zielschaltflächen für “Dokumente”, “Bilder” und “Installationsdateien” ein. Scanne schnell durch die Dateien, sieh sie dir an und sortiere sie mit einem Tipp an den richtigen Ort. Du kannst Dateien sogar direkt auf deinem Netzwerkcomputer sortieren, indem du dein Handy als Fernbedienung verwendest.

10. 🚗 Automusik mit Android-Kopfeinheit

Installiere FastMediaSorter auf deiner Android-basierten Autostereoanlage oder Kopfeinheit. Füge USB-Stick- oder SD-Karten-Musikordner hinzu - oder nutze die eingebaute virtuelle Ressource Alle Musik, um sofort ohne Einrichtung auf deine gesamte Sammlung zuzugreifen. Hardware-Medientasten (Lenkradsteuerung, Lautstärkeregler) funktionieren nahtlos über den Hintergrund-Audiodienst: Play/Pause, nächster/vorheriger Titel, alles ohne den Bildschirm zu berühren. Die App merkt sich die Wiedergabeposition und setzt beim Start automatisch fort.

Mit aktiviertem Streams-Bildschirm spielt dieselbe Kopfeinheit auch Internetradiosender direkt über mobile Daten oder Wi-Fi ab - ohne separate Radio-App. Füge eine beliebige Radio-URL hinzu oder importiere einen kuratierten Senderkatalog vom Extensions-Bildschirm. Die angeheftete Mini-Steuerung zeigt den aktuellen ICY-Titelnamen, während die Senderliste sichtbar bleibt.

11. 📺 Medienzentrale auf einer Android-TV-Box

Installiere FastMediaSorter auf jeder Android-TV-Box (Xiaomi Mi Box, Nvidia Shield, Amazon Fire TV oder eine generische Android-Box). Verbinde dich über SMB mit einem Heim-NAS, füge Google Drive oder Dropbox hinzu, oder schließe einen USB-Stick an - alles aus einer App. Steuere den gesamten Ablauf mit einer Fernbedienung oder Bluetooth-Tastatur: das D-Pad bewegt den Fokus, OK öffnet Elemente, Zurück kehrt zur vorherigen Ebene zurück, und Rücktaste geht im Browser einen Ordner nach oben. Die farbigen Tasten der Fernbedienung sind gängigen Dateiaktionen zugeordnet (Rot = Löschen, Grün = Kopieren, Gelb = Verschieben, Blau = Umbenennen). Starte eine Vollbild-Diashow mit Hintergrundmusik auf dem Fernseher oder wechsle zur Audiowiedergabe mit Albumcover und Songtext. Kein Touchscreen erforderlich.

Dokumentation 📚

🗺️ Documentation Map / Карта документации: Alle Dokumente ansehen / Все документы

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

Maßgebliche Quellen (Single Source of Truth)

Die folgenden Dateien gelten als maßgebliche Quellen für nutzerrelevante Details:

Ausführliche Anleitungen sind in mehreren Sprachen verfügbar:

🇺🇸 English:

🇷🇺 Русский:

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

Technische Dokumentation / Entwicklerdokumentation:

Wear OS Begleiter ⌚

FastMediaSorter enthält eine vollwertige eigenständige Wear OS App und einen Handy-Begleiter, die für Smartwatch-Formfaktoren entwickelt wurden.

Medien, Netzwerkfreigaben und Dateiübertragung sind in der Vollversion der Uhr-App (direkte APK) enthalten. Die Google-Play-Version ist eine kleine Erstveröffentlichung - Rechner, Stoppuhr, Minispiel und Einstellungen; das Wear OS Portal kennzeichnet, was jede Version bietet.

Außerdem gibt es ein eigenes, kostenloses Watchface für Wear OS 6 und neuer: FastMediaSorter Watch Face. Es zeigt eine große Uhrzeit, das Datum, Wellen und driftende Partikel, Akkubalken und bis zu acht runde Buttons für FastMediaSorter-Kurzbefehle oder andere Uhrdaten; die Buttons erscheinen zusammen mit der FastMediaSorter Uhr-App. Installiere es aus Google Play direkt auf der Uhr (suche nach FastMediaSorter) oder öffne seine Seite auf der Uhr über die Wear-Einstellungen in der Handy-App.

Wear OS Dokumentation:

Build-Anleitung

Anforderungen

Build

  1. Klone das Repository:

     git clone https://github.com/SerZhyAle/FastMediaSorter_mob_v2.git
 cd FastMediaSorter_mob_v2
  2. Öffne das Projekt in Android Studio.
  3. Warte, bis die Gradle-Synchronisierung abgeschlossen ist.
  4. Starte die App auf einem Emulator oder einem physischen Gerät.

Bevorzugte Build-Befehle (Windows / PowerShell)

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

Erzeugte APKs 📦

Nach jedem erfolgreichen Build wird die erzeugte APK-Datei automatisch mit Zeitstempel in den DOWNLOADS-Ordner im Projektstamm kopiert. Dort findest du deinen gesamten Build-Verlauf.

Testen 🧪

FastMediaSorter v2 nutzt Maestro für End-to-End-Tests, um Qualität und Zuverlässigkeit der App sicherzustellen.

Schneller Testlauf

# 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) - External: install.ps1 is the Maestro installer
Invoke-WebRequest -Uri "https://get.maestro.mobile.dev/install.ps1" -OutFile install.ps1
.\install.ps1  # External: Maestro installer
Remove-Item install.ps1  # External: Maestro installer

# 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

Hinweis: Verwende NICHT npm install -g maestro-cli - das ist ein anderes, unabhängiges Paket!

Testsuiten

Dokumentation

CI/CD-Integration

Tests laufen bei jedem Push automatisch über GitHub Actions. Siehe .github/workflows/maestro-tests.yml.

Erste Schritte (Kurzanleitung) 🚀

  1. Einen Ordner (Ressource) hinzufügen:
    • Tippe auf dem Hauptbildschirm auf die Schaltfläche mit dem Plus-Symbol (+), um eine neue Ressource hinzuzufügen.
    • Wähle den Ressourcentyp (z. B. “Lokaler Ordner”).
    • Nutze das Scannen oder füge den Ordner manuell hinzu. Nach dem Hinzufügen erscheint er in der Liste auf dem Hauptbildschirm.
  2. Dateien ansehen:
    • Doppeltippe (oder halte gedrückt) auf die hinzugefügte Ressource in der Liste.
    • Der Browse-Bildschirm öffnet sich, wo du alle Mediendateien dieses Ordners als Liste oder Raster siehst.
    • Nutze die Schaltflächen im oberen Bereich zum Sortieren, Filtern oder Wechseln der Ansicht.
  3. Wiedergabe und Sortierung:
    • Tippe auf eine Datei, um sie im Vollbild-Player zu öffnen.
    • Nutze Wischen nach links/rechts oder Berührungszonen zur Navigation zwischen Dateien.
    • Für Operationen (Kopieren, Verschieben) nutze die entsprechenden Berührungszonen oder Schaltflächen im Bedienfeld.
  4. Zielordner konfigurieren (Destinations):
    • Lege in den Einstellungen im Tab “Destinations” bis zu 30 Ordner fest, die für das schnelle Sortieren verwendet werden.
    • Alternativ aktiviere “Is Destination” im Bearbeitungsbildschirm einer beliebigen Ressource, um sie zur Schnellsortierliste hinzuzufügen.
    • Danach erscheinen auf dem Player-Bildschirm Schaltflächen zum schnellen Kopieren oder Verschieben von Dateien in diese Ordner.

Technologie-Stack

Build-Version

Versionsformat: Y.YM.MDDH.Hmm (z. B. 2.60.1102.207 für 10.01.2026, 20:07 Uhr)

Siehe dev/CHANGELOG.md für ausführliche Release-Hinweise.

Mitwirken 🤝

Pull Requests sind willkommen. Für größere Änderungen eröffne bitte zuerst ein Issue, um zu besprechen, was du ändern möchtest.

Kontakt 📧

Lizenz 📄

Rechtliche Informationen zum Projekt: