Automatizar com Python: scripts para mudar o nome e organizar ficheiros

Três scripts Python prontos a usar para arrumar a pasta Transferências, mudar o nome de ficheiros em lote e arquivar os antigos, com execução agendada no Windows e no Linux.

Automatizar com Python: scripts para mudar o nome e organizar ficheiros

Uma das coisas mais úteis que se podem fazer com o Python, mesmo sendo iniciante, é automatizar os trabalhos repetitivos com ficheiros: arrumar uma pasta cheia de documentos, mudar o nome a centenas de fotografias, arquivar aquilo de que já não precisa. São tarefas que à mão demoram horas e com um script poucos segundos.

Neste guia encontra três scripts completos, prontos a copiar e adaptar, e as instruções para que sejam executados sozinhos a intervalos regulares.

Antes de começar: três regras de segurança

Um script que move ou muda o nome a ficheiros trabalha depressa, mesmo quando se engana. Por isso, todos os scripts deste guia seguem três regras:

  • Modo de teste: cada script tem uma variável DRY_RUN. Enquanto valer True, o script apenas mostra o que faria, sem mexer em nada. Faça sempre primeiro um teste e verifique a lista.
  • Nada é substituído: se no destino já existir um ficheiro com o mesmo nome, o script acrescenta um número ao nome em vez de o substituir.
  • Nada é apagado: os ficheiros são movidos, nunca eliminados.

Antes de usar um script numa pasta importante, faça mesmo assim um teste numa cópia.

A ferramenta: pathlib

Para trabalhar com ficheiros e pastas usamos o pathlib, um módulo incluído no Python: não é preciso instalar nada. Representa cada caminho como um objeto com propriedades práticas:

from pathlib import Path

file = Path.home() / "Documentos" / "relatorio.pdf"

print(file.name)     # relatorio.pdf
print(file.stem)     # relatorio
print(file.suffix)   # .pdf
print(file.parent)   # a pasta Documentos
print(file.exists()) # True se o ficheiro existir

O operador / junta as partes do caminho e funciona da mesma forma no Windows e no Linux. Path.home() indica a pasta do seu utilizador.

Script 1: arrumar a pasta Transferências por tipo de ficheiro

Este script distribui os ficheiros da pasta Transferências por subpastas (Imagens, Documentos, Arquivos comprimidos, etc.) com base na extensão.

from pathlib import Path
import shutil

FOLDER = Path.home() / "Downloads"
DRY_RUN = True  # True = só mostra o que faria; False = move mesmo

CATEGORIES = {
    "Imagens": {".jpg", ".jpeg", ".png", ".gif", ".webp", ".heic"},
    "Documentos": {".pdf", ".doc", ".docx", ".odt", ".txt", ".xlsx", ".pptx"},
    "Arquivos comprimidos": {".zip", ".rar", ".7z", ".tar", ".gz"},
    "Áudio e vídeo": {".mp3", ".wav", ".mp4", ".mkv", ".mov"},
    "Programas": {".exe", ".msi", ".deb", ".dmg"},
}


def category_for(extension):
    for name, extensions in CATEGORIES.items():
        if extension in extensions:
            return name
    return "Outros"


def free_path(path):
    """Se o ficheiro já existir, acrescenta (1), (2)... ao nome."""
    if not path.exists():
        return path
    n = 1
    while True:
        candidate = path.with_name(f"{path.stem} ({n}){path.suffix}")
        if not candidate.exists():
            return candidate
        n += 1


for file in list(FOLDER.iterdir()):
    if not file.is_file():
        continue  # ignorar as pastas
    folder = FOLDER / category_for(file.suffix.lower())
    destination = free_path(folder / file.name)
    print(f"{file.name}  ->  {folder.name}/{destination.name}")
    if not DRY_RUN:
        folder.mkdir(exist_ok=True)
        shutil.move(str(file), str(destination))

Como funciona:

  • CATEGORIES associa cada subpasta às extensões que deve conter. Pode acrescentar categorias ou extensões à vontade.
  • iterdir() lista o conteúdo da pasta. Transformamo-lo em lista com list() porque durante o ciclo movemos ficheiros e convém ter a lista completa desde o início.
  • suffix.lower() passa a extensão para minúsculas, para que .JPG e .jpg vão parar ao mesmo sítio.
  • shutil.move() move o ficheiro, mesmo entre discos diferentes.

Guarde o script como organize_downloads.py, execute-o uma primeira vez com DRY_RUN = True, verifique a lista e, se estiver tudo certo, mude o valor para False e volte a executá-lo.

Script 2: mudar o nome de ficheiros em lote com a data

Um clássico: uma pasta de fotografias ou documentos com nomes pouco claros, como IMG_4521.jpg. Este script acrescenta no início de cada nome a data da última modificação, no formato ano-mês-dia, para que os ficheiros fiquem ordenados cronologicamente por si só.

from datetime import datetime
from pathlib import Path
import re

FOLDER = Path.home() / "Pictures" / "Ferias"
DRY_RUN = True

ALREADY_DATED = re.compile(r"^\d{4}-\d{2}-\d{2}_")

for file in sorted(FOLDER.iterdir()):
    if not file.is_file() or ALREADY_DATED.match(file.name):
        continue  # ignorar pastas e ficheiros já renomeados
    date = datetime.fromtimestamp(file.stat().st_mtime).strftime("%Y-%m-%d")
    new = file.with_name(f"{date}_{file.name}")
    n = 1
    while new.exists():
        new = file.with_name(f"{date}_{file.stem} ({n}){file.suffix}")
        n += 1
    print(f"{file.name}  ->  {new.name}")
    if not DRY_RUN:
        file.rename(new)

Alguns pormenores:

  • st_mtime é a data da última modificação do ficheiro, fornecida pelo sistema operativo.
  • A expressão regular ALREADY_DATED reconhece os nomes que já começam por uma data. Assim pode voltar a executar o script sem acrescentar a data duas vezes.
  • strftime("%Y-%m-%d") formata a data como 2026-11-12. É o melhor formato para nomes de ficheiros, porque a ordem alfabética coincide com a cronológica.

Nas fotografias, a data de modificação nem sempre coincide com a data em que foram tiradas, por exemplo se foram copiadas de outro dispositivo. Nesse caso, a data exata está nos metadados EXIF da imagem, que podem ser lidos com a biblioteca Pillow: um bom exercício para um passo seguinte.

Script 3: arquivar os ficheiros mais antigos

Este script move para uma subpasta Arquivo todos os ficheiros que não são modificados há um certo número de dias. É útil para manter arrumadas pastas de trabalho como Transferências ou o Ambiente de Trabalho sem perder nada.

from pathlib import Path
import shutil
import time

FOLDER = Path.home() / "Downloads"
DAYS = 90
DRY_RUN = True

limit = time.time() - DAYS * 24 * 60 * 60
archive = FOLDER / "Arquivo"
moved = 0

for file in list(FOLDER.iterdir()):
    if file.is_file() and file.stat().st_mtime < limit:
        destination = archive / file.name
        n = 1
        while destination.exists():
            destination = archive / f"{file.stem} ({n}){file.suffix}"
            n += 1
        print(f"Arquivo: {file.name}")
        moved += 1
        if not DRY_RUN:
            archive.mkdir(exist_ok=True)
            shutil.move(str(file), str(destination))

print(f"Ficheiros a arquivar: {moved}")

time.time() devolve a hora atual em segundos; subtraindo 90 dias expressos em segundos, obtemos a data-limite. Os ficheiros modificados antes dessa data são movidos.

Executar os scripts

Os scripts usam apenas módulos incluídos no Python, por isso não é preciso instalar bibliotecas. Para os executar basta abrir o terminal na pasta onde os guardou:

# Windows
python organize_downloads.py

# Linux e macOS
python3 organize_downloads.py

Para trabalhar numa pasta diferente, altere o valor de FOLDER no início do script. No Windows pode também escrever um caminho completo, precedido da letra r para evitar problemas com as barras invertidas: FOLDER = Path(r"D:\Trabalho\Digitalizacoes").

Pô-los a funcionar automaticamente

Uma automatização dá o seu melhor quando nem sequer tem de se lembrar de a iniciar. Defina DRY_RUN = False só depois de verificar o script e, em seguida, agende a sua execução.

No Windows: Agendador de Tarefas

  • Abra o Agendador de Tarefas a partir do menu Iniciar e escolha Criar Tarefa Básica.
  • Dê um nome à tarefa e escolha quando executá-la, por exemplo todas as segundas-feiras de manhã.
  • Como ação escolha Iniciar um programa. Em Programa/script indique o caminho completo do Python, por exemplo C:\Script\.venv\Scripts\python.exe se usar um ambiente virtual; em Adicionar argumentos escreva o nome do script, por exemplo organize_downloads.py; em Iniciar em indique a pasta do script, por exemplo C:\Script.

Para um script que deva ser executado sem janela, pode usar pythonw.exe, que está na mesma pasta, em vez de python.exe.

No Linux: cron

Abra a lista de tarefas agendadas do seu utilizador com crontab -e e acrescente uma linha como esta, que executa o script todas as segundas-feiras às 9:00:

0 9 * * 1 /home/utilizador/script/.venv/bin/python /home/utilizador/script/organize_downloads.py >> /home/utilizador/script/log.txt 2>&1

A parte final guarda as mensagens do script num ficheiro de registo, útil para verificar o que foi feito. Use sempre caminhos completos: o cron não conhece a pasta em que normalmente trabalha.

Como continuar

Estes três scripts são uma base de partida. Algumas ideias para os alargar:

  • Passar a pasta como parâmetro na linha de comandos, com o módulo argparse, em vez de alterar o script.
  • Escrever um registo com o módulo logging, para guardar um histórico de cada movimentação.
  • Usar a data EXIF das fotografias com a biblioteca Pillow.
  • Enviar um resumo por e-mail ou através de um serviço de mensagens, talvez usando uma API.

Fontes oficiais

Partilhar

Qual é a sua reação?

Gosto Gosto 0
Não gosto Não gosto 0
Adoro Adoro 0
Divertido Divertido 0
Irritado Irritado 0
Triste Triste 0
Uau Uau 0