---
id: TASK-7
title: Add ROM files and populate games library
status: To Do
assignee: []
created_date: '2026-02-24 07:14'
labels:
  - games
  - content
dependencies:
  - TASK-5
  - TASK-4
priority: medium
---

## Description

<!-- SECTION:DESCRIPTION:BEGIN -->
Once games are sourced (from task: Catalog desired retro games), upload ROMs to the games platform and register them in the database.

**Methods to add games:**
1. **Direct file copy:** SCP ROMs to /data/games/{platform}/ on Netcup, then register via API
2. **Upload API:** POST to /api/upload with ROM file
3. **Web UI:** Upload through the games platform interface

**For each game added:**
- Copy ROM to correct platform directory
- Add cover art if available
- Register in database with metadata (title, year, description, genre)
- Test that it loads in EmulatorJS
- Verify save states work

**Storage location on Netcup:** /data/games/{ps1,n64,snes,gba,gbc,nes,genesis,dreamcast,psp}/
<!-- SECTION:DESCRIPTION:END -->

## Acceptance Criteria
<!-- AC:BEGIN -->
- [ ] #1 At least 5 games uploaded and playable
- [ ] #2 Each game has cover art and metadata
- [ ] #3 EmulatorJS loads and runs each game
- [ ] #4 Save states work for at least one game per platform
- [ ] #5 Games appear correctly in the library browse page
<!-- AC:END -->
