Lista de pastas e ficheiros

Sobre a ferramenta de lista de pastas e ficheiros

Tirar os nomes de uma pasta é estranhamente difícil. Os ficheiros estão ali, à vista, mas se os selecionar e carregar em Ctrl+C copia os próprios ficheiros, não os nomes. As saídas habituais são a linha de comandos (dir /b > lista.txt), um script batch, ou instalar um programa. Esta ferramenta resolve isso numa página web: escolha uma pasta, receba a lista, carregue em Copiar.

É você que decide o que entra — pastas, ficheiros ou ambos — e se deve entrar nas subpastas ou ficar pelo primeiro nível. O resultado é texto simples para colar onde quiser, ou um CSV que abre no Excel.

A sua pasta é lida dentro do navegador. Nada é enviado, e a ferramenta apenas lê — não consegue mudar nomes, mover nem apagar seja o que for.

Como usar

• Carregue em Escolher uma pasta e selecione a que quer listar. O navegador vai pedir-lhe autorização para a ler
• Marque o que quiser — Pastas, Ficheiros e Incluir subpastas para tudo o que esteja por baixo
• Escolha um formato — nomes, caminhos completos, uma árvore, CSV ou uma lista Markdown
• Carregue em Copiar para pôr a lista na área de transferência, ou em Transferir a lista para a guardar como ficheiro

As três caixas

• Pastas — incluir os nomes das subpastas. Desmarque se só quiser uma lista de ficheiros
• Ficheiros — incluir os ficheiros. Desmarque para obter apenas a lista das subpastas
• Incluir subpastas — desmarcada dá-lhe só o que está diretamente dentro da pasta escolhida; marcada percorre a árvore toda, por mais funda que seja

Combinam-se livremente: Pastas ligado, Ficheiros desligado, subpastas ligado dá a estrutura completa sem o ruído dos ficheiros. Pastas desligado, Ficheiros ligado, subpastas desligado dá os nomes dos ficheiros de uma única pasta, mais nada.

Cinco formatos de saída

• Apenas nomes — ferias-01.jpg, um por linha. O que a maioria quer para colar nomes de ficheiros num documento ou num formulário
• Caminhos completos — 2024/verao/ferias-01.jpg, para distinguir os repetidos e ver onde está cada ficheiro
• Árvore — um diagrama indentado com ramos ├── e └──, tal como os programadores mostram a estrutura de um projeto num README
• CSV — nome, tipo, caminho e, se quiser, tamanho e data, em colunas. Abre diretamente no Excel, no Google Sheets ou no Numbers
• Lista Markdown — - nomedoficheiro, pronta a colar num README, numa página de wiki ou num issue do GitHub

Marque Mostrar tamanho e Mostrar data para os acrescentar a qualquer formato. No CSV tornam-se colunas próprias; nos restantes aparecem entre parênteses.

Reduzir a lista

• Apenas estes tipos — escreva jpg, png para listar só imagens, ou pdf para só PDF. Os pontos são opcionais e maiúsculas ou minúsculas não interessam. As pastas nunca são filtradas por aqui
• Ordenar por — nome, caminho, tamanho (maiores primeiro), data (mais recentes primeiro) ou tipo de ficheiro. As pastas vêm antes dos ficheiros, exceto na ordenação por caminho, que mantém intacta a ordem da árvore

Para que serve

• Colar uma lista de nomes de ficheiros num e-mail, numa folha de cálculo ou num formulário
• Fazer um inventário de uma pasta de fotografias, música ou documentos antes de a arquivar
• Produzir a árvore de um projeto para um README ou para documentação
• Ver o que está mesmo dentro de uma cópia de segurança sem abrir pasta a pasta
• Construir um CSV de ficheiros com tamanhos para descobrir o que está a encher um disco
• Entregar a um cliente ou a um colega a lista do que foi entregue

Duas formas de o navegador ler uma pasta

Vale a pena dizê-lo com franqueza, porque as duas não se comportam da mesma maneira.

O Chrome, o Edge e o Opera têm um seletor de pastas a sério. A ferramenta percorre a pasta por si própria, por isso vê as subpastas vazias, e quando Incluir subpastas está desmarcado não as abre mesmo. Concede acesso de leitura àquela pasta apenas, e só enquanto a página estiver aberta.

O Firefox e o Safari usam o antigo controlo de carregamento de pastas. O navegador entrega todos os ficheiros da árvore de uma vez, e a estrutura é deduzida a partir dos caminhos. Daí duas consequências: uma pasta vazia não pode aparecer, porque nenhum ficheiro revela que existe, e a árvore inteira é lida mesmo que só tenha pedido o primeiro nível. O resto funciona igual. A ferramenta avisa no ecrã quando segue por este caminho.

Bom saber

• Nada é enviado. Não há servidor nenhum envolvido na leitura da sua pasta — pode acompanhar o separador de rede, se quiser
• A ferramenta tem acesso apenas de leitura. Não consegue criar, mudar o nome, mover nem apagar coisa alguma
• Ficheiros ocultos e de sistema aparecem se o navegador os expuser; algumas pastas (como as pastas de sistema do Windows) são recusadas pelo próprio navegador
• Pastas muito grandes são limitadas a 200 000 itens para a página não bloquear — é avisado se a lista tiver sido cortada
• Os tamanhos e as datas vêm do sistema de ficheiros, por isso coincidem com o que o seu explorador mostra
• As transferências CSV incluem uma marca de ordem de bytes, para que nomes acentuados ou não latinos abram corretamente no Excel

Ferramentas relacionadas

• Ordenar e alfabetizar lista — reordenar a lista que acabou de copiar
• Remover linhas duplicadas — limpar uma lista de nomes de ficheiros
• Comparar duas listas — ver o que mudou entre duas listagens da pasta
• Coluna para lista separada por vírgulas — transformar a lista numa única linha