Gerenciador de Arquivos do Kwiq

Acesso e Navegação

O Gerenciador de Arquivos pode ser acessado de várias formas:

• Pelo Kwiq Launcher: deslize para a esquerda na tela inicial para abrir o File Manager integrado.
• Como Activity independente: use o atalho kwiq_files na gaveta de apps para abrir o File Manager como um app separado, mesmo sem o Kwiq como launcher padrão.
• Pela busca global: digite / seguido do nome do arquivo ou pasta para buscar diretamente.
• No Modo Desktop: abra uma janela do File Manager pela taskbar ou menu Iniciar.

A navegação usa atalhos para pastas comuns (Downloads, Documentos, Imagens, Músicas, Vídeos, etc.) e breadcrumb para navegação hierárquica.

Modos de Visualização

O File Manager oferece 4 modos de visualização para se adaptar ao que você está fazendo:

Ordenação

Os arquivos podem ser ordenados por:

• Nome — ordem alfabética
• Modificado — data da última alteração (padrão)
• Criado — data de criação
• Tipo — agrupado por extensão

Em todos os modos, diretórios aparecem primeiro que arquivos, independentemente da ordenação escolhida.

Operações de Arquivo

Selecione um ou mais arquivos/pastas para realizar as seguintes operações:

Seleção múltipla: toque e segure em um item para entrar no modo de seleção, depois toque em outros itens para adicioná-los à seleção.

Edição de Texto e Markdown

O File Manager possui um editor de texto embutido que suporta:

• Arquivos .txt: leitura e edição simples (limite de 512 KB).
• Arquivos .md: leitura e edição de Markdown com visualização formatada.
• Salvar: as alterações são salvas diretamente no arquivo.

As notas Markdown criadas aqui também podem ser usadas como templates de colagem no Teclado IME do Kwiq (consulte a documentação do Teclado).

Galeria e Player de Mídia

O File Manager inclui recursos completos de mídia:

Galeria de Imagens

• Visualização em tela cheia com HorizontalPager (deslize entre imagens).
• Zoom por gestos de pinça.
• Suporte a formatos comuns (JPEG, PNG, WebP, GIF, etc.).

Player de Vídeo

• Reprodução via VideoView com controles de play/pause/seek.
• Tela cheia e suporte a múltiplos formatos.

Player de Áudio

• Fila de reprodução: adicione múltiplas faixas à fila.
• Controles: play/pause, pular faixa, seek (slider), shuffle.
• Progresso: barra de progresso atualizada a cada 250ms.
• Playlist: gerenciamento de playlist no diálogo do Media Player.

No modo Galeria, o File Manager escaneia recursivamente as pastas por imagens e vídeos. Pastas ocultas (que começam com .) ou com arquivo .nomedia são ignoradas.

Metadados (EXIF / ID3)

O Kwiq permite visualizar e editar metadados de arquivos de imagem e áudio:

• Imagens (EXIF): leitura e escrita de metadados EXIF via ExifInterface. Dados como data, câmera, GPS, resolução, etc.
• Áudio MP3 (ID3): leitura e escrita de tags ID3v2.4 via mp3agic. Inclui nome da faixa, artista, álbum, número da faixa, gênero, ano, capa do álbum (album art).
• Verificação: o método supportsMetadata(file) indica se o arquivo selecionado possui suporte a metadados.

Personalização de Pastas

Deixe suas pastas mais fáceis de identificar com:

• Cor de destaque (accent): escolha uma cor para a pasta se destacar na lista/grade.
• Badge (ícone): atribua um ícone de badge à pasta para identificá-la rapidamente.

Para personalizar uma pasta, abra o menu de contexto (toque longo) e selecione "Personalizar". As configurações são salvas por pasta, identificadas pelo caminho completo.

Arquivos Ocultos

O Kwiq segue a convenção Unix de arquivos ocultos:

1. Arquivos e pastas que começam com . (ponto) são considerados ocultos.
2. Por padrão, o File Manager não exibe arquivos ocultos.
3. Para mostrar/ocultar arquivos ocultos, use o botão de alternância no cabeçalho do File Manager (ícone de olho).
4. Para ocultar um arquivo ou pasta, use a opção "Ocultar" no menu de contexto — isso adiciona um ponto ao início do nome.
5. Para revelar, use a opção "Revelar" que remove o ponto do início do nome.
6. A galeria sempre ignora caminhos ocultos e pastas com arquivo .nomedia.

Armazenamento Remoto (FTP / WebDAV)

O Kwiq permite conectar-se a servidores remotos diretamente do File Manager:

Como configurar

1. Abra o File Manager e toque no ícone de "Armazenamento Remoto" (nuvem) no cabeçalho.
2. Toque em "Adicionar Servidor".
3. Escolha o protocolo (FTP ou WebDAV).
4. Preencha os dados: endereço do servidor, porta, usuário e senha.
5. Salve o perfil para uso futuro.

Após conectar, você pode navegar, transferir arquivos entre o dispositivo e o servidor, renomear, excluir e criar pastas remotas. Múltiplos perfis podem ser salvos para alternar rapidamente entre servidores.

ROM Patcher

O Kwiq inclui um aplicador de patches ROM para entusiastas de retrojogos. Ele permite aplicar patches em arquivos de ROM diretamente no dispositivo.

Formatos suportados

Como usar

1. Abra o RomPatcherActivity pelo menu do File Manager em um arquivo de patch.
2. Selecione o arquivo de patch (geralmente .ips, .ups, .bps, etc.).
3. Escolha a ROM original que receberá o patch.
4. Configure o destino onde a ROM patcheada será salva.
5. Opcional: ative a validação de checksums (CRC32, MD5, SHA1) para verificar integridade.
6. Aplique o patch. A engine processa e salva a nova ROM.

Modo Desktop e Self-Hosted

O File Manager se integra com outros recursos do Kwiq:

• Modo Desktop: o armazenamento interno do dispositivo aparece diretamente na janela do File Manager, sem pasta especial ou configuração extra.
• Servidor Auto-Hospedado: quando o servidor HTTP está ativo, o File Manager mostra o status (rodando/parado), exibe a URL e QR Code, e permite abrir as configurações do servidor diretamente.