You speak English.
Your agent speaks SEGAN.

You don't learn SEGAN. Your agent does.

With the SEGAN skill (Claude) or the MCP server (any agent), your AI agent becomes the translator between what you want and the sounds your game plays. It can't hear, so SEGAN shows it a picture of every sound and the numbers that matter.

1. You English

   "A coin pickup, bright and short."

2. Agent Claude + SEGAN skill / MCP
   • writes coin.sfx.yaml
   • runs segan lint
   • reads the listen sheet
   • fixes what's off
3. SEGAN the compiler
   • renders 4 variations
   • one shared mix
   • on its loudness target
   • byte-identical builds
4. Your game any engine
   • coin.1-4.wav
   • coin.tres
   • manifest.json

Watch an agent make game audio

Choose your own adventure: pick what you're building, then what to ask for next. Start over to take another path. Each reply has the sounds (press play), their listen sheets, what the agent wrote, and the files your game gets.

A scripted conversation. The sounds, listen sheets, source files, diffs, lint results and build output are real SEGAN output, rebuilt from the source files in this site's repo.

Built for a whole game's worth of sound

Everything below is real build output from the demo projects, played in your browser from the same files and loop points a game loads.

1 Sound as source code

The agent writes text you can read, diff, review and keep in git. "A danger version for when enemies are near" is a one-line change, and the review is a normal pull request.

music/dungeon.song.yaml
@@ -105,3 +105,6 @@   main: [a, b, a, c] arrangement: [main] loop: main                    # the whole song loops++variants:                     # each one is music/dungeon.<variant>.wav, same bars and loop points in bars+  danger: { tempo: 124, instrument_swap: { q: r } }   # enemies near: faster, a thinner, edgier arpeggio

2 Kits are the palette

A kit maps one-character keys to synth instruments and drum macros. Songs write those keys in their step grids, whose rows are the notes of the song's key, so an off-key note can't be written. Every song made with a kit sounds like the same game. Click a key to hear it.

arcade_synthfm_softnes

Bright 80s arcade synth: filtered saw lead, square bass, fast arpeggio, punchy drums.

lsaw_leadsawmsquare_basspulse duty 0.5aarppulse duty 0.25zzappulse duty 0.3kkickdrum kickssnaredrum snarecclapdrum claphhatdrum hat

3 One mix for everything

Every sound goes through one shared mix: room, tone, crush, limiter and loudness targets. "Punchier and drier" is segan mix adjust --room -0.1 --brightness 2, and every asset follows.

A: beforeB: after

▶ jump▶ coin▶ hurt

4 It checks its own work

Lint catches what an agent can't hear: lead-in silence (input lag), clicks at loop points, clipping, aliasing, off-key clashes, loudness out of reach. A real finding, from the stomp's first version:

W005 stomp starts after 38 ms of near-silence (> 5 ms)

Fixed: every layer starts at 0, 0 warnings

5 Loops that don't click

Looping songs end with the loop's first bar again, so the tail rings into the start, and the manifest gives loop points in samples. This player loops on them, sample-exact, like a game.

6 Variations, not repetition

Sounds that play all the time get variations: small pitch and timbre changes, each normalised. Godot gets an AudioStreamRandomizer. Press "play again" a few times.

7 Variants that switch in time

danger: { tempo: 124, instrument_swap: { q: r } } is a whole second version of the song. Switch while it plays: it jumps to the same bar, from the manifest's timing.

8 Loudness that matches

Every asset is normalised to its category's target (music -16 LUFS, SFX -14, UI -20, footsteps -22), so nothing jumps out. segan gallery draws all of them, with this chart at the bottom:

9 Free, open, local

MIT-licensed. Runs on your machine, offline. No account, no credits, no API key, no cloud. Builds are deterministic: the same sources give byte-identical WAVs.

10 Built for agents

A Claude skill that teaches the whole workflow (including how to read a listen sheet honestly), an MCP server with 22 tools that returns listen sheets as images, --json on every command, and a long-term memory in the project: BRIEF.md, SOUND.md, asset status.

11 Honest about hearing

An agent can't hear, so SEGAN never lets it pretend: every asset stays status: draft until a human listens and runs segan mark --status approved. Everything on this page is still a draft.

12 Engine-ready

manifest.json describes every file: length and loop points in samples, sections, bars and markers, variants, variations, phases and stems. Any engine can read it. For Godot 4, SEGAN also writes the loop points into each WAV's .import, an AudioStreamRandomizer per varied SFX and an AudioStreamSynchronized per song with stems.

manifest.json (shortened)
{
 "dungeon": {
  "kind": "song",
  "file": "res://assets/generated/audio/music/dungeon.wav",
  "samples": 952560,
  "sample_rate": 44100,
  "bpm": 100,
  "bars": 8,
  "loop": {
   "end": 952560,
   "end_seconds": 21.6,
   "offset": 105840,
   "section": "main",
   "start": 105840,
   "start_seconds": 2.4
  },
  "lufs": -16,
  "variants": {
   "danger": {
    "file": "res://assets/generated/audio/music/dungeon.danger.wav",
    "bpm": 124,
    "loop": {
     "start": 85355,
     "end": 768194
    }
   }
  },
  "stems": {
   "drums": {
    "channels": 2,
    "file": "res://assets/generated/audio/stems/dungeon/drums.wav",
    "loop": {
     "end": 952560,
     "start": 105840
    },
    "samples": 952560,
    "seconds": 21.6,
    "tracks": ["drums"]
   },
   "…": "3 more"
  },
  "godot_stems": "res://assets/generated/audio/stems/dungeon.tres"
 }
}

# Godot 4
var music: AudioStreamSynchronized = load("res://assets/generated/audio/stems/dungeon.tres")
music.set_sync_stream_volume(1, -60.0)   # stream_1 = drums: out while exploring
$Music.stream = music
$Music.play()                       # every stem in sync

# a fight starts: bring the drums in
music.set_sync_stream_volume(1, 0.0)

$Coin.stream = load("res://assets/generated/audio/sfx/coin.tres")
$Coin.play()                        # a different variation each time

Four kinds of tool

Facts as of October 2026, from each tool's own documentation. Pick what fits your game.

Where SEGAN loses: it isn't a recording studio or a composer. For realistic foley, orchestral scores or vocals, a sample library or an audio generator is better, and SEGAN can't judge taste: a human has to listen. SEGAN wins on a whole game's worth of retro-synth sounds and loops that match, loop cleanly, and change together.

One line, then ask

Requires Python 3.11+. Pin a tag so your sounds build the same way next year (v0.4.1 is current).

$ pip install "git+https://github.com/lukasgolino/segan.git@v0.4.1"  # install SEGAN (Python 3.11+)
$ segan skill install  # copy the skill into this repo's .claude/skills/

$ pip install "segan[mcp] @ git+https://github.com/lukasgolino/segan.git@v0.4.1"  # SEGAN with the MCP server
$ claude mcp add segan -- segan mcp --project ./audio  # or in any client: command `segan mcp --project <dir>`

$ pip install "git+https://github.com/lukasgolino/segan.git@v0.4.1"  # install
$ segan init audio --style chiptune  # a project: segan.toml, kits/, music/, sfx/
$ cd audio && segan new sfx coin --preset coin --description "bright pickup"  # write a sound
$ segan lint && segan preview coin && segan build  # check it, look at it, build it

Everything on this page

All 23 sounds the site's SEGAN projects build (18 SFX, 5 songs, from 3 kits in SEGAN's own demo project and the demo above), each with its cell from segan gallery. Status: draft: no human has approved them yet.

• blipui · 0.50 s · -20.0 LUFSMenu cursor move: a tiny soft square tick.SEGAN's demo project

• coinpickup · 0.69 s · -14.0 LUFSBright two-note pickup chime for coins: a square blip stepping up a fourth, short, no tail.SEGAN's demo project

• combatmusic · 14.40 s · -16.0 LUFS · loops · 1 variantDriving battle loop: E minor, 150 bpm, filtered saw lead, power-chord arpeggio, octave square bass, four-on-the-floor drums.SEGAN's demo project

• doorsfx · 1.13 s · -14.7 LUFSWooden door opened and shut: latch click, hinge creak, thud.SEGAN's demo project

• door_creaksfx · 1.36 s · -14.1 LUFSSlow, eerie wooden door creaking open, about one second: latch click, then a wavering stick-slip creak rising and sagging, no slam.SEGAN's demo project

• explosionsfx · 1.30 s · -14.0 LUFSBig chunky explosion: falling crunch noise through a closing filter over a deep thump.SEGAN's demo project

• hitsfx · 0.62 s · -14.3 LUFSMelee impact on an enemy: noise crack, falling low knock and a short body.SEGAN's demo project

• hurtsfx · 0.72 s · -14.0 LUFSPlayer takes damage: a gritty square falling a fifth with a fast wobble.SEGAN's demo project

• jumpsfx · 0.63 s · -14.2 LUFSPlatformer jump: a quick square sweep upwards, springy and short.SEGAN's demo project

• lasersfx · 0.69 s · -14.0 LUFSRetro blaster shot: a bright square diving two octaves with a fizzy top.SEGAN's demo project

• overworldmusic · 22.00 s · -16.0 LUFS · loops · 2 variantsUpbeat exploration loop: A minor, 120 bpm, NES-style pulse lead over an arpeggio, triangle bass and noise drums. Loops seamlessly after a two-bar intro.SEGAN's demo project

• poweruppickup · 1.00 s · -14.0 LUFSPower-up collected: a fast major arpeggio climbing an octave with a sparkle.SEGAN's demo project

• selectui · 0.56 s · -20.0 LUFSMenu confirm: two quick rising triangle notes a fifth apart.SEGAN's demo project

• shopmusic · 21.60 s · -16.0 LUFS · loopsCosy item-shop loop: F major, 100 bpm, soft FM electric piano and flute over round FM bass and brushed drums; 8 bars, loops seamlessly.SEGAN's demo project

• stepfoley · 0.48 s · -22.5 LUFS · 4 variationsFootstep on stone: a short filtered tap, four variations so repeats don't sound robotic.SEGAN's demo project

• thememusic · 9.38 s · -16.0 LUFS · loopsTitle theme: A minor, 128 bpm, a pulse lead over driving triangle-bass eighths and noise drums. Am F | C G, four bars, loops seamlessly.Hero

• jingleui · 0.92 s · -20.0 LUFSSEGAN's sound logo: five rising square notes (S-E-G-A-N: E5 G5 A5 C6 E6) with a triangle echo an octave up.Hero

• jumpsfx · 0.65 s · -14.2 LUFS · 4 variationsSpringy platformer jump: a thin square sweeping up C4 -> G5 in 0.14 s, with a tiny airy lift on top.Platformer demo

• coinpickup · 0.69 s · -14.0 LUFS · 4 variationsCoin pickup: a bright square stepping up a fourth (B5 -> E6) with an octave shimmer, short, no tail.Platformer demo

• stompsfx · 0.65 s · -14.1 LUFS · 4 variationsLanding on an enemy: a squashy square bounce down an octave over a short kick thud, with a soft pop.Platformer demo

• dungeonmusic · 21.60 s · -16.0 LUFS · loops · 1 variantDungeon exploration loop: D harmonic minor, 100 bpm, a vibrato pulse lead over a soft arpeggio, triangle bass and sparse drums. Tense, not scary; 8 bars, loops seamlessly.Dungeon demo

• chargesfx · 1.21 s · -14.0 LUFS · phases charge, releaseCharge shot: a rising, trembling square while the button is held (looping), then a heavy blast on release.Space shooter demo

• boss_explosionboss · 2.40 s · -11.6 LUFSThe boss blows up: the explosion stretched to 2.4 s, a lower thump, an echoing second blast; louder than normal SFX (category boss).Space shooter demo

Straight answers

More in the docs.