26.10.09 14:52

FastMediaSorter v2 🚀

Kotlin Android License

📦 Download: Scaricalo su IzzyOnDroid

Installi l’APK direttamente? Android avvisa quando si tratta di un pacchetto che non ha mai visto prima - perché appare l’avviso e cosa toccare.

📘 Documentazione utente: guide passo passo per ogni funzionalità, con ricerca

Informazioni sul progetto

FastMediaSorter v2 è un guscio completo per un dispositivo Android. Prende il controllo della schermata Home, riproduce i tuoi contenuti multimediali, apre stream in diretta, avvia le tue app, comunica con il tuo smartwatch, tiene d’occhio il dispositivo e gestisce ogni file che possiedi - in cartelle locali, su unità di rete (SMB, SFTP, FTP) e in archivi cloud (Google Drive, OneDrive, Dropbox).

È costruito su otto pilastri: guscio del dispositivo, player multimediale, stream in diretta, avvio delle app, sostituto delle app di sistema, companion per lo smartwatch, monitoraggio del dispositivo e file manager completo. Ordinare i file da tutte queste fonti è il punto di partenza dell’app, ed è ancora la base su cui si costruisce il resto - ma non ne è più la totalità.

Questo manuale segue ora lo stesso vocabolario pubblico dell’inventario delle funzionalità canonico in FEATURES.md e della mappa della documentazione in DOCS_MAP.md. Usa queste due pagine come fonte di verità aggiornata per la storia dell’app, le edizioni disponibili e l’attuale superficie di funzionalità.

Versione Windows 🖥️

Cerchi una soluzione desktop? Dai un’occhiata a Fast Media Sorter & Sharing for Windows - un’applicazione Windows Forms leggera per ordinare, visualizzare e gestire rapidamente file immagine e video:

🔗 Fast Media Sorter & Sharing for Windows

📄 Come pubblicare le cartelle del PC su Android - condividi le cartelle del tuo PC con l’app tramite SFTP (importazione companion / scansione QR sul telefono).

Le funzionalità includono:

Sommario

Edizioni 🎯

FastMediaSorter v2 viene distribuito in sette edizioni - cinque per telefoni e tablet di uso quotidiano (Standard, Lite, Photos, Legacy, FOSS) più due build per visori e sideload, VR e noLegal. La griglia di funzionalità canonica è generata dalla build in FLAVOR_MATRIX.md:

Edizione Descrizione Note
Standard Versione completa Il set di funzionalità più ampio per media, documenti, OCR, traduzione e accesso cloud
Lite Versione leggera Solo file locali - video, audio e immagini; nessuna fonte di rete, cloud, documenti o Streams
Photos Versione incentrata sulle foto Solo immagini, con SMB/FTP/SFTP e cloud; nessun video e nessun audio
Legacy Versione orientata alla compatibilità Stesso set di funzionalità di Standard, incluso SMB/FTP/SFTP e cloud (Google Drive, Dropbox, OneDrive); realizzata per Android 6/7 (API 23+)
FOSS Versione per il catalogo F-Droid Nessun SDK proprietario: media locali, documenti, EPUB e SMB/FTP/SFTP; nessun cloud, nessun Streams, nessun OCR, nessuna traduzione e nessun Wear OS companion
VR Build per visori pulita per gli store Set multimediale completo per i visori; nessun Google Cast e nessun Wear OS companion
noLegal Build per sideload Tutto quello che c’è in Standard più il player immersivo OpenXR ed extra riservati al sideload

Quale edizione dovrei scaricare?

Per la disponibilità esatta delle funzionalità per edizione, usa la documentazione canonica:

🧭 Primo avvio: subito sotto il selettore della lingua, l’app ti permette di scegliere un profilo del dispositivo (telefono, tablet, TV, auto, cornice digitale, VR e altro) che personalizza le impostazioni di partenza per te - modificabile in qualsiasi momento nelle Impostazioni. Vedi Primo avvio: scegli il profilo del dispositivo.

Download 📥

📲 Scaricalo su Google Play

I file APK compilati NON sono conservati in questo repository GitHub. Tutte le build sono disponibili su Google Drive:

🔗 Scarica tutte le build da Google Drive

Edizione Nome file Descrizione
Standard FastMediaSorter_standard_release.zip Funzionalità complete (Cloud, OCR, EPUB, Traduzione)
Lite FastMediaSorter_lite_release.zip Solo media locali (Video, Audio, Immagini; nessuna rete, cloud, documenti o Streams)
Photos FastMediaSorter_photos_release.zip Solo immagini, con rete (SMB/FTP/SFTP) e cloud
Legacy FastMediaSorter_legacy_release.zip Stesse funzionalità di Standard, incluso rete (SMB/FTP/SFTP) e cloud; Android 6/7 (API 23+)

Nota: tutte le build vengono caricate automaticamente su Google Drive dopo una compilazione riuscita.

🔐 Password ZIP: 1 (i file APK sono confezionati in archivi ZIP protetti da password per aggirare le restrizioni di Google Drive)

Screenshot 📱

Schermata principale Azioni sui file Impostazioni
Vista del player    
   

Immagini a dimensione intera:

Funzionalità principali

Formati multimediali supportati 🎞️

FastMediaSorter v2 supporta un’ampia gamma di formati:

Scenari d’uso 💡

Ecco alcuni modi in cui FastMediaSorter v2 può aiutarti:

1. 📸 Organizzare le foto della fotocamera

Collega il tuo telefono o apri una cartella fotocamera locale. Configura una cartella di destinazione “Migliori foto”. Apri il visualizzatore, scorri rapidamente tra migliaia di foto e tocca il pulsante di destinazione per copiare istantaneamente gli scatti migliori.

2. 🏠 Backup di rete (NAS)

Aggiungi il tuo NAS domestico tramite SMB. Sfoglia i tuoi file multimediali locali. Seleziona più file o un intervallo e “spostali” sul tuo NAS per conservarli in sicurezza, liberando spazio sul dispositivo.

3. ☁️ Gestione del cloud

Collega il tuo account Google Drive, Dropbox o OneDrive. Sfoglia i tuoi file cloud senza scaricarli tutti. Elimina i file indesiderati o organizzali in cartelle direttamente nel cloud.

4. 📺 Presentazione e slideshow

Apri una cartella con foto di famiglia o diapositive di una presentazione. Premi “Riproduci” per avviare una presentazione. Usa le impostazioni per risorsa per regolare la durata delle diapositive a tuo piacimento.

5. ⭐ Gestire i preferiti

Contrassegna i file importanti con il pulsante a stella durante la navigazione. In seguito, tocca la scheda “Preferiti” nel menu principale per accedere istantaneamente a tutti i tuoi file preferiti di tutte le fonti in un unico posto - perfetto per creare una raccolta curata dei tuoi migliori contenuti multimediali.

6. 🎶 Presentazione con musica di sottofondo

Aggiungi la tua collezione musicale come risorsa. In Impostazioni → Media → Immagini, attiva “Riproduci musica durante la presentazione” e seleziona la tua risorsa musicale. Ora, quando avvii una presentazione delle tue foto, le tue tracce preferite verranno riprodotte in sottofondo. Tocca il nome della traccia per passare a un’altra canzone casuale, creando l’atmosfera perfetta per le tue presentazioni fotografiche.

7. 🖼️ Cornice digitale su un tablet

Trasforma qualsiasi tablet Android in una splendida cornice digitale sempre accesa. Posizionalo su un supporto, collegalo al tuo PC di casa (SMB) o all’archivio cloud - le foto vengono trasmesse in streaming direttamente senza occupare spazio di archiviazione locale. Regola l’intervallo delle diapositive, mantieni lo schermo sempre acceso, aggiungi musica di sottofondo e goditi i tuoi ricordi. Anche i vecchi tablet economici e lenti funzionano perfettamente per questo scopo - l’app è ottimizzata per la riproduzione continua a basse risorse.

8. 🍿 Cinema domestico e VR

Guarda la tua serie preferita conservata sul tuo PC o nel cloud direttamente sul telefono o sul visore VR. Nessuna attesa per la copia né preoccupazione per lo spazio libero. Basta premere play, e il prossimo episodio inizierà automaticamente.

Casi d’uso per i visori VR - FastMediaSorter funziona nativamente su visori VR basati su Android (Meta Quest, Pico e simili) senza alcuna modifica:

9. 🧹 Organizzatore dei download

Cartella Download disordinata? Aprila nel pannello sorgente, configura i pulsanti di destinazione per “Documenti”, “Immagini” e “Programmi di installazione”. Scorri rapidamente i file, visualizzali in anteprima e ordinali nei posti giusti con un solo tocco. Puoi persino ordinare i file direttamente sul tuo computer di rete usando il telefono come telecomando.

10. 🚗 Musica in auto con autoradio Android

Installa FastMediaSorter sulla tua autoradio o unità centrale Android. Aggiungi cartelle musicali da chiavetta USB o scheda SD - oppure usa la risorsa virtuale integrata Tutta la musica per accedere istantaneamente all’intera collezione senza alcuna configurazione. I pulsanti multimediali hardware (comandi al volante, manopole del volume) funzionano perfettamente tramite il servizio audio in background: play/pausa, traccia successiva/precedente, tutto senza toccare lo schermo. L’app ricorda la posizione di riproduzione e riprende automaticamente all’avvio.

Con la schermata Streams attivata, la stessa unità centrale riproduce anche stazioni radio Internet direttamente tramite dati mobili o Wi-Fi - senza bisogno di un’app radio separata. Aggiungi qualsiasi URL radio, oppure importa un catalogo di stazioni curato dalla schermata Estensioni. Il mini-controllo fisso mostra il nome della traccia ICY corrente mentre l’elenco delle stazioni resta visibile.

11. 📺 Media center su un box Android TV

Installa FastMediaSorter su qualsiasi box Android TV (Xiaomi Mi Box, Nvidia Shield, Amazon Fire TV o un box Android generico). Collegati a un NAS domestico tramite SMB, aggiungi Google Drive o Dropbox, oppure collega una chiavetta USB - tutto da un’unica app. Controlla l’intero flusso con un telecomando o una tastiera Bluetooth: il D-pad sposta il focus, OK apre gli elementi, Indietro torna al livello precedente e Backspace sale di una cartella nel browser. I pulsanti colorati del telecomando corrispondono alle azioni comuni sui file (Rosso = Elimina, Verde = Copia, Giallo = Sposta, Blu = Rinomina). Avvia una presentazione a schermo intero con musica di sottofondo sulla TV, oppure passa alla riproduzione audio con copertina dell’album e testi. Non è richiesto alcun touchscreen.

Documentazione 📚

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

🌐 Sito ufficiale: https://serzhyale.github.io/FastMediaSorter_mob_v2/

Fonti canoniche (Single Source of Truth)

I seguenti file devono essere considerati le fonti autorevoli per i dettagli rivolti all’utente:

Guide dettagliate sono disponibili in più lingue:

🇺🇸 English:

🇷🇺 Русский:

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

Technical / Developer Docs:

Companion Wear OS ⌚

FastMediaSorter include un’app Wear OS standalone completa e un companion per telefono progettati per il fattore di forma degli smartwatch.

Media, condivisioni di rete e trasferimento file sono nella versione completa dell’app per lo smartwatch (APK diretto). La versione Google Play è una piccola prima release - calcolatrice, cronometro, mini-gioco e impostazioni; il portale Wear OS indica cosa include ciascuna versione.

Esiste anche un quadrante separato e gratuito per Wear OS 6 e successivi: FastMediaSorter Watch Face. Mostra l’ora in grande, la data, onde e particelle alla deriva, barre della batteria e fino a otto pulsanti rotondi per le scorciatoie di FastMediaSorter o altri dati dello smartwatch; i pulsanti compaiono insieme all’app FastMediaSorter per lo smartwatch. Installalo da Google Play direttamente sullo smartwatch (cerca FastMediaSorter) oppure apri la sua pagina sullo smartwatch dalle impostazioni Wear nell’app del telefono.

Documentazione Wear OS:

Istruzioni di build

Requisiti

Compilazione

  1. Clona il repository:

     git clone https://github.com/SerZhyAle/FastMediaSorter_mob_v2.git
 cd FastMediaSorter_mob_v2
  2. Apri il progetto in Android Studio.
  3. Attendi che la sincronizzazione di Gradle sia completata.
  4. Esegui l’app su un emulatore o un dispositivo fisico.

Comandi di build preferiti (Windows / PowerShell)

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

APK compilati 📦

Dopo ogni build riuscita, il file APK generato viene copiato automaticamente nella cartella DOWNLOADS nella radice del progetto con un timestamp. Lì puoi trovare tutta la cronologia delle tue build.

Test 🧪

FastMediaSorter v2 usa Maestro per i test end-to-end per garantire la qualità e l’affidabilità dell’app.

Esecuzione rapida dei test

# 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

Nota: NON usare npm install -g maestro-cli - è un pacchetto diverso e non correlato!

Suite di test

Documentazione

Integrazione CI/CD

I test vengono eseguiti automaticamente a ogni push tramite GitHub Actions. Vedi .github/workflows/maestro-tests.yml.

Primi passi (Guida rapida all’uso) 🚀

  1. Aggiungere una cartella (risorsa):
    • Nella schermata principale, premi il pulsante con l’icona “Più” (+) per aggiungere una nuova risorsa.
    • Seleziona il tipo di risorsa (ad es. “Cartella locale”).
    • Usa la scansione oppure aggiungi la cartella manualmente. Dopo l’aggiunta, comparirà nell’elenco nella schermata principale.
  2. Visualizzare i file:
    • Tocca due volte (o tieni premuto) sulla risorsa aggiunta nell’elenco.
    • Si aprirà la schermata di navigazione, dove vedrai tutti i file multimediali di questa cartella come elenco o griglia.
    • Usa i pulsanti sul pannello superiore per ordinare, filtrare o cambiare visualizzazione.
  3. Riproduzione e ordinamento:
    • Tocca qualsiasi file per aprirlo nel player a schermo intero.
    • Usa gli scorrimenti a sinistra/destra o le zone touch per navigare tra i file.
    • Per le operazioni (copia, spostamento), usa le zone touch corrispondenti o i pulsanti sul pannello di controllo.
  4. Configurare le cartelle di destinazione (Destinazioni):
    • Nelle impostazioni, nella scheda “Destinazioni”, puoi specificare fino a 30 cartelle da usare per l’ordinamento rapido.
    • In alternativa, attiva “È destinazione” nella schermata di modifica di qualsiasi risorsa per aggiungerla all’elenco di ordinamento rapido.
    • Dopo di che, sulla schermata del player compariranno i pulsanti per copiare o spostare rapidamente i file in queste cartelle.

Stack tecnologico

Versione della build

Formato della versione: Y.YM.MDDH.Hmm (ad es., 2.60.1102.207 per il 10/01/2026 20:07)

Vedi dev/CHANGELOG.md per le note di rilascio dettagliate.

Contribuire 🤝

Le pull request sono benvenute. Per modifiche importanti, apri prima una issue per discutere cosa vorresti cambiare.

Contatti 📧

Licenza 📄

Informazioni legali del progetto: