alanmugiwara/donazeteflix repository overview

⁠DonaZete Flix: Uma Netflix para Retro Gamers!

DonaZete Flix é uma distribuição customizada do RomM⁠: escaneia sua biblioteca de ROMs no disco, enriquece os metadados a partir de diversos provedores previamente habilitados, e entrega tudo em uma interface web para navegar, jogar, manter seu progresso, ter estimativas de tempo de gameplay, sistema moderno de conquistas e tudo isso sem instalar nada, rodando pelo navegador!

O nome Dona Zete é uma homenagem especial à dona de uma locadora de videogames da rua em que eu morava na infância e onde eu alugava cartuchos. Foi em lugares como aquele que muitos dos jogos que hoje fazem parte da minha coleção começaram a fazer parte da minha história. Dar esse nome ao projeto é uma forma de preservar não apenas os jogos, mas também uma pequena lembrança dessa época.

Mais do que uma customização do RomM, o DonaZete Flix é uma homenagem à experiência de descobrir e alugar videogames na infância, trazendo essa memória para uma biblioteca digital moderna, e é claro... tudo o mais matigado possível a respeito de configuração.

⁠Funcionalidades

• Biblioteca organizada: escaneia automaticamente sua pasta de ROMs e organiza por plataforma.
• Metadados ricos: integração com IGDB, ScreenScraper, MobyGames, SteamGridDB, RetroAchievements, LaunchBox, HowLongToBeat, Hasheous, PlayMatch e mais.
• Joague no navegador: emulação via EmulatorJS, RuffleRS (Flash) e js-dos direto na interface web.
• Saves na nuvem: upload e sync de saves, states e screenshots pela interface.
• Conquistas: acompanhamento de progresso no RetroAchievements.
• Multi-usuário: sistema de autenticação com suporte a OIDC e diferentes níveis de permissão.
• Pronto para Docker: imagem publicada no Docker Hub, configuração por variáveis de ambiente.

⁠Stack

• RomM⁠ - base do projeto (ROM manager + player)
• Python⁠ + FastAPI⁠ - backend
• Vue 3⁠ + Vite⁠ - frontend
• MariaDB⁠ - banco de dados
• Valkey/Redis⁠ - cache e filas de tarefas
• Docker⁠ ou Podman⁠ - empacotamento e deploy

⁠Deploy rápido com Docker Compose ou Podman Compose

⁠1. Baixe os arquivos de configuração

mkdir donazeteflix && cd donazeteflix
curl -O https://raw.githubusercontent.com/alanmugiwara/donazeteflix/main/app/docker-compose.yml
curl -o .env.exemple https://raw.githubusercontent.com/alanmugiwara/donazeteflix/main/app/.env.exemple

⁠2. Configure suas variáveis de ambiente

Renomeie o .env.exemple para .env e edite-o com suas credenciais:

## scrappers ##
SCREENSCRAPER_USER=seu-usuario
SCREENSCRAPER_PASSWD=sua-senha
SCREENSCRAPER_DEV_ID=seu-dev-id
SCREENSCRAPER_DEV_PASSWD=sua-dev-senha
RETROACHIEVEMENTS_API_KEY=sua-api-key
ROMM_AUTH_SECRET_KEY=gere-com-openssl-rand-hex-32
STEAMGRIDDB_API_KEY=sua-api-key
IGDB_CLIENT_ID=seu-client-id
IGDB_CLIENT_SECRET=seu-client-secret

## services ##
HLTB_API_ENABLED=true
MARIADB_ROOT_PASSWD=senha-root-forte
DB_PASSWD=senha-do-banco

## locations ##
DONAZETFLIX_LIBRARY=/caminho/para/sua/pasta/de/roms
DONAZETFLIX_ASSETS=donazetflix_assets
DONAZETFLIX_CONFIG=donazetflix_config

openssl rand -hex 32

⁠3. Entre no diretório do projeto e suba os containers

docker compose up -d

podmam-compose up -d

A interface estará disponível em http://localhost:8081.

⁠Estrutura de volumes

⁠Provedores de metadados habilitados por padrão

• IGDB
• ScreenScraper
• RetroAchievements
• SteamGridDB
• Hasheous
• PlayMatch
• LaunchBox
• HowLongToBeat (HLTB)

⁠Contato

⁠Licença

Este projeto é licenciado sob a GPL-3.0 License⁠.

DonaZete Flix é um fork do RomM⁠, que também é distribuído sob GPL-3.0.