Saltar a contenido

Datos y privacidad

Lo que se queda en tu ordenador

Todo lo que guarda ROMKADE Manager está en tu ordenador.

Con Docker, en el volumen romkade-data (montado en /data en el contenedor), más typesense-data para el índice de búsqueda. Desde el código fuente (macOS), en ~/Library/Application Support/AnbernicGameManager/.

Elemento Contenido
settings.json Ajustes de conexión (sin contraseña)
catalog.sqlite3 Catálogo, tiempo de juego, favoritos, descripciones, controles
save-backups/ Copias de tus partidas, una carpeta con fecha por copia
staging/ Juegos que se están preparando para copiar
cache/boxart/ Carátulas descargadas
llm.json, play_settings.json Elección de IA, alerta de tiempo de juego
secrets.json Solo Docker: contraseña de la consola y claves de API, legibles solo por la cuenta del contenedor

Secretos (contraseña de la consola, claves de API de IA y de YouTube):

  • con Docker, en secrets.json dentro del volumen: el llavero del sistema no es accesible desde un contenedor. No compartas una copia del volumen;
  • desde el código fuente, en el llavero de macOS, con el nombre de servicio anbernic-game-manager.

La API nunca los devuelve. La carpeta de datos conserva el antiguo nombre del proyecto, Anbernic Game Manager, para que las instalaciones existentes mantengan sus datos.

Lo que pasa por la red

  • Hacia la consola, por SSH en tu red local: la lectura de la tarjeta y los cambios que tú inicias.
  • Hacia Internet, solo para: las carátulas (miniaturas de libretro), los tráilers (YouTube, con tu clave) y las funciones de IA (el proveedor que hayas elegido, con tu clave). Con un modelo local, nada sobre tus juegos sale de tu ordenador.
  • Hacia ROMKADE: tu cuenta ROMKADE (inicio de sesión); las estadísticas de uso solo si las aceptas (desactivadas por defecto: pantallas, botones, versión de la aplicación e idioma, nunca títulos de juegos ni texto escrito); y, si vinculas tu consola a Claude o ChatGPT, lo que ROMKADE Cloud necesita: ver ROMKADE en Claude y ChatGPT.
  • Nunca: los juegos ni el contenido de tus partidas guardadas.

Todo el detalle está en la política de privacidad.

La interfaz solo responde en el propio ordenador (127.0.0.1) y rechaza las peticiones que vienen de otras webs abiertas en el navegador. Con Docker, el motor de búsqueda no tiene ningún puerto publicado: solo ROMKADE Manager llega a él.

Copia de seguridad

Lo más valioso es save-backups/, las copias de tus partidas.

En la carpeta romkade, el volumen se copia en un archivo comprimido de la carpeta actual:

docker compose down
docker run --rm -v romkade_romkade-data:/data -v "$PWD":/backup alpine tar czf /backup/romkade-data.tgz -C /data .
docker compose up -d

docker compose down
docker run --rm -v romkade_romkade-data:/data -v "${PWD}:/backup" alpine tar czf /backup/romkade-data.tgz -C /data .
docker compose up -d

Haz copia de la carpeta de datos junto con el resto del Mac: Time Machine la incluye.

Para restaurar con Docker: el mismo comando con tar xzf /backup/romkade-data.tgz -C /data, con el servicio detenido.

Desinstalar

  1. En la carpeta romkade: docker compose down y, después, borra la carpeta.
  2. Para eliminar también los datos: docker volume rm romkade_romkade-data romkade_typesense-data.
  3. Opcional: elimina las imágenes, docker image rm ghcr.io/romkade/romkade-manager typesense/typesense:27.1.
  1. Detén el servidor (Ctrl+C) y borra la carpeta romkade-manager.
  2. Para eliminar también los datos: borra ~/Library/Application Support/AnbernicGameManager/.
  3. Elimina el contenedor de búsqueda, si usaste Docker: docker rm -f agm-typesense.
  4. En Acceso a Llaveros, borra las entradas llamadas anbernic-game-manager.

No hay que quitar nada de la consola, salvo, si quieres, la carpeta .agm-backups/ de archivos reemplazados dentro de la carpeta de ROMs.

Opciones avanzadas

Variables de entorno. Con Docker, ponlas en un archivo .env junto a compose.yaml (por ejemplo ROMKADE_PORT=8780); desde el código fuente, defínelas antes de ./run.sh.

Variable Efecto
ROMKADE_PORT Docker: puerto de la interfaz en el ordenador (por defecto 8765)
ROMKADE_VERSION Docker: versión de la imagen que se usa (por defecto latest, por ejemplo 0.4.0)
TZ Docker: zona horaria del contenedor (por defecto Europe/Paris), usada para fechar las sesiones
AGM_TYPESENSE=0 Prescindir de Typesense y usar la búsqueda integrada
AGM_TYPESENSE_URL, AGM_TYPESENSE_KEY Usar otro servidor Typesense
AGM_NO_WATCH=1 Desactivar la vigilancia que vuelve a leer cada minuto las carpetas de consolas modificadas
AGM_NO_TRACKER=1 Desactivar el registro del tiempo de juego

La API local está documentada en http://localhost:8765/docs mientras ROMKADE Manager está en marcha.