{"id":20583338,"url":"https://github.com/dannye/crystal-tracker","last_synced_at":"2025-07-25T23:11:20.460Z","repository":{"id":143498757,"uuid":"494627153","full_name":"dannye/crystal-tracker","owner":"dannye","description":"A song and sound editor for pokecrystal-based sound engines.","archived":false,"fork":false,"pushed_at":"2024-10-29T22:40:33.000Z","size":4548,"stargazers_count":51,"open_issues_count":1,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-10-29T23:48:44.265Z","etag":null,"topics":["8-bit","audio","c-plus-plus","chiptune","editor","fltk","gameboy","libopenmpt","music","player"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dannye.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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":"2022-05-20T22:58:40.000Z","updated_at":"2024-10-29T22:40:35.000Z","dependencies_parsed_at":"2023-12-10T23:22:13.075Z","dependency_job_id":"2cb43e00-cce5-4b06-a701-54fbf0fd3e41","html_url":"https://github.com/dannye/crystal-tracker","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dannye%2Fcrystal-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dannye%2Fcrystal-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dannye%2Fcrystal-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dannye%2Fcrystal-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dannye","download_url":"https://codeload.github.com/dannye/crystal-tracker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230487844,"owners_count":18233865,"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":["8-bit","audio","c-plus-plus","chiptune","editor","fltk","gameboy","libopenmpt","music","player"],"created_at":"2024-11-16T06:39:20.989Z","updated_at":"2024-12-19T19:08:00.843Z","avatar_url":"https://github.com/dannye.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Crystal Tracker\n\nA song and sound editor for [pokecrystal](https://github.com/pret/pokecrystal), [pokegold](https://github.com/pret/pokegold), [pokeyellow-crysaudio](https://github.com/dannye/pokeyellow-crysaudio), [pokered-crysaudio](https://github.com/dannye/pokered-crysaudio), and [pokepinball](https://github.com/pret/pokepinball).\n\nCrystal Tracker provides the ability to directly create and modify pokecrystal-based asm song files, with in-app immediate playback by dynamically loading and synthesizing custom channel 3 waveforms and channel 4 drumkits.\n\nThe editor exports fully complete asm song files, so that you can \"Save\" your changes and then immediately `make` your project and instantly have a new ROM file with your modifications included — no additional conversion tools or steps required.\n\n![Screenshot](screenshot.png)\n\n## Getting Started\n\n### Windows\n\nDownload the latest Windows executable from the [Releases](https://github.com/dannye/crystal-tracker/releases) section.\nTo build from source, see [INSTALL.md](INSTALL.md).\n\n---\n\n### Linux\n\nSee [INSTALL.md](INSTALL.md) to build from source or run the Windows executable via Wine.\n\n---\n\n### Mac\n\nDownload the latest dmg from the [Releases](https://github.com/dannye/crystal-tracker/releases) section or run the Windows executable via Wine.\nTo build from source, see [INSTALL.md](INSTALL.md).\n\nAfter installing from the dmg, launching the app may show an error that says that Crystal Tracker \"cannot be opened because the developer cannot be verified\" or \"is damaged and can't be opened\". To fix this, clear the \"com.apple.quarantine\" attribute from the app by running the following command:\n\n```sh\nxattr -c \"/Applications/Crystal Tracker.app\"\n```\n\n---\n\nThe [example/](example/) directory contains crystaltracked.asm, an original composition by Mickey-A 42.\n\nBe sure to see the Help menu for a full explanation on how to use the editor.\n\n## Upgrading a legacy project\n\nIf your project uses the \"legacy\" macros (pre-2020), you will need to upgrade your project.\n\nDownload [tools/upgrade.py](tools/upgrade.py) and put it at the root of your project.\nRun the upgrade script on your music folder, like:\n```sh\npython3 upgrade.py -v audio/music/\n```\nIt can also be used to upgrade individual files, like:\n```sh\npython3 upgrade.py -v audio/drumkits.asm\n```\nThe script also works with python2. Run `./upgrade.py -h` for all options.\n\nBe sure to make adequate backups of your song files (via git or otherwise) before upgrading, just in case.\n\nThen you must copy all modern audio macros from the latest [macros/scripts/audio.asm](https://github.com/pret/pokecrystal/blob/master/macros/scripts/audio.asm) and [macros/legacy.asm](https://github.com/pret/pokecrystal/blob/master/macros/legacy.asm) into your project.\n\n## Special Thanks\n\nThis project takes a lot of inspiration (and a lot of backbone code structure) from [Polished Map](https://github.com/Rangi42/polished-map). A huge thank you to [Rangi42](https://github.com/Rangi42)!\n\nAdditional thanks to [mid-kid](https://github.com/mid-kid) for the Mac port.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdannye%2Fcrystal-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdannye%2Fcrystal-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdannye%2Fcrystal-tracker/lists"}