Add RetroPie configs backup from /opt/retropie/configs

키 설정·패드 매핑·에뮬 설정을 sync-configs.sh로 동기화.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
hoon
2026-09-01 01:41:18 +09:00
parent d1e986fac9
commit 27544f3057
189 changed files with 29732 additions and 34 deletions

View File

@@ -1,19 +1,54 @@
# RetroPie (레트로파이 Pi)
게임 ROM·BIOS·설정 정리. **ROM/BIOS는 Git에 올리지 않습니다** (용량·저작권).
게임 ROM·설정 백업. **ROM/BIOS는 Git에 올리지 않습니다** (용량·저작권).
## 경로
## 설정 파일은 어디?
RetroPie OS에서 **키 설정·패드 매핑·에뮬 설정**은 `~/RetroPie`가 아니라 **`/opt/retropie/configs/`** 에 있습니다.
| 경로 | 내용 |
|------|------|
| `/opt/retropie/configs/all/retroarch.cfg` | RetroArch 단축키·전역 설정 |
| `/opt/retropie/configs/all/retroarch-core-options.cfg` | 코어별 옵션 |
| `/opt/retropie/configs/all/retroarch/autoconfig/*.cfg` | 패드 자동 매핑 (Pro Controller, 8BitDo 등) |
| `/opt/retropie/configs/all/emulationstation/es_input.cfg` | EmulationStation 조이스틱 |
| `/opt/retropie/configs/all/emulationstation/es_settings.cfg` | ES 테마·UI |
| `/opt/retropie/configs/<시스템>/retroarch.cfg` | SNES, PSX, MSX 등 시스템별 오버라이드 |
| `/opt/retropie/configs/<시스템>/*.rmp` | 게임별 리맵 |
홈 심볼릭 링크:
- `~/.emulationstation``/opt/retropie/configs/all/emulationstation`
- `~/.config/retroarch``/opt/retropie/configs/all/retroarch`
## Git 저장소 구조
```
/home/hoon/projects/retropie/
├── configs/ ← /opt/retropie/configs 미러 (백업 대상)
├── RetroPie/
│ ├── roms/ # ~28GB — .gitignore
│ └── BIOS/ # .gitignore
├── RetroPie-Setup/ # upstream 설치 스크립트 (별도 git)
├── docs/ # 메모·추천 게임 목록
└── configs/ # retroarch 백업 등
├── RetroPie-Setup/ # upstream 설치 스크립트 — .gitignore
├── docs/
└── scripts/
└── sync-configs.sh
```
## RetroPie 표준 심볼릭 링크
## 설정 백업 → Git push
`~/.emulationstation` 등 홈의 `.xxx``/opt/retropie/...` 링크는 RetroPie OS 기본값입니다. 건드리지 않았습니다.
설정 바꾼 뒤:
```bash
cd /home/hoon/projects/retropie
./scripts/sync-configs.sh
git add configs/
git commit -m "backup configs"
git push
```
## 복원
```bash
rsync -av configs/ /opt/retropie/configs/
# 또는 sync-configs.sh의 SRC/DST를 반대로
```