Files
OrbitTv/docs/sound-kit.md
T
pauljdandClaude Opus 5.5 70d03836e0 The Orbit sound kit (0.120.0, versionCode 311): 28 gentle SoundCraft effects, wired into every Arcade game
- design/arcade/sounds: each sound a SoundCraft session (editable .scraft kept), soft sine and
  triangle patches, filtered and levelled, delivered as small mono Ogg (133 KB for the kit)
- ArcadeSfx: the kit, each sound's level, most-at-once, gap and priority; SfxLimiter (the oldest
  gives way); ArcadeAudio.sfx() reads the settings at most every 250 ms, so playing allocates nothing
- Originals: Orbi-Raiders (new boss-hit and damaged events), Orbiteroids, Channel Chaos, Orbit Rush,
  Night Shift, Test Card Tangle, Codebreaker, Quiz Night
- Classics: Block Drop, Blast Off, Skydoku, Comet Trail, Brick Break, Pairs, Patience (GameSounds
  hears each change of the game's value)
- A Sound effects setting for every game; Effects, Mute, Orbit Quiet and Wind Down still apply
- SoundKitTest: files present and small, lists cover the kit, caps and gaps, 0 bytes allocated

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-09 12:05:33 +00:00

5.5 KiB
Raw Blame History

The Orbit sound kit (0.120.0, versionCode 311)

Paul, 9 November 2026: "Yeah start creating and wire them in and well push it all as one update downstairs".

One set of 28 short, gentle effects shared by every Arcade game, so the whole library sounds like one family, the way it looks like one.

Where it lives

  • Sources: design/arcade/sounds/build-arcade-sounds.py. Each sound is a SoundCraft session built from SoundCraft's own subtractive synth and drum synth, with a little EQ and reverb. The editable sessions are in design/arcade/sounds/library/<name>/<name>.scraft, each with its command list and its bounce. The whoosh and the rock break also use a soft noise stem made by the script.
  • To tweak a sound: open its .scraft in SoundCraft, or change its line in KIT, then run python3 design/arcade/sounds/build-arcade-sounds.py <name> to deliver it again.
  • To hear the kit: design/arcade/sounds/kit-preview.ogg plays all 28 in a row, in alphabetical order.
  • Delivered: android/app/src/main/res/raw/sfx_*.ogg. They're mono Ogg Vorbis at 22.05 kHz, 3.6 to 7.3 KB each, and about 135 KB for the whole kit.
  • Code:
    • arcade/ArcadeSfx.kt holds the kit (Sfx), each sound's level, how many may play at once, the gap between repeats and its priority. It also holds SfxLimiter and the GameSounds helper for the Classics.
    • ArcadeAudio.sfx(sound, gameOn, scale) plays a kit sound, and ArcadeAudio.preloadKit() loads the kit when a game opens.

Keeping it gentle

  • The waves: sine and triangle for anything high, with no square or saw lead. Attacks are soft, at 2 ms or more, and tails are short.
  • The filters: every sound has a high-pass at 90 Hz and a high shelf of −5 dB from 5.5 kHz. The final low-pass is 8 kHz, or 5 to 6 kHz for the noisy ones (card, break, whoosh, turn).
  • "Wrong" is never a buzzer. Two soft low taps (nope). Being hit is a soft bonk (player_hit), and game over is three falling notes, gentle rather than sad.
  • The levels: files peak between −3 and −12 dBFS. The sounds that repeat a lot sit lowest: fire −9, tick −10 and move −12. In-game levels sit at 0.45 to 0.75 on top of that.

Settings and limits

  • Each game's own switch: every game has a Sound effects setting, in the game's settings and, for the action Originals, in the pause menu. New for Night Shift, Quiz Night, Tangle, Codebreaker, Blast Off, Skydoku, Comet Trail, Block Drop, Pairs and Patience. Brick Break's "Power sounds" is now "Sound effects", using the same saved key.
  • The Arcade-wide switches still apply: Arcade Settings › Effects and Mute all.
  • Orbit Quiet and Wind Down stay the ceiling, as for every Arcade sound. The level is read at most every quarter second, so a busy loop reads no settings.
  • Limits: each sound has a most-at-once (fire 3, hits 3, a boss beaten 1…), and the oldest stops for the newest. Each also has a shortest gap between repeats (fire 70 ms, cursor 30 ms, a level cleared 500 ms). Up to 8 sounds play at once across the pool. When it's full, shots give way first and the big moments last.
  • No allocation: playing a sound is array lookups and numbers, so nothing is created. SoundKitTest checks this: 50,000 plays allocated 0 bytes.

What plays where

Game Sounds
Orbi-Raiders fire, hit (a tough one dented), fade (an invader gone), boss hit, shield, player hit, power, wave cleared, boss beaten, game over or new best. The pilots' Overdrive sounds are unchanged.
Orbiteroids fire (a little lower, since Zip fires a lot), hit, break (a rock cleared), player hit, power, star (Drift found), sector cleared, game over or new best
Channel Chaos match, nope, whoosh (static binned), player hit (missed or jammed), power, star (bonus), shield (repaired), stage cleared, game over or new best
Orbit Rush whoosh (lane change), rise, dive, star, player hit, power, shield on, game over or new best
Night Shift move (hop), turn, light (more of the beam lit), nope (nothing to turn), power, level cleared
Test Card Tangle move, turn, light (more cable joined), level cleared
Codebreaker move, tick (a letter), back (delete), place (a try), nope, cracked or game over
Quiz Night match (right), nope (wrong), level cleared or new best at the end
Block Drop place (landed), turn, line, power (Broadcast), fade (Wind Down), game over or new best
Blast Off move, place, line, game over or new best
Skydoku move, light (placed), turn (crossed), nope (a heart lost), solved, out of hearts
Comet Trail star (eaten), a constellation lit, game over or new best (the music is unchanged)
Brick Break hit (a brick), place (off the paddle), player hit (Luna lost), wall cleared, game over or new best (the power sounds are unchanged)
Pairs move, card, match, board cleared
Patience move, turn (picked up), card (from the stock), place (a move), match (a card home), nope, back (Undo), won

Star Chase and BumbleHive keep their own sounds, as before.

Checked

  • Tests: 1,086 run, 24 skipped, 0 failed. SoundKitTest checks that every file is there and small, every list covers the kit, the gaps and most-at-once work, and nothing is allocated.
  • Lint: none of its warnings are in the new or changed code.
  • Release APK: apks/orbit-tv-0.120.0-sound-kit.apk, sha256 ef638ff2…c5b2.
  • Not checked yet: how they sound on the TV. I can't listen here, so the first test is Paul's ears. If any sound is too loud, too quiet or annoying, it's a one-line change in KIT or Sfx.level.