Scraping
Baixe capas, screenshots e metadados dos seus jogos
O scraping preenche a sua gamelist com capas, screenshots, descrições, datas de lançamento e classificação. É a diferença entre uma lista de arquivos e uma visualização de biblioteca de verdade. O EmulationStation já vem com scraping embutido.
| Antes | Depois |
|---|---|
Super Mario World.sfc | arte completa de SNES + box + screenshot + descrição |
Configuração
Crie uma conta no ScreenScraper
Gratuita, obrigatória: registre-se em screenscraper.fr. O scraping anônimo é rate-limited a um filete, ter conta serve principalmente para rastrear as requisições.
Conecte seu handheld à internet
ES → System Settings → Network → ative o WiFi.
Abra o scraper
ES → Scraper (menu principal).
Login
Informe seu usuário e senha do ScreenScraper nos campos Username / Password.
Escolha o que baixar
Marque quais assets você quer: screenshots, capas (2D e/ou 3D), wheel logos, marquees, manuais, vídeos. Cada um adiciona bytes por jogo. Para uma biblioteca de 200 jogos, screenshots + box 2D + wheel é um padrão sensato.
Escolha quais sistemas
O scraper oferece seleção por sistema. Pule sistemas que não vão scrappear bem (ports do PortMaster, coleções customizadas).
Inicie
Pressione Start Scraper. O ES percorre a lista de sistemas. A parte lenta é o rate limit do ScreenScraper.
Recomendado para o tema padrão Art Book Next
Combine com as expectativas do tema para evitar thumbnails vazios:
| Configuração | Valor |
|---|---|
| Image Source | Screenshot (ou Box 2D para temas que priorizam capa) |
| Box Source | Box 2D |
| Logo Source | Wheel |
Veja themes para a tabela completa de combinações.
Durante o gameplay
O scraper consome bastante CPU e gera muita I/O de arquivos pequenos, não rode com um jogo aberto. Se você quer deixá-lo moendo 1000 jogos enquanto está ausente:
- Faça SSH (assim o ES não precisa manter a tela ligada).
- Pare o ES com
sudo systemctl stop emustation. - Infelizmente, o scraper interno do ES não roda com o ES parado, não existe scraper headless na build atual do ArchR.
- Mantenha o ES rodando mas trave a tela: no ES, System Settings → Screensaver Settings → defina timeout para 1 min e escolha o screensaver "Black". Plugue o carregador.
O ArchR pausa Syncthing/Tailscale/ZeroTier durante a emulação, mas não durante o scraping. Esses serviços continuam rodando, então scraping pesado + VPN ativa significa um pouco de contenção no WiFi.
Metadados manuais
Às vezes o ScreenScraper pega a região errada / título errado (ex.: imports JP). Edite por jogo:
ES → destaque o jogo → pressione Y (Edit Metadata) → corrija qualquer campo. Salvo em /storage/roms/<sistema>/gamelist.xml.
Se quiser editar em lote no PC, basta editar gamelist.xml diretamente com seu editor XML favorito, o ES pega as mudanças no rescan.
Backup antes do scraping
Sessões grandes de scraping batem no rate limit do ScreenScraper e podem deixar metadados pela metade se forem interrompidas. Antes de uma rodada longa, copie /storage/roms/<sistema>/gamelist.xml para um lugar seguro para poder reverter se não gostar do resultado.
ssh root@archr.local
cd /storage/roms/snes
cp gamelist.xml gamelist.backup.xml