{"id":19564404,"url":"https://github.com/deved2/gbmod","last_synced_at":"2025-09-07T06:05:33.597Z","repository":{"id":81684646,"uuid":"472945398","full_name":"DevEd2/GBMod","owner":"DevEd2","description":"XM converter + player for Game Boy","archived":false,"fork":false,"pushed_at":"2025-06-28T16:53:04.000Z","size":235,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-28T17:39:47.660Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DevEd2.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,"zenodo":null}},"created_at":"2022-03-22T21:37:06.000Z","updated_at":"2025-06-28T16:53:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"fe764aa6-a89c-4a31-8574-982802a71373","html_url":"https://github.com/DevEd2/GBMod","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DevEd2/GBMod","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevEd2%2FGBMod","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevEd2%2FGBMod/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevEd2%2FGBMod/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevEd2%2FGBMod/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DevEd2","download_url":"https://codeload.github.com/DevEd2/GBMod/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DevEd2%2FGBMod/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274001326,"owners_count":25205235,"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","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-11-11T05:21:57.222Z","updated_at":"2025-09-07T06:05:33.526Z","avatar_url":"https://github.com/DevEd2.png","language":"Assembly","readme":"# GBMod\nXM converter + player for Game Boy\n\n## Using GBMod\nRequirements: [Python 3](https://www.python.org/) and a tracker of your choice ([OpenMPT](https://openmpt.org/), [MilkyTracker](https://milkytracker.org/), [FT2 Clone](https://16-bits.org/ft2.php), etc.)\n\n1. Download the easypack [here](http://devnet.sonicgamesdimension.net/GBMod-Easypack.zip)\n\n2. Unzip it\n\n3. Use the provided template module to write a tune\n  - Volume column is allowed, but you should use the note off command (in the note column) instead of setting the volume to zero\n  - Tempo must be 150, speed can be whatever\n  - Allowed effects: 0xy (CH1-CH3 only), 1xy/2xy (CH1-CH3 only), Axx, Bxx, Dxx, Fxx\n    - Using Cxx to set note volume is not supported, use the volume column instead\n  - Instruments 1-4 can be used on CH1, CH2, and CH3\n  - Instruments 5-16 may only be used on CH3\n  - Instruments 17 and 18 may only be used on CH4\n  - The samples for instruments 5-16 may be redrawn as you see fit, but don't change the sample size\n  - Each pattern must be 64 rows long (if you need to cut a pattern early use D00)\n  - Do not use C00 in order to do note cuts, instead you should use the note off command (in the note column)\n  - You must save your module in .XM format\n\n4. Run xmconv.py\n`python xmconv.py yourmodule.xm music.bin`\n\n5. Build the ROM\n  - If on Windows, run \"type player.bin music.bin \u003e rom.gb\"\n  - If on Linux or Mac OS X, run \"cat player.bin music.bin \u003e rom.gb\"\n  - Change the ROM name to your song's name\n  - Optional: Use RGBFIX to fix the checksum of the resulting ROM\n\n## Building GBMod\nRequirements: [RGBDS](https://github.com/gbdev/rgbds), Python 3\n\n1. Clone the repository.\n2. If on Windows, run `build.bat`.\n3. If on macOS or Linux, run `build.sh`. If you get a \"permission denied\" error, run `chmod +x build.sh` and try again.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeved2%2Fgbmod","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeved2%2Fgbmod","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeved2%2Fgbmod/lists"}