{"id":26315259,"url":"https://github.com/theflyingape/retroarch","last_synced_at":"2025-03-15T12:17:58.090Z","repository":{"id":173678311,"uuid":"650582801","full_name":"theflyingape/RetroArch","owner":"theflyingape","description":"my digital content, configurations, and scripts in support of retrogaming from 1976","archived":false,"fork":false,"pushed_at":"2024-12-30T12:32:04.000Z","size":47620,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-14T23:43:11.648Z","etag":null,"topics":["emulator-launcher","retrocomputing","retrogaming"],"latest_commit_sha":null,"homepage":"https://robert.hurst-ri.us/rob/retrocomputing","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"cc0-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theflyingape.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-07T11:26:01.000Z","updated_at":"2024-12-30T12:32:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"3a13aa9c-51b7-48f5-b014-37c50ce7d606","html_url":"https://github.com/theflyingape/RetroArch","commit_stats":null,"previous_names":["theflyingape/retroarch"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theflyingape%2FRetroArch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theflyingape%2FRetroArch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theflyingape%2FRetroArch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theflyingape%2FRetroArch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theflyingape","download_url":"https://codeload.github.com/theflyingape/RetroArch/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243725636,"owners_count":20337670,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["emulator-launcher","retrocomputing","retrogaming"],"created_at":"2025-03-15T12:17:57.382Z","updated_at":"2025-03-15T12:17:58.083Z","avatar_url":"https://github.com/theflyingape.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⛔ 🪙 → 🖱️ ⌨️ 🎮 → RetroArch → 🕹️ 🛸 👾 📺\n\n\u003e _My harvesting and personal contributions of digital content in support of retrogaming / [retrocomputing](https://robert.hurst-ri.us/rob/retrocomputing) from **1976**_\n\nDigital content is accessible out of my ☁️ Drive [📚 Bookshelf](https://drive.google.com/drive/folders/1IzpFmpW07yRvnkVU7aJVFchlY1OpmDS2?usp=drive_link) and [💿💾 Retro](https://drive.google.com/drive/folders/1DspvB89066kRyLET83xgrOT3VGT6IpBz?usp=drive_link) folders.\n\n## Boot image\n\nSince November 2021, select digital content pulled off of my Drive folder to make this into a plug \u0026 play **RetroArch** configuration that loads from a Debian 12 [Bookworm boot image](https://www.raspberrypi.com/software/operating-systems/#raspberry-pi-os-64-bit) for a user \u0026 developer friendly 🍓 Raspberry Pi 4/400 or Pi 5 desktop (or console).\n\nIn addition to my custom themes alongside the command-line Playlists frontend to launch an exhaustive list of content out of RetroArch, a more targeted, comprehensive list of top games using **Emulation Station** is efficiently integrated for its multiple gaming console themes and modern kiosk look \u0026 feel experiences.\n\n```bash\n$ lsblk -S  # find your target device NAME (NVME drive, SD card, USB stick)\n$ xzcat RA-playlists-rpi.img.xz | sudo dd of=/dev/[NAME] bs=4k status=progress\n$ sync\n```\n\nIts first boot may take a little longer – _be patient_. Once that has settled, configure your **network**, **sound**, and connect any **bluetooth** devices using the system panel controls.\n\nBoth desktop and console auto login as user `pi` with password `Freedom`\n\n### Technical Layout\n\nThis RetroArch configuration is designed to be ‘plug \u0026 play’. And while it allows for some flexibility to make some runtime modifications, it returns back to its original state after reboot. This is intentional, not to annoy you, but to protect from changes that lead to incidental havoc to gameplay.\n\nThat said, feel free to drop to a terminal shell prompt by using `left Alt` then `2` off the console menu to check out the differences between a default and its startup template configuration:\n```\n$ ll *.cfg\n$ diff default.cfg template.cfg | less\n$ micro template.cfg\n```\nThus, `template.cfg` gets copied over to `retroarch.cfg` → which points to the pi temporary runtime memory space. It is the “base” configuration that gets loaded first. Subsequently, the other configuration files listed – _aptly named to follow the console playlist menu_ – are “appended” in the order received to override base values.\n\nThere is a convenience script that can fetch and build RetroArch and some key emulation cores:\n\n```bash\n$ make-retroarch.sh\n```\n\n### Cores\n\nThis table represents the emulation cores installed and referenced within the various playlists. It is useful to know the name of the core for **Netplay** connections to another host – as both the core and the content should be (_optimally_) identical:\n\n1) **Arcade** :: `1976 - 2004`\n   - FinalBurn Neo\n   - MAME\n   - MAME 2003-Plus\n2) **Computers** :: `1977 - 1999`\n   - Caprice32 - **Amstrad CPC**\n   - MAME \n     - **Apple II / IIgs / Macintosh**\n     - **Tandy Color Computer**\n     - **Texas Instruments 99/4A**\n     - **TRS-80 Model I**\n   - Atari800 - **Atari 800**\n   - **Commodore**\n     - PUAE - **Amiga**\n     - VICE x64sc - **64**\n     - VICE x128 - **128**\n     - VICE xpet - **PET**\n     - VICE xplus4 - **16 / Plus4**\n     - VICE xvic - **VIC 20**\n   - DOSBox-Pure - **PC DOS / Win98**\n   - px68k - **Sharp X68000**\n3) **Consoles** :: `1977 - 2013`\n   - **Atari**\n     - Stella - **2600**\n     - ProSystem - **7800**\n   - blueMSX - **ColecoVision**\n   - FreeIntv - **Mattel Intellivision**\n   - Beetle PCE FAST - **NEC PC Engine / CD**\n   - NeoCD - **Neo Geo CD**\n   - **Nintendo**\n     - Citra - **3DS**\n     - Dolphin - **GameCube**\n     - Mesen - **NES / Famicom**\n     - Mupen64Plus-Next - **N64**\n     - Snes9x or bsnes-jg - **SNES / SFC**\n   - **Sega**\n     - Flycast - **Dreamcast / Naomi**\n     - Genesis Plus GX - **MS/GG/MD/CD**\n     - PicoDrive - **32X**\n     - Yabause - **Saturn**\n   - **Sony**\n     - PCSX ReARMed - **PlayStation**\n     - LRPS2 - **PlayStation 2**\n   - vecx - **Vectrex**\n4) **Handhelds** :: `1989 - 2014`\n   - Beetle Handy - **Atari Lynx**\n   - Beetle NeoPop - **Neo Geo Pocket / Color**\n   - **Nintendo**\n     - gpSP - **Game Boy Advance**\n     - Gambatte - **Game Boy / Color**\n     - PokeMini - **Pokemon Mini**\n     - Beetle VB - **Virtual Boy**\n   - PPSSPP - **Sony PlayStation Portable**\n\n### Overclocking\n\nThese are relatively safe values to bump the CPU + GPU clock up in `/boot/firmware/config.txt`\n\n```ini\n[pi4]\n# enables highest gpu settings at the expense of dual displays\nhdmi_enable_4kp60=1\n# overclock +10%\nover_voltage=4\narm_freq=1980\ngpu_freq=550\n```\n\n```ini\n[pi5]\ndtparam=nvme\ndtparam=pciex1_gen=3\nkernel=kernel8.img\n# overclock +15%\nover_voltage=3\narm_freq=2760\ngpu_freq=920\n```\n\nIf using an NVME drive on Pi 5, enable it to boot:\n\n```bash\n$ sudo rpi-eeprom-config --edit\n```\n\n```ini\n[all]\nBOOT_UART=0\nPOWER_OFF_ON_HALT=1\nBOOT_ORDER=0xf461\nPCIE_PROBE=1\nWAKE_ON_GPIO=0\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheflyingape%2Fretroarch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheflyingape%2Fretroarch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheflyingape%2Fretroarch/lists"}