{"id":16374352,"url":"https://github.com/raphimc/noteblocktool","last_synced_at":"2026-01-25T19:09:50.547Z","repository":{"id":229171183,"uuid":"775940450","full_name":"RaphiMC/NoteBlockTool","owner":"RaphiMC","description":"Tool for importing, exporting, batch manipulating and playing Minecraft note block songs","archived":false,"fork":false,"pushed_at":"2025-08-22T19:27:47.000Z","size":2552,"stargazers_count":14,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-22T21:51:49.779Z","etag":null,"topics":["midi","midi-converter","minecraft","nbs","noteblock","noteblocksongs","noteblockstudio"],"latest_commit_sha":null,"homepage":"","language":"Java","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/RaphiMC.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"ko_fi":"rk_01"}},"created_at":"2024-03-22T10:57:02.000Z","updated_at":"2025-08-22T19:27:50.000Z","dependencies_parsed_at":"2024-03-28T20:47:19.491Z","dependency_job_id":"d3e45824-06e0-4d0a-9c93-2fdc3fa10758","html_url":"https://github.com/RaphiMC/NoteBlockTool","commit_stats":null,"previous_names":["raphimc/noteblocktool"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/RaphiMC/NoteBlockTool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaphiMC%2FNoteBlockTool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaphiMC%2FNoteBlockTool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaphiMC%2FNoteBlockTool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaphiMC%2FNoteBlockTool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RaphiMC","download_url":"https://codeload.github.com/RaphiMC/NoteBlockTool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RaphiMC%2FNoteBlockTool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273355643,"owners_count":25090825,"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-02T02:00:09.530Z","response_time":77,"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":["midi","midi-converter","minecraft","nbs","noteblock","noteblocksongs","noteblockstudio"],"created_at":"2024-10-11T03:16:59.089Z","updated_at":"2026-01-25T19:09:50.489Z","avatar_url":"https://github.com/RaphiMC.png","language":"Java","readme":"# NoteBlockTool\nTool for importing, exporting, batch manipulating and playing Minecraft note block songs.\n\nTo download the latest stable version, go to [GitHub Releases](https://github.com/RaphiMC/NoteBlockTool/releases/latest).  \nTo download the latest dev version, go to [GitHub Actions](https://github.com/RaphiMC/NoteBlockTool/actions/workflows/build.yml) or [Lenni0451's Jenkins](https://build.lenni0451.net/job/NoteBlockTool/).\n\nUsing it is very simple, just run the jar file, and it will start a user interface. Detailed instructions can be found in the [Usage](#usage) section.\n\n## Features\n- Reads .nbs, .mcsp2, .mid, .txt and .notebot files\n- Can export all of the above as .nbs, .mp3, .wav and .aif files\n- Work with multiple songs at once (Batch processing)\n- High performance and accurate song player\n  - Lag free playback of very large songs\n  - Supports all NBS features including custom instruments\n- Good MIDI importer\n  - Supports most MIDI files\n  - Supports velocity and panning\n  - Can handle Black MIDI files\n- Supports all NBS versions\n  - Version 0 - 5\n  - Supports undocumented features like Tempo Changers\n- Many tools for manipulating songs\n    - Optimize songs for use in Minecraft (Transposing, Resampling)\n    - Resampling songs with a different TPS\n    - NBS metadata editor\n    - Instrument replacement\n    - Note deduplication (Useful for Black MIDI files)\n    - Removal of quiet notes (Useful for Black MIDI files)\n- Very fast and efficient\n  - Imports and manipulates hundreds of songs in seconds\n  - Can export songs as audio files at multiple times the speed of playback\n\n### Limitations\n- NBS layers are not preserved when doing anything other than editing the metadata\n  - All editing is done on intermediary song objects which do not have layers\n\n## Usage\n### Importing\nAfter downloading and running the jar file, you will be greeted with a user interface:  \n![NoteBlockTool Main GUI](img/NoteBlockTool%20Main%20GUI.png)  \nThe table shows all currently loaded songs. Songs can be dragged and dropped into the table to load them or you can use the \"Add\" button to open a file dialog.\n### Editing\nTo start editing songs, select one or multiple songs in the table and click the \"Edit\" button. This will open the song editor:  \n![NoteBlockTool Song Editor](img/NoteBlockTool%20Song%20Editor.png)  \nBy default, everything is disabled or does nothing. To enable a feature, click the corresponding checkbox or configure its settings.  \nAfter you are done editing, click the \"Save\" button to apply the edits to the selected songs or the \"Preview\" button to listen to the edits before saving.  \n### Playing\nTo play a song, select it in the table and click the \"Play\" button. This will open the song player:  \n![NoteBlockTool Song Player](img/NoteBlockTool%20Song%20Player.png)  \nThe song player features all the essential controls for playing a song.\n### Exporting\nTo export the edited songs, select them in the table and click the \"Export\" button. This will open the export dialog where you can select a folder to save all the songs to.\n\n## Using it in your application\nNoteBlockTool uses [NoteBlockLib](https://github.com/RaphiMC/NoteBlockLib) for most of its functionality. For more information on how to use NoteBlockLib in your application, check out [NoteBlockLib](https://github.com/RaphiMC/NoteBlockLib).\n\n## Contact\nIf you encounter any issues, please report them on the\n[issue tracker](https://github.com/RaphiMC/NoteBlockTool/issues).  \nIf you just want to talk or need help using NoteBlockTool feel free to join my\n[Discord](https://discord.gg/dCzT9XHEWu).\n","funding_links":["https://ko-fi.com/rk_01"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphimc%2Fnoteblocktool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fraphimc%2Fnoteblocktool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fraphimc%2Fnoteblocktool/lists"}