YARGO

(Y)et (A)nother (R)etro (G)ames (O)rganizer

Quem coleciona retrogaming sabe que ter milhares de ficheiros não significa ter uma boa biblioteca. O verdadeiro desafio é transformar o caos numa coleção "curated" — selecionada, limpa e, acima de tudo, funcional.

📥 Ir diretamente para a secção de Transferências

De Colecionador para Colecionadores

Este projeto nasceu de uma necessidade pessoal. Ao tentar organizar a minha própria coleção de ROMs, deparei-me com uma frustração comum: mesmo utilizando as várias (e excelentes) soluções de código aberto e ferramentas gratuitas que a nossa comunidade disponibiliza, nenhuma delas produzia o resultado específico que eu procurava. Sentia falta de uma ferramenta que não se limitasse a validar ficheiros, mas que os organizasse de forma inteligente e adaptada ao hardware que usamos hoje. Percebi que, se eu tinha esta dificuldade, outros colecionadores poderiam sentir o mesmo. Por isso, decidi transformar a minha solução num projeto e partilhá-lo, pensando que alguém poderá ter uma visão de organização igual à minha.

Interface principal do YARGO
Simulação (Dry-Run) + Logs detalhados
Resultado final

Foco no Hardware: "The C64" e no "The Spectrum"

Se utilizas os computadores da Retro Games Ltd., já conheces bem as restrições do sistema. A imposição de um limite máximo de 255 elementos por diretoria torna a navegação impossível se a coleção não estiver devidamente estruturada.

Este projeto, desenvolvido em C#, resolve isto diretamente:

Filtro Inteligente: Usa a notação TOSEC para selecionar as diferentes versões de cada título;
Estruturação Automática: Organiza a coleção em subdiretorias que respeitam o limite de 255 ficheiros;

Evolução e Futuro

Embora nesta fase inicial a aplicação corra em ambiente Windows e suporte Português, Espanhol e Inglês, o plano de evolução já está traçado:

Novas Notações: Integração futura das notações GoodTools e No-Intro (NoDump);
Flexibilidade Técnica: Evolução para uma interface de linha de comandos (CLI) e, quem sabe, uma GUI multiplataforma;

Lançamento da Primeira Release

A primeira versão será disponibilizada assim que terminar a limpeza do código — para garantir que o projeto possa evoluir de forma saudável — e tenha o interface gráfico (GUI) concluído. Deixo já o aviso: o aspeto visual não será o mais profissional do mundo, pois a minha vocação não é o design de interfaces, mas a funcionalidade está lá!

O objetivo é simples: menos tempo a gerir pastas e mais tempo a carregar os teus jogos favoritos.

⚠️ Aviso Importante ⚠️

A utilização do YARGO requer algum cuidado. Embora a aplicação inclua um modo Dry‑Run que permite pré-visualizar todas as operações de forma segura, recomenda-se vivamente que seja efetuado um backup completo da coleção de ROMs antes de realizar qualquer operação real.

O YARGO nunca altera, move ou elimina ficheiros sem instruções explícitas do utilizador. No entanto, qualquer ferramenta que manipule grandes quantidades de ficheiros pode comportar riscos caso sejam selecionadas pastas incorretas ou opções inadequadas.

👉 Se Move Files estiver desativado, e Dry‑Run também estiver desativado, o comportamento por defeito é copiar os ficheiros para a pasta de destino.

Transferências

📥 yargo_v1.1.0-beta (2026-04-17)

Adicionado

Novo modo "Raw / Sem Convenção" para organização de ficheiros sem restrições.
Melhorias na interface e maior consistência entre todos os modos.
Novos utilitários internos para suportar futuras "Naming Conventions".

Alterado

Refatoração da lógica interna para melhor manutenção e clareza.
Maior consistência entre todos os modos de organização.
Atualização do manifesto e definições de DPI para melhor integração com o Windows.

Corrigido

Correção de vários casos extremos na deteção e filtragem de ficheiros.
Maior estabilidade ao processar coleções grandes de ROMs.
Pequenos ajustes de alinhamento e layout na interface.

Problemas Conhecidos

Alguns presets avançados continuam em desenvolvimento.
A documentação do novo modo Raw ainda não está completa.

📥 yargo_v1.0.0-beta (2026-03-31)