{"id":15197204,"url":"https://github.com/robwillup/retros","last_synced_at":"2026-01-21T07:24:39.734Z","repository":{"id":203632805,"uuid":"709978523","full_name":"robwillup/retros","owner":"robwillup","description":"A tool to help you manage and interact with your retro gaming files.","archived":false,"fork":false,"pushed_at":"2026-01-16T00:47:31.000Z","size":1918,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-16T06:42:56.851Z","etag":null,"topics":["raspberry-pi","retrogaming","retropie","rom"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robwillup.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-25T18:56:36.000Z","updated_at":"2026-01-16T00:47:34.000Z","dependencies_parsed_at":"2023-11-23T01:44:55.052Z","dependency_job_id":"bcfe6a53-2d87-41eb-91df-fd122623ba7d","html_url":"https://github.com/robwillup/retros","commit_stats":null,"previous_names":["robwillup/romsync","robwillup/retros"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/robwillup/retros","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robwillup%2Fretros","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robwillup%2Fretros/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robwillup%2Fretros/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robwillup%2Fretros/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robwillup","download_url":"https://codeload.github.com/robwillup/retros/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robwillup%2Fretros/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28629915,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T04:47:28.174Z","status":"ssl_error","status_checked_at":"2026-01-21T04:47:22.943Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["raspberry-pi","retrogaming","retropie","rom"],"created_at":"2024-09-28T00:45:18.153Z","updated_at":"2026-01-21T07:24:39.728Z","avatar_url":"https://github.com/robwillup.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# RetroS\n\nRetroS is a tool to help manage files for retro gaming emulation on remote or\nlocal machines.\n\n![build workflow](https://github.com/robwillup/retros/actions/workflows/build.yml/badge.svg)\n![Latest Release](https://img.shields.io/github/v/release/robwillup/retros?label=RetroS%20(Linux%20binary)\u0026sort=semver)\n![Latest Release](https://img.shields.io/github/v/release/robwillup/retros?label=RetroS%20(Windows%20binary)\u0026sort=semver)\n\n\u003cdiv  style=\"text-align: center;\"\u003e\n    \u003cimg\n        src=\"https://repository-images.githubusercontent.com/709978523/1ebe6c81-8dfd-499a-a194-4bbfefe65243\"\n        alt=\"RetroS\" style=\"width: 550px;\"/\u003e\n        \u003cp\u003eImage by @robwillup\u003cp\u003e\n\u003c/div\u003e\n\n## Status\n\nEarly development. There are many features to be added and there may be bugs in\ncurrent versions.\n\n## Download\n\nYou can download the latest binary from [releases](https://github.com/robwillup/retros/releases)\nor use one of the commands below:\n\n\u003e For Windows, you may need to download using the command below. When downloading\n\u003e from the browser, Windows Defender may remove it as a virus.\n\n### Linux\n\n```bash\n# wget\nwget https://github.com/robwillup/retros/releases/download/v1.0.6/retros \\\n\u0026\u0026 chmod +x retros\n```\n\n```bash\n# cURL\ncurl -L https://github.com/robwillup/retros/releases/download/v1.0.6/retros \\\n-o retros \u0026\u0026 chmod +x retros\n```\n\n### Windows\n\n```powershell\niwr \"https://github.com/robwillup/retros/releases/download/v1.0.6/retros.exe\" -o \"retros.exe\"\n```\n\n### macOS\n\n```bash\ncurl -L https://github.com/robwillup/retros/releases/download/v1.0.6/osx-retros \\\n-o retros \u0026\u0026 chmod +x retros\n```\n\n## Setup\n\nRetroS will need the `host (IP address)` and the `username` of the remote machine\nwhere RetroPie is running. You can configure that by running:\n\n```bash\nretros cf\n```\n\n### SSH keys\n\nTo be able to connect to the remote machine securely, you will need to create an SSH key pair and place the private key\non your machine and the public key in the remote machine. You can follow these steps:\n\n1. Create the key pair\n\n```shell\nssh-keygen -t rsa -b 4096\n```\n\n2. Copy the public key to the remote machine\n\n```shell\nssh-copy-id pi@RETROPIE_IP_ADDRESS\n```\n\nThis installs your public key in the remote machine's `~/.ssh/authorized_keys` file.\n\n## Commands\n\nThese are the commands currently available.\n\n### Copy\n\nAdding a single ROM file to RetroPie:\n\n```bash\nretros cp Game.md\n```\n\nThe ROM file will be added to the corresponding folder in RetroPie based on\nthe ROM file extension, in the case above `megadrive`.\n\nAdding all ROM files in a directory:\n\n```bash\nretros cp /home/gamer/roms\n```\n\nAll ROM files in the provided directory will be copied to their respective\nemulators in RetroPie based on the file extensions.\n\n#### Specifying the emulator\n\nIf a ROM file has a different extension, you can copy it by\nspecifying the emulator it should go into:\n\n```bash\nretros cp --emulator=atari2600 Game.bin\n```\n\n### List\n\nLists the ROM files in RetroPie:\n\n```bash\nretros ls\n```\n\nTo list ROM files for specific emulators:\n\n```bash\nretros ls -e=mastersystem\n```\n\n### Remove\n\nRemoves specific ROM files:\n\n```bash\nretros rm \"Game with awesome sprites.gba\"\n```\n\n### Check\n\nThe `check` command verifies the integrity of ROM files.\nThe example below shows how to check all ROM files in the `snes` directory:\n\n```bash\nretros check ~/games/snes\n```\n\n## Roadmap\n\nThe intent for RetroS is that it will be used to sync other files and assets with\nRetroPie besides ROMs.\n\nMuch is still under consideration, but some ideas are being added to the\n[project here](https://github.com/users/robwillup/projects/1).\n\n## Disclaimer\n\nThis project does NOT provide any game ROM files.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobwillup%2Fretros","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobwillup%2Fretros","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobwillup%2Fretros/lists"}