{"id":22426626,"url":"https://github.com/theypsilon/_arcade-organizer","last_synced_at":"2025-08-01T09:30:57.792Z","repository":{"id":38009609,"uuid":"267432286","full_name":"theypsilon/_arcade-organizer","owner":"theypsilon","description":"A script for organizing _Arcade for MiSTer","archived":false,"fork":false,"pushed_at":"2024-06-18T21:53:25.000Z","size":965,"stargazers_count":36,"open_issues_count":5,"forks_count":6,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-06-19T03:55:25.625Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/theypsilon.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2020-05-27T21:42:50.000Z","updated_at":"2024-06-18T21:53:28.000Z","dependencies_parsed_at":"2024-04-08T20:04:30.572Z","dependency_job_id":"5bb12124-4e34-4592-a1f3-7f93e6806165","html_url":"https://github.com/theypsilon/_arcade-organizer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theypsilon%2F_arcade-organizer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theypsilon%2F_arcade-organizer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theypsilon%2F_arcade-organizer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theypsilon%2F_arcade-organizer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theypsilon","download_url":"https://codeload.github.com/theypsilon/_arcade-organizer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228357935,"owners_count":17907464,"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":[],"created_at":"2024-12-05T19:22:46.870Z","updated_at":"2025-08-01T09:30:57.780Z","avatar_url":"https://github.com/theypsilon.png","language":"Python","funding_links":["https://ko-fi.com/theypsilon"],"categories":[],"sub_categories":[],"readme":"# _arcade-organizer [![Twitter](https://img.shields.io/twitter/url/https/twitter.com/josembarroso.svg?style=social\u0026label=Follow%20%40josembarroso)](https://twitter.com/josembarroso) \u003cspan class=\"badge-buymeacoffee\"\u003e\u003ca href=\"https://ko-fi.com/theypsilon\" title=\"Buy Me a Coffee at ko-fi.com'\"\u003e\u003cimg src=\"https://img.shields.io/badge/buy%20me%20a%20coffee-donate-yellow.svg\" alt=\"Buy Me a Coffee at ko-fi.com'\" /\u003e\u003c/a\u003e\u003c/span\u003e\n\n\u003e [!IMPORTANT]  \n\u003e This repository is archived and will no longer be updated. To use the latest Arcade Organizer, please access it via [Update All](https://github.com/theypsilon/Update_All_MiSTer). The new documentation is available [here](https://github.com/theypsilon/Update_All_MiSTer/blob/master/docs/arcade_organizer.md).\n\nA simple script to automate organizing MiSTer's \\_Arcade directory based on your MRA files.\n\nThese scripts do not duplicate any cores or mra files; only soft symlinks are used.\n\n_Note: These sylinks only work on MiSTer. If you mount your SD card outside of MiSTer, these symlinks will not work._\n\nThis script looks at what MRA files you have, and the information in them, to organize MiSTer's `\\_Arcade` directory. \n\nIf the XLM tags for _Year, Manufacturer, and Category_ are included in the MRA file, this script will create an `\\_Organized` Directory in `\\_Arcade` and will create the following sub-directories with soft sysmlinks to organize it:\n\n```\n_Organized\n├── _1 A-E\n├── _1 F-K\n├── _1 L-Q\n├── _1 R-T\n├── _1 U-Z\n├── _2 Year\n├── _3 Manufacturer\n└── _4 Category\n```\n\n## Features\n\n**You can browse by:**\n\n* Region\n* Rotation (0-90-180-270 ± flip)\n* Resolution (15-24-31kHz)\n* Platform\n* Series\n* Move Inputs (8-way, 4-way, 2-way)\n* Special Controls (spinner, wheel, etc)\n* Number of Players\n* Number of Buttons\n* Decades\n* Best-of Lists\n* Homebrew\n* Bootleg.\n\n**\"Top Additional Directories\" toggle:**\n\nAllows you to include the extra folders that you choose in the top level of the organized directory: Platform, Core, Year\n\n**\"Chronological Sorting at the Botom\" toggle:**\n\nBy enabling this, every directory will include an additional chronologically sorted index at the bottom of the list.\n\n**_Clean Folders_ sub-script:**\n\nCan be run to delete all the Arcade Organizer folders\n\n**MAD metadata support:**\n\n- Support for the MAD metadata format allows improving the metadata of a game without having to change the game's MRA, being thus more flexible and lightweight.\n- MAD database option: The new MAD_DB ini field allows you to you use different MAD databases with different metadata (for example, different categories).\n- For resources for creating your own MAD database see: https://github.com/theypsilon/MAD_Database_MiSTer\n\n## Instructions\n\nDownload the update_arcade-organizer.sh to the Scripts directory and run.\n\nAlternately, run the [update_all.sh script](https://github.com/theypsilon/Update_All_MiSTer), and press Up on the keyboard to enter options, and access the arcade organizer suboptions which will look like this:\n\n![screnshot of arcade organizer options in update all menu](https://i.imgur.com/3NWiUqi.png)\n\nYou can optionally toggle to activate/deactivate specific folders. Deactivating unwanted folders will boost the speed of the script.\n\n**_Disclaimer:_**\n\nYou should back up your \\_Arcade directory before running this script. Use at your own risk. This script comes with no warranty.\n\n**_Note if you use non-default folder paths:_**\n\nThis script uses:\n\na DEFAULT LOCATION for `_Arcade` at `/media/fat/_Arcade`\n\n_and_\n\na DEFAULT LOCATION for `\\_Organized` at `/media/fat/_Arcade/_Organized`\n\nIf your `\\_Arcade` directory is in a different location you MUST use a `/media/fat/Scripts/update_arcade-organizer.ini` file \n\nIf you're not using the default locations for `\\_Arcade` and `\\_Organized`, you must add their locations in `/media/fat/Scripts/update_arcade-organizer.ini` \n\n## FAQ\n\n**Q: How can I set my own custom locations for MRA and \\_Organized Directories?**\n\nA: A `/media/fat/Scripts/update_arcade-organizer.ini` file may be used to set custom location for your MRA files (Scans recursivly) and \\_Organized files.\nAdd the following line to the ini file to set a directory for MRA files: `MRADIR=/top/path/to/mra/files/_Arcade`\nAdd the following line to the ini file to set a directory for Organized files: `ORGDIR=/path/to/organized/files/_Organized`\n\n**Q:Will this script over write files I already have?**\n\nA: NO, This script will not clober files you already have.\n\n\n**Q: What If I get new MRA/Core files?**\n\nA: You need to re-run the script to have them included in the Organized files.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheypsilon%2F_arcade-organizer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheypsilon%2F_arcade-organizer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheypsilon%2F_arcade-organizer/lists"}