chiptune-composer

What problem does it solve?

Turn high-level musical requests into complete, playable chiptune song files for the repository's audio tracker so composers and game developers can get production-ready tracker JSON without manual pattern-by-pattern editing.

Core Features & Use Cases

• End-to-end composition: Plans structure, instruments, motifs, and writes full four-channel JSON songs of ~90 seconds following the tracker's compact event format.
• Style-aware output: Supports RPG battle, boss, overworld, town, dungeon, shop, victory, ambient, classical arrangements, and synthwave conventions with matching tempo, voicing, and transition techniques.
• Tracker-safe rules: Enforces explicit pattern lengths, cross-boundary sustains, sequence math, instrument parameter recipes, and post-generation boundary-fix steps so outputs are valid and seamless.
• Integration-ready: Produces files suitable for direct inclusion in music/audio-tracker/songs and indicates index updates and gap-fixing steps.

Quick Start

Compose a 90-second RPG battle chiptune in D minor at 150 BPM with a driving ostinato and fiery melody, output the JSON ready for music/audio-tracker/songs.