{"id":13433946,"url":"https://github.com/1j01/midiflip","last_synced_at":"2025-04-25T19:30:33.237Z","repository":{"id":57296876,"uuid":"81915166","full_name":"1j01/midiflip","owner":"1j01","description":"🎹 MIDI music mayhem - flip, transpose, and arbitrarily remap pitches in MIDI files","archived":false,"fork":false,"pushed_at":"2022-07-26T23:06:14.000Z","size":243,"stargazers_count":41,"open_issues_count":0,"forks_count":7,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-28T16:13:52.224Z","etag":null,"topics":["experiment","experimental","midi","midi-events","midi-files","music","procedural","remix","remixer","remixes","transformation","web-app"],"latest_commit_sha":null,"homepage":"https://1j01.github.io/midiflip/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/1j01.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-14T06:56:18.000Z","updated_at":"2024-10-09T21:53:37.000Z","dependencies_parsed_at":"2022-09-02T06:30:26.411Z","dependency_job_id":null,"html_url":"https://github.com/1j01/midiflip","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/1j01%2Fmidiflip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1j01%2Fmidiflip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1j01%2Fmidiflip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/1j01%2Fmidiflip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/1j01","download_url":"https://codeload.github.com/1j01/midiflip/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224014299,"owners_count":17241281,"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":["experiment","experimental","midi","midi-events","midi-files","music","procedural","remix","remixer","remixes","transformation","web-app"],"created_at":"2024-07-31T02:01:41.046Z","updated_at":"2024-11-10T21:08:27.294Z","avatar_url":"https://github.com/1j01.png","language":"JavaScript","funding_links":[],"categories":["Sound creation","JavaScript"],"sub_categories":["Instrument recordings"],"readme":"# MidiFlip\n\nTransform MIDI songs to create mathematical remixes.\nInspired by Andrew Huang's [#MidiFlip \"challenge\"](https://youtu.be/4IAZY7JdSHU).\n\nMidiFlip can be used to simply flip notes around,\ninverting all the pitches,\nbut it also gives you raw control over the notes in a simple way so you can make arbitrary remappings.\n\n[Try MidiFlip online.](https://1j01.github.io/midiflip/)\nYou can batch convert files and download the results as a zip file.\n(The files are not uploaded to a server.)\n\nThe web interface supports everything the CLI does (and actually more at the moment).\n\n\n## Future Direction\n\nIt would be good to be able to look at the original song as a whole in order to\ntranspose notes back to reasonable ranges like [Automatic MIDI Inverter](https://midi-inverter.herokuapp.com/) does,\nor do fancier stuff like finding the scale used and mapping it to another.\n(You can only look at and change a single note at a time with the current API.)\n\nMidiFlip could also let you deal in time,\nreversing a song or changing the tempo,\naltering the duration of notes,\nhumanizing or quantizing,\nstuff like that.\n\nIt would probably make sense to have two levels of configuration,\none where you just define a mapping,\nand that could be visualized,\nand one where you just write code to modify the MIDI.\nEither way the results could be visualized, with an embedded MIDI player.\n\nCould handle inverting pitch bends and portamenti like [AutoMIDIFlip](http://automidiflip.com/) does.\nThis would be optional, since you can specify transformations such as simple transpositions.\n\n\n## CLI Installation\n\nInstall [Node.js](https://nodejs.org/) if you haven't already.\nThen open a terminal/command prompt and run `npm install midiflip -g`\n\nYou should now have access to the `midiflip` command.\n\n\n## CLI Usage\n\nGo to where you have some MIDI files stored,\nsuch as your music folder,\ni.e. on Windows\n`cd %UserProfile%\\Music`\nand on probably most other operating systems, just\n`cd ~/Music`\n\n### Flip a single file:\n`midiflip -i \"midis/Danger.mid\" -o \"transformed/Danger.mid\"`\n\n### Flip a bunch of files:\n`midiflip -i \"midis/**/*.mid\" -o \"transformed/\"`\n\nThis uses [glob](https://www.npmjs.com/package/glob).\n`**` means zero or more (sub)directories,\nso this will match e.g. `midis/1.mid` as well as `midis/Avgvst/FreeRide.mid`.\nIt will output the transformed files to the given output directory,\ncreating matching subdirectories,\nbut stripping off anything before the first `*`,\nso you'll get e.g. `transformed/Avgvst/FreeRide.mid`\nrather than `transformed/midis/Avgvst/FreeRide.mid`\n\n\n### Purposefully mess with percussion\n\nAdd `-p` or `--percussion` to apply the same transformation to percussion as to other notes,\nwhich doesn't make the semantic sense that applying it to pitch does.\n\n\n## License (MIT)\n\nCopyright 2017 Isaiah Odhner\n\nPermission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1j01%2Fmidiflip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F1j01%2Fmidiflip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F1j01%2Fmidiflip/lists"}