26.10.09 14:52

FastMediaSorter v2 🚀

Kotlin Android License

📦 Baixar: Get it on IzzyOnDroid

Instalando o APK diretamente? O Android avisa sobre um pacote que nunca viu antes - por que o aviso aparece e o que tocar.

📘 Documentação do usuário: guias passo a passo para cada funcionalidade, com busca

Sobre o Projeto

FastMediaSorter v2 é um shell completo para um dispositivo Android. Ele assume a tela inicial, reproduz suas mídias, abre transmissões ao vivo, inicia seus aplicativos, conversa com seu relógio, monitora o dispositivo e gerencia todos os arquivos que você possui - em pastas locais, em unidades de rede (SMB, SFTP, FTP) e em armazenamento na nuvem (Google Drive, OneDrive, Dropbox).

Ele é construído sobre oito pilares: shell de dispositivo, player de mídia, transmissões ao vivo, inicialização de aplicativos, um substituto para os aplicativos padrão, um companion no relógio, monitoramento do dispositivo e um gerenciador de arquivos completo. Organizar arquivos entre todas essas fontes foi onde o aplicativo começou, e ainda é a base sobre a qual o restante foi construído - mas não é mais tudo o que ele faz.

Este manual agora segue o mesmo vocabulário público do inventário canônico de funcionalidades em FEATURES.md e do mapa de documentação em DOCS_MAP.md. Use essas duas páginas como a fonte de verdade atual para a história do app, edições disponíveis e o conjunto de funcionalidades atual.

Versão para Windows 🖥️

Procurando uma solução para desktop? Confira o Fast Media Sorter & Sharing for Windows - um aplicativo leve em Windows Forms para organizar, visualizar e gerenciar rapidamente arquivos de imagem e vídeo:

🔗 Fast Media Sorter & Sharing for Windows

📄 Como publicar pastas do PC no Android - compartilhe as pastas do seu PC com o app via SFTP (importação por companion / leitura de QR no telefone).

Recursos incluem:

Índice

Edições 🎯

O FastMediaSorter v2 é lançado em sete edições - cinco para celulares e tablets do dia a dia (Standard, Lite, Photos, Legacy, FOSS) mais duas versões para headset e sideload, VR e noLegal. A grade canônica de recursos é gerada a partir do build em FLAVOR_MATRIX.md:

Edição Descrição Notas
Standard Versão completa Conjunto de recursos mais amplo para mídia, documentos, OCR, tradução e acesso à nuvem
Lite Versão leve Somente arquivos locais - vídeo, áudio e imagens; sem fontes de rede, nuvem, documentos ou Streams
Photos Versão focada em fotos Somente imagens, com SMB/FTP/SFTP e nuvem; sem vídeo e sem áudio
Legacy Versão focada em compatibilidade Mesmo conjunto de recursos do Standard, incluindo SMB/FTP/SFTP e nuvem (Google Drive, Dropbox, OneDrive); feita para Android 6/7 (API 23+)
FOSS Versão do catálogo F-Droid Sem SDKs proprietários: mídia local, documentos, EPUB e SMB/FTP/SFTP; sem nuvem, sem Streams, sem OCR, sem tradução e sem companion do Wear OS
VR Versão para headset limpa para lojas Conjunto completo de mídia para headsets; sem Google Cast e sem companion do Wear OS
noLegal Versão para sideload Tudo do Standard mais o player imersivo OpenXR e extras exclusivos de sideload

Qual Edição Devo Baixar?

Para a disponibilidade exata de recursos por edição, use a documentação canônica:

🧭 Primeira execução: logo abaixo do seletor de idioma, o app permite que você escolha um perfil de dispositivo (celular, tablet, TV, carro, porta-retrato, VR e mais) que ajusta os padrões iniciais para você - alterável a qualquer momento nas Configurações. Veja Primeira Execução: Escolha Seu Perfil de Dispositivo.

Baixar 📥

📲 Consiga na Google Play

Os arquivos APK compilados NÃO são armazenados neste repositório do GitHub. Todas as versões estão disponíveis no Google Drive:

🔗 Baixar Todas as Versões do Google Drive

Edição Nome do Arquivo Descrição
Standard FastMediaSorter_standard_release.zip Recursos completos (Nuvem, OCR, EPUB, Tradução)
Lite FastMediaSorter_lite_release.zip Somente mídia local (Vídeos, Áudio, Imagens; sem rede, nuvem, documentos ou Streams)
Photos FastMediaSorter_photos_release.zip Somente imagens, com rede (SMB/FTP/SFTP) e nuvem
Legacy FastMediaSorter_legacy_release.zip Mesmos recursos do Standard, incluindo rede (SMB/FTP/SFTP) e nuvem; Android 6/7 (API 23+)

Observação: Todas as versões são enviadas automaticamente ao Google Drive após a compilação bem-sucedida.

🔐 Senha do ZIP: 1 (os arquivos APK são compactados em arquivos ZIP protegidos por senha para contornar as restrições do Google Drive)

Capturas de Tela 📱

Tela Principal Ações de Arquivo Configurações
Visualização do Player    
   

Imagens em tamanho completo:

Principais Funcionalidades

Formatos de Mídia Suportados 🎞️

O FastMediaSorter v2 é compatível com uma ampla variedade de formatos:

Cenários de Uso 💡

Aqui estão algumas maneiras pelas quais o FastMediaSorter v2 pode ajudar você:

1. 📸 Organizando Fotos da Câmera

Conecte seu telefone ou abra uma pasta local da câmera. Configure uma pasta de destino “Melhores Fotos”. Abra o visualizador, deslize rapidamente por milhares de fotos e toque no botão de destino para copiar instantaneamente as melhores capturas.

2. 🏠 Backup de Rede (NAS)

Adicione seu NAS doméstico via SMB. Navegue pelos seus arquivos de mídia locais. Selecione vários arquivos ou um intervalo e “Mova-os” para o seu NAS para guardá-los com segurança, liberando espaço no seu dispositivo.

3. ☁️ Gerenciamento na Nuvem

Conecte sua conta do Google Drive, Dropbox ou OneDrive. Navegue pelos seus arquivos na nuvem sem precisar baixar tudo. Exclua arquivos indesejados ou organize-os em pastas diretamente na nuvem.

4. 📺 Slideshow e Apresentação

Abra uma pasta com fotos de família ou slides de apresentação. Toque em “Reproduzir” para iniciar um slideshow. Use as configurações por recurso para ajustar a duração dos slides como preferir.

5. ⭐ Gerenciando Favoritos

Marque arquivos importantes com o botão de estrela durante a navegação. Depois, toque na aba “Favoritos” no menu principal para acessar instantaneamente todos os seus arquivos favoritos de todas as fontes em um só lugar - perfeito para criar uma coleção selecionada das suas melhores mídias.

6. 🎶 Slideshow com Música de Fundo

Adicione sua coleção de músicas como um recurso. Em Configurações → Mídia → Imagens, ative “Tocar música durante o slideshow” e selecione seu recurso de música. Agora, ao iniciar um slideshow das suas fotos, suas faixas favoritas tocarão em segundo plano. Toque no nome da faixa para pular para outra faixa aleatória, criando o ambiente perfeito para suas apresentações de fotos.

7. 🖼️ Porta-Retrato Digital em um Tablet

Transforme qualquer tablet Android em um lindo porta-retrato digital sempre ligado. Coloque-o em um suporte, conecte-o ao seu PC doméstico (SMB) ou ao armazenamento na nuvem - as fotos são transmitidas diretamente sem ocupar nenhum armazenamento local. Ajuste o intervalo dos slides, mantenha a tela sempre ligada, adicione música de fundo e aproveite suas memórias. Até tablets antigos e lentos de entrada funcionam perfeitamente para esse fim - o app é otimizado para reprodução contínua com poucos recursos.

8. 🍿 Cinema em Casa e VR

Assista às suas séries favoritas armazenadas no seu PC ou na nuvem diretamente no seu telefone ou headset de VR. Sem precisar esperar a cópia terminar ou se preocupar com espaço livre. Basta apertar o play, e o próximo episódio começará automaticamente.

Casos de Uso em Headset de VR - O FastMediaSorter roda nativamente em headsets de VR baseados em Android (Meta Quest, Pico e similares) sem nenhuma modificação:

9. 🧹 Organizador de Downloads

Pasta de Downloads bagunçada? Abra-a no painel de fontes, configure botões de destino para “Documentos”, “Imagens” e “Instaladores”. Percorra rapidamente os arquivos, visualize-os e organize-os nos lugares certos com um único toque. Você pode até organizar arquivos diretamente no seu computador de rede usando o telefone como controle remoto.

10. 🚗 Música no Carro com Central Multimídia Android

Instale o FastMediaSorter na sua central multimídia ou rádio automotivo com Android. Adicione pastas de música de um pendrive USB ou cartão SD - ou use o recurso virtual integrado Toda a Música para acessar instantaneamente toda a sua coleção sem nenhuma configuração. Os botões físicos de mídia (controles do volante, botões de volume) funcionam perfeitamente pelo serviço de áudio em segundo plano: play/pause, próxima/anterior faixa, tudo sem tocar na tela. O app lembra a posição de reprodução e retoma automaticamente na inicialização.

Com a tela Streams ativada, a mesma central multimídia também toca estações de rádio pela internet diretamente via dados móveis ou Wi-Fi - sem precisar de um app de rádio separado. Adicione qualquer URL de rádio, ou importe um catálogo de estações selecionado a partir da tela Extensions. O mini-controle fixo mostra o nome da faixa ICY atual enquanto a lista de estações permanece visível.

11. 📺 Central de Mídia em uma Android TV Box

Instale o FastMediaSorter em qualquer Android TV box (Xiaomi Mi Box, Nvidia Shield, Amazon Fire TV ou uma box Android genérica). Conecte-se a um NAS doméstico via SMB, adicione Google Drive ou Dropbox, ou conecte um pendrive USB - tudo em um único app. Controle todo o fluxo com um controle remoto ou teclado Bluetooth: o D-pad move o foco, OK abre os itens, Back volta ao nível anterior e Backspace sobe uma pasta no navegador. Os botões coloridos do controle remoto correspondem a ações comuns de arquivo (Vermelho = Excluir, Verde = Copiar, Amarelo = Mover, Azul = Renomear). Inicie um slideshow em tela cheia com música de fundo na TV, ou mude para a reprodução de áudio com capa do álbum e letras. Nenhuma tela sensível ao toque é necessária.

Documentação 📚

🗺️ Mapa da Documentação: Ver todos os documentos

🌐 Site Oficial: https://serzhyale.github.io/FastMediaSorter_mob_v2/

Fontes Canônicas (Fonte Única da Verdade)

Os arquivos a seguir devem ser tratados como as fontes oficiais para detalhes voltados ao usuário:

Guias detalhados estão disponíveis em vários idiomas:

🇺🇸 Inglês:

🇷🇺 Русский:

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

Documentação Técnica / para Desenvolvedores:

Companion Wear OS ⌚

O FastMediaSorter inclui um app Wear OS independente e completo, além de um companion para o telefone, projetado para o formato de smartwatches.

Mídia, compartilhamentos de rede e transferência de arquivos estão na versão completa do app do relógio (APK direto). A versão da Google Play é um pequeno primeiro lançamento - calculadora, cronômetro, minijogo e configurações; o portal do Wear OS indica o que cada versão tem.

Há também um mostrador de relógio separado e gratuito para Wear OS 6 e versões mais recentes: FastMediaSorter Watch Face. Ele mostra a hora em tamanho grande, a data, ondas e partículas à deriva, barras de bateria e até oito botões redondos para atalhos do FastMediaSorter ou outros dados do relógio; os botões aparecem junto com o app do FastMediaSorter para o relógio. Instale-o pela Google Play no próprio relógio (procure por FastMediaSorter) ou abra a página dele no relógio pelas configurações do Wear no app do telefone.

Documentação do Wear OS:

Instruções de Build

Requisitos

Build

  1. Clone o repositório:

     git clone https://github.com/SerZhyAle/FastMediaSorter_mob_v2.git
 cd FastMediaSorter_mob_v2
  2. Abra o projeto no Android Studio.
  3. Aguarde a sincronização do Gradle terminar.
  4. Execute o app em um emulador ou dispositivo físico.

Comandos de Build Preferidos (Windows / PowerShell)

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

APKs Gerados 📦

Após cada build bem-sucedido, o arquivo APK gerado é copiado automaticamente para a pasta DOWNLOADS na raiz do projeto, com uma marca de data/hora. Você pode encontrar todo o seu histórico de builds lá.

Testes 🧪

O FastMediaSorter v2 usa o Maestro para testes de ponta a ponta, garantindo a qualidade e a confiabilidade do app.

Execução Rápida de Testes

# 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: NÃO use npm install -g maestro-cli - esse é um pacote diferente e sem relação!

Conjuntos de Testes

Documentação

Integração CI/CD

Os testes são executados automaticamente a cada push via GitHub Actions. Veja .github/workflows/maestro-tests.yml.

Primeiros Passos (Guia Rápido de Uso) 🚀

  1. Adicionando uma Pasta (Recurso):
    • Na tela principal, toque no botão com o ícone de “Mais” (+) para adicionar um novo recurso.
    • Selecione o tipo de recurso (por exemplo, “Pasta Local”).
    • Use a varredura ou adicione a pasta manualmente. Depois de adicionada, ela aparecerá na lista da tela principal.
  2. Visualizando Arquivos:
    • Toque duas vezes (ou toque e segure) no recurso adicionado na lista.
    • A tela de navegação será aberta, onde você verá todos os arquivos de mídia dessa pasta em lista ou grade.
    • Use os botões do painel superior para ordenar, filtrar ou alternar a visualização.
  3. Reprodução e Organização:
    • Toque em qualquer arquivo para abri-lo no player em tela cheia.
    • Use deslizes para a esquerda/direita ou as zonas de toque para navegar entre os arquivos.
    • Para operações (copiar, mover), use as zonas de toque correspondentes ou os botões do painel de controle.
  4. Configurando Pastas de Destino (Destinos):
    • Nas configurações, na aba “Destinos”, você pode definir até 30 pastas que serão usadas para organização rápida.
    • Como alternativa, ative “É Destino” na tela de edição de qualquer recurso para adicioná-lo à lista de organização rápida.
    • Depois disso, botões para copiar ou mover arquivos rapidamente para essas pastas aparecerão na tela do player.

Stack Tecnológico

Versão do Build

Formato da versão: Y.YM.MDDH.Hmm (por exemplo, 2.60.1102.207 para 10/01/2026 20:07)

Veja dev/CHANGELOG.md para notas de lançamento detalhadas.

Contribuindo 🤝

Pull requests são bem-vindos. Para mudanças maiores, abra primeiro uma issue para discutir o que você gostaria de alterar.

Contato 📧

Licença 📄

Informações legais do projeto: