{"id":20047238,"url":"https://github.com/wojciech-graj/tic-midi","last_synced_at":"2025-05-05T10:31:14.589Z","repository":{"id":143187461,"uuid":"615073551","full_name":"wojciech-graj/TIC-MIDI","owner":"wojciech-graj","description":"A MIDI-to-TIC-80 cartridge converter.","archived":false,"fork":false,"pushed_at":"2024-09-23T20:13:52.000Z","size":67,"stargazers_count":17,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-08T21:15:41.482Z","etag":null,"topics":["audio","convert","converter","lua","midi","python","tic-80","tool","tools"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wojciech-graj.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}},"created_at":"2023-03-16T22:38:52.000Z","updated_at":"2025-01-20T01:06:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"f556f419-b8d2-4364-9f4d-a0f9a5ca2d0a","html_url":"https://github.com/wojciech-graj/TIC-MIDI","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wojciech-graj%2FTIC-MIDI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wojciech-graj%2FTIC-MIDI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wojciech-graj%2FTIC-MIDI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wojciech-graj%2FTIC-MIDI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wojciech-graj","download_url":"https://codeload.github.com/wojciech-graj/TIC-MIDI/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252480425,"owners_count":21754774,"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":["audio","convert","converter","lua","midi","python","tic-80","tool","tools"],"created_at":"2024-11-13T11:34:43.008Z","updated_at":"2025-05-05T10:31:14.286Z","avatar_url":"https://github.com/wojciech-graj.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TIC-MIDI\n\nA MIDI-to-TIC-80 converter.\n\n\"The mission, the nightmares... they’re finally... over.\" - CT-5385 (presumably about switching to TIC-MIDI ;) )\n\n### Features\n- Utilizes up to all 4 audio channels simultaneously\n- Has variable audio resolution to use more or less space in exchange for audio quality\n- Can map midi tracks to sfx as dictated by the user, allowing for different instruments\n- Has variable volume\n- Sets tempo and speed to match input\n- Can insert music into existing cart\n- Can use any memory bank\n\n### Limitations\n- Can only write a single file to a single track\n- Disregards multiple MIDI channels\n- Only considers the following MIDI messages: `set_tempo`, `note_on`, `note_off`\n- Only uses the Master Volume TIC-80 command\n- Does not generate sfx and waveforms\n\n### Usage\n\nMake sure Python (3.9+) is available on your system.\n\nInstall the dependencies:\n```sh\npip install -e .\n```\nOR\n```sh\npip install 'mido\u003e=1.2.0,\u003c=1.3.2'\n```\n\nThen, simply invoke the script:\n```sh\npython tic_midi.py input_file -o output_file\n```\n\nTo learn about the settings you can use, invoke the script with the `-h` flag:\n```sh\npython tic_midi.py -h\n```\n\nWhen playing the music with your lua code, set `sustain=true` in your `music` function call, since the converter currently doesn't re-play notes when starting a new frame.\n\nA sample MIDI file, and the cartridge produced with it, can be found in the `example` directory.\n\n### Development setup\n\nInstall the development dependencies:\n```sh\npip install -e '.[dev]'\n```\n\n### License\n```\n    Copyright (C) 2023-2024  Wojciech Graj\n\n    This program is free software: you can redistribute it and/or modify\n    it under the terms of the GNU Affero General Public License as published by\n    the Free Software Foundation, either version 3 of the License, or\n    (at your option) any later version.\n\n    This program is distributed in the hope that it will be useful,\n    but WITHOUT ANY WARRANTY; without even the implied warranty of\n    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n    GNU Affero General Public License for more details.\n\n    You should have received a copy of the GNU Affero General Public License\n    along with this program.  If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n```\n\nPortions of this software are copyright of their respective authors:\n- [mido](https://github.com/mido/mido), Licensed under the [MIT License](https://opensource.org/licenses/MIT); Copyright (c) Ole Martin Bjørndalen\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwojciech-graj%2Ftic-midi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwojciech-graj%2Ftic-midi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwojciech-graj%2Ftic-midi/lists"}