ChiPyTune

Source-available Game Boy style music and SFX creation tool — desktop, CLI, HTTP, and MCP.

GitHub

---

ENGLISH

What Is ChiPyTune?

ChiPyTune is a source-available non-commercial tool for creating Game Boy style chiptune music and sound effects. It produces editable JSON projects and renders them to WAV/OGG audio through the same core service used by every interface.

ChiPyTune is Game Boy style. It is not a cycle-accurate Game Boy APU emulator.

What you can do

• Sketch block-based music in Hobbista desktop mode
• Edit detailed tracker-style projects in Profissional desktop mode
• Generate and render JSON from the CLI
• Expose local render/validation endpoints over HTTP
• Let MCP-capable clients create, validate, and render music or SFX

Desktop Modes

Profissional — Full tracker, instrument, preset, SFX, JSON, preview, and export workflow for detailed editing.

Hobbista — A playful block composer with a fixed-width scrollable timeline for fast musical sketching.

Quick Start (CLI)

Create and render a music loop:

uv run chipytune template music --name gameboy-loop --out gameboy_loop.json
uv run chipytune validate gameboy_loop.json
uv run chipytune render gameboy_loop.json --out dist/audio --stem gameboy_loop

Create and render a jump SFX:

uv run chipytune template sfx --name jump --out jump_sfx.json
uv run chipytune validate jump_sfx.json
uv run chipytune render jump_sfx.json --out dist/audio --stem jump

Export every built-in preset as a game asset pack:

uv run chipytune presets export --out dist/game-assets

Built-in Presets

Music: gameboy-loop, pulse-bass-loop

SFX: jump, coin, laser, explosion, powerup, hit, select, error

Export

• WAV and OGG rendering
• Metadata tags: title, artist, album, genre, track number
• JSON project export (chipytune.project.v1 / chipytune.sfx.v1)

License

ChiPyTune uses the PolyForm Noncommercial License 1.0.0.
You may sell games, audio files, and other assets you create with ChiPyTune.
You may not sell, sublicense, host, or redistribute ChiPyTune itself commercially except under a separate commercial license.

---

PORTUGUÊS

O que é ChiPyTune?

ChiPyTune é uma ferramenta source-available para criar músicas e efeitos sonoros no estilo Game Boy. Produz projetos JSON editáveis e renderiza para WAV/OGG usando o mesmo núcleo de validação e renderização em todas as interfaces.

ChiPyTune é no estilo Game Boy. Não é um emulador cycle-accurate da APU do Game Boy.

O que você pode fazer

• Compor música baseada em blocos no modo Hobbista
• Editar projetos detalhados no modo tracker Profissional
• Gerar e renderizar JSON pela CLI
• Usar endpoints locais HTTP para validação e renderização
• Integrar com agentes via servidor MCP

Modos Desktop

Profissional — Tracker completo com instrumentos, presets, SFX, JSON, preview e exportação.

Hobbista — Compositor visual em blocos com timeline scrollável para rascunhar ideias musicais rapidamente.

Início Rápido (CLI)

Criar e renderizar um loop musical:

uv run chipytune template music --name gameboy-loop --out gameboy_loop.json
uv run chipytune validate gameboy_loop.json
uv run chipytune render gameboy_loop.json --out dist/audio --stem gameboy_loop

Criar e renderizar um SFX de pulo:

uv run chipytune template sfx --name jump --out jump_sfx.json
uv run chipytune validate jump_sfx.json
uv run chipytune render jump_sfx.json --out dist/audio --stem jump

Exportar todos os presets:

uv run chipytune presets export --out dist/game-assets

Presets Inclusos

Música: gameboy-loop, pulse-bass-loop

SFX: jump, coin, laser, explosion, powerup, hit, select, error

Exportação

• Renderização WAV e OGG
• Metadados: título, artista, álbum, gênero, número da faixa
• Exportação de projeto JSON (chipytune.project.v1 / chipytune.sfx.v1)

Licença

ChiPyTune usa a PolyForm Noncommercial License 1.0.0.
Você pode vender jogos, músicas, efeitos sonoros e assets criados com ChiPyTune.
Você não pode vender, sublicenciar, hospedar ou redistribuir ChiPyTune comercialmente sem uma licença separada.