TBOSS

TBOSS 2.0, with 1.8 and 1.9 (which were not released on their own). Install it from the browser: https://armandhammer.github.io/TBOSS/install.html (Chrome or Edge; click Save settings first to keep your settings).

New in 2.0 (manual)

• Turing pattern for the arpeggiator: a random loop of the held notes that changes a little each time round.
• Chained progressions (P1 > P1 > P2 …) and each chord's chance of resting or playing the borrowed chord.
• Presets with their own chord sets, colors and curves; Clear preset on the board.
• U3 as Shift, and Shift + the buttons under the screen on every screen.
• Sleep and Shut down.
• The step sequencer: Fill steps, nudge, each lane's swing and transpose, Mutate and Stutter.
• Spread of Bass, and the Settings menu rebalanced into 17 pages.
• The web editor has its own USB port (TheoryBoard Editor), so your DAW keeps playing while it is connected. Leave that port off in the DAW. The editor follows changes made on the board.

New in 1.9 (manual): the board set up from the web editor: every setting, seven color schemes, velocity and pressure curves drawn with the mouse and a calibration, the step lanes as a grid, the chord pads' edits, presets named, copied and compared.

New in 1.8 (manual): MPE, Glide, Vel full with the Firmer and Firmest curves, and play/stop on the step screen.

Tested on one board with Ableton Live. Settings → About shows 2.0; the web editor's header shows the build, 2.0.8.

theoryboard-usb.bin: 119,768 bytes, SHA256 7e21929924e5d2afad174f11bdf47b2ae629f18c2d725743ba11bd8faf65ebea (reproducible: python scripts/tboss_build.py).

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings, presets, scales, progressions, chord sets, buttons and step pattern when updating. Unplug the power adapter too before entering update mode, if one is plugged in.

TBOSS 1.7 is the next release after 1.5 (it includes the features of 1.6, which was never announced). Every new option is off, or plays as before, until you change it. From this version on, releases are named by their major and minor number: the board's About screen says 1.7.

New since 1.5

• A deeper step sequencer: each step gets its own velocity, gate, tie, chance, ratchet (2–8 strikes) and condition (1:2 … 4:4, first time round, every time but the first); hold steps, ▲/▼ choose, ◀/▶ change. Lanes run forward, reverse, ping-pong or random, and Euclid fills a lane with evenly spread hits (Settings → Sequence).
• Four MIDI effects: Harmony (diatonic harmony on the melody pads, always in the scale), Echo (a MIDI delay locked to the tempo or your DAW's clock), Mono (one melody note at a time, newest wins, legato) and Chance (the arpeggiator and note repeat skip steps at random).
• Bass layout (Settings → Layout → Layout → Bass): the original's promised bass mode. Each scale note sits on two pads side by side for fast two-finger bass lines; every hit strikes the note again.
• Program Change both ways (Settings → MIDI): each half sends its synth's sound with every preset (Chord prog, Melody prog), also just after connecting and when your DAW starts; a DAW can load presets 1–8 by sending programs 1–8 (Program in).
• Pads that play evenly on any board (Settings → Pads): Trigger, Release and Full count from each pad's own resting level, a firm press no longer sets off its neighbors, and Unstick ends a note whose pad stays down by itself. Rescan pads measures every pad again. Your pad settings are converted when you update.
• Smaller additions: Spread of Chord opens the whole chord (Settings → Chords → Spread of), held chord shapes (Add 7th …) change a running arpeggio at once, the pedal works as Sustain out of the box, and EXT shows on the play screen while a DAW's clock comes in.

Walk-throughs in the manual: what's new in 1.7 · in 1.6 · Step options · Harmony, echo and mono · Bass · Program Change · Pad sensitivity.

Going back to an older version keeps everything that version has: 1.5 plays step patterns forward without the step options, the effects off and the Bass layout as Scale.

Known limit: an echo that comes while you still hold its note is not heard.

Please check: the pedal's Target and its other modes, live notes following MIDI in, progressions started by a DAW, scale lock, and DAWs other than Ableton Live are not yet confirmed on a board. A test report is very welcome, even if everything worked.

theoryboard-usb.bin: 97,612 bytes, SHA256 749d1fce1d7a3b800a64279f238cde47f493bc0c7e0d7073e5047255aa83b4f6 (reproducible; build 1.7.10).

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings, presets, scales, progressions, chord sets, buttons and step pattern when updating. Unplug the power adapter too before entering update mode, if one is plugged in.

TBOSS 1.6 adds four MIDI effects a user asked for (ideas from the Hapax and Square Pyramid sequencers). Each one is one to three settings on a page you already know, and all of them are off until you turn them on.

New in 1.6

• Harmony (Settings → Play → Harmony): every melody pad also plays a 3rd, 4th, 5th, 6th or octave above, a 3rd and 5th, or a 3rd or 6th below, always in the current scale, so the harmony follows the key.
• Echo (Settings → Play → Echo, Echoes): a MIDI delay locked to the board's tempo or your DAW's clock, 1/16 to 1/2, with 1–8 echoes, each quieter than the last.
• Mono (Settings → Layout → Mono): the melody half plays one note at a time. The newest note wins, and the one you still hold comes back when you let go, overlapping both ways so a mono synth glides.
• Chance (Settings → Arpeggiator → Chance): the arpeggiator and note repeat skip steps at random, from 100 % (every step) down to 10 %.

Walk-throughs in the manual: what's new in 1.6 · Harmony · Echo · Mono · Chance.

Going back to an older version keeps everything that version has; a version before 1.6 gets Harmony, Echo, Mono and Chance off.

Known limit: an echo that comes while you still hold its note is not heard.

Please check: the pedal's Target and its other modes, live notes following MIDI in, progressions started by a DAW, scale lock, and DAWs other than Ableton Live are not yet confirmed on a board. A test report is very welcome, even if everything worked.

theoryboard-usb.bin: 92,632 bytes, SHA256 986cf4cc11e7da0df3e94bffb8593549a0f0302322fe25a1594706de51fb09d6 (reproducible).

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings, presets, scales, progressions, chord sets and buttons when updating. Unplug the power adapter too before entering update mode, if one is plugged in.

TBOSS 1.5 brings 1.4 with it (1.4 wasn't released on its own): a step sequencer, faster pads, rhythms for the arpeggiator and note repeat, pivot chords, chord capture, and fixes for the sustain pedal and for pads that stuck or skipped notes. Everything new is optional: the board plays as before until you turn it on.

New in 1.5

• Step sequencer: four lanes of steps that play with the board's tempo or your DAW, next to a progression. A lane plays chords, a melody or drums, each with its own length (1–64 steps), rate and MIDI channel, so lanes of different lengths drift against each other. You edit it on the pads: Settings → Sequence → Steps. This is the foundation; gate, ties, probability, ratchets and more patterns come in later 1.5 updates.
• Faster pads: notes sound sooner after a touch (about 6 ms on average instead of about 16), and fast repeated hits on one pad each play.
• Chords on the right: Settings → Layout → Chords on → Right swaps the halves (chords on the right, melody on the left).
• Rainbow colors: Settings → Lights → Colors → Rainbow lights both halves in seven fixed colors whatever you play: red, orange, yellow, green, dark blue, light blue, magenta, then again. The colors by note are now called Default.

New in 1.4

• Rhythms for the arpeggiator and note repeat: 5 and 7 notes per beat, more triplets and dotted values, Euclidean rhythms (3/8 …) with Rotate; note repeat keeps to the beat, and By row gives each row of the melody half its own speed for two-finger polyrhythms.
• Pivot chords: pick a key to move to and the chord pads light the chords the two keys share, the best way in pulsing.
• Chord capture: play chords on the pads or from your DAW and the board makes a chord set of them, in the key they fit best.
• Reset options on every settings page, and Settings → About → Factory settings (presets, scales, chord sets and progressions stay).

Fixed

• The sustain pedal did nothing (user report): earlier versions listened on the wrong pin. Settings → Pedal → Mode turns it on (Off by default); Note now shows only when Mode is Note.
• Pads that stuck on or skipped notes on boards whose pads rest unevenly: each pad now has its own resting level, measured at start-up and followed while it rests. The Pad test shows it.

Walk-throughs in the manual: what's new in 1.5 · what's new in 1.4 · a drum beat and a bass line.

Going back to an older version keeps everything that version has; the step pattern is left out of versions before 1.5.

Please check: the pedal's Target and its other modes, live notes following MIDI in, progressions started by a DAW, scale lock, and DAWs other than Ableton Live are not yet confirmed on a board. A test report is very welcome, even if everything worked.

theoryboard-usb.bin: 90,428 bytes, SHA256 ffa535fe711cde1292e0c0078d7582ee278fd4cce149d5e5a62d16c00bed6b3b (reproducible). Updated 2026-10-24: Rainbow now uses seven colors, as its requester asked; nothing else changed (the first file was 90,380 bytes, 9a3f84c5…01df).

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings, presets, scales, progressions, chord sets and buttons when updating.

TBOSS 1.3 adds two new ways to lay out the chord pads. Both are optional: Settings → Chords → Chord set. The board plays as before until you pick one.

Chord grid: a chord type on every row

Each column is a step of the scale, as before, and each row is one kind of chord, the same in every key and scale:

Row	Columns 1–7 in C major
Top: ninths	Cmaj9, Dm9, Em7♭9, Fmaj9, G9, Am9, Bm7♭5♭9
Sus	Csus4, Dsus4, Esus4, Fsus2, Gsus4, Asus4, B–E–F
Sevenths	Cmaj7, Dm7, Em7, Fmaj7, G7, Am7, Bm7♭5
Bottom: triads	C, Dm, Em, F, G, Am, Bdim

A ii–V–I is columns 2, 5, 1 on the sevenths row, in any key, with no button to hold. Voicing I–III, voice leading, Fold, strum and the arpeggiator work as usual; a center button set to Add 9th (or another shape) still adds while held.

Full chord layout: the original's

The original TheoryBoard's default layout (discussion #8): every pad a different chord, each chord of the scale followed by its variations (C, Cadd9, C6, C6/9, Cmaj7 …), lit in its root's color. The chord lists and voicings are the original firmware's own, read from the board's memory chip (never written), with permission from its developer.

Walk-throughs in the manual: what's new in 1.3 · the chord grid · the Full layout.

Also

• The web editor has Chord grid on the TB and Full layout on the TB buttons, and names a progression's chords as the grid or Full plays them. A progression recorded on either keeps its chords.
• A center button set to Next chord set steps through the scale's chords, the grid, Full and your chord sets.
• Settings → Lights → Colors (it said "Colours").
• Going back to 1.0 plays the scale's chords instead of the grid or Full and keeps everything else.

Please check: scale lock, progressions started from a DAW and the sustain pedal input are still not confirmed on a board. A test report is very welcome, even if everything worked.

theoryboard-usb.bin: 74,900 bytes, SHA256 f7b623bb2be4f670234eb49aeed96e878e4cbb9ab6f8b52b04ce972ffd9e9829 (reproducible).

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings, presets, scales and progressions when updating.

TBOSS 1.0 is feature complete and tested on a board: this is the beta. Everything new is optional, so the board plays as before until you turn it on. New ideas (a phrase recorder, chained progressions) are planned for 1.5.

Chord sets: any 12 chords on the chord pads

Type a set in the web editor's new Chord sets panel, for example C Dm Em F G Am Bb Ab Fm D7 E7 G7 (the key with its borrowed chords and secondary dominants), or a song's chords in the order you play them. Eight sets; Settings → Chords → Chord set picks one.

• The root buttons transpose a set; the rows above play its inversions; voicing, spread, strum, hold and the arpeggiator work as usual.
• A column can be left empty (-), and ' puts a chord an octave higher.
• A progression recorded on a set keeps playing that set's chords.

Theory hints

Settings → Chords → Hints: after each chord, the chord that usually comes next pulses, the other common ones glow, and the rest dim. In C major, after C: F pulses, G and Am glow.

Center buttons you assign, and Shift

Give any of the 14 center buttons its own job (Settings → Buttons, or the editor's Center buttons panel). The choices include the arpeggiator, sustain on/off, a 7th, 9th, 6th or sus while held, all notes off, tap tempo, next preset or scale, play and record. Make one a Shift button (hold it, or tap twice to latch it):

• Shift + root button 1–8 plays progressions P1–P8.
• Shift + mode button 1–8 loads presets 1–8.
• Shift + a chord pad picks that chord for editing without playing it.

Scale lock

Settings → MIDI → Scale lock: notes your computer sends on one channel come back out of the board moved to the nearest note of its key and scale. Play any keyboard or generative MIDI tool and stay in the key the board shows.

Step-by-step walk-throughs in the manual: what's new in 1.0 · a set of borrowed chords · a song's chords, then a progression · theory hints · center buttons and Shift · scale lock.

Also

• Backups and the installer's Save settings include chord sets and the buttons. Going back to 0.11 leaves them out and keeps everything else.
• Fixes from a full code review: a progression recorded on a chord set keeps its chords in the editor. All notes off also ends a progression's chord while a DAW plays. Tapping Sustain no longer writes to the board's memory.

Please check: scale lock and progressions started from a DAW are not yet confirmed on a board, and neither is the sustain pedal input. A test report is very welcome, even if everything worked.

theoryboard-usb.bin: 71,616 bytes, SHA256 7ffae3962605818468b20d55cefeeb4b230312fde426fdc0fb355e0b7bff2267 (reproducible; GitHub's own build matched).

Superseded by 1.0.0 beta (chord sets, theory hints, center buttons, scale lock); the installer offers the newest version.

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings when updating.

Chord progressions: the board plays your song's chords

Record a song's chords by tapping chord pads, then let the board play them in time while your hands are free for the melody. There are 8 slots (P1–P8).

Quick start: Settings → Play → Arrows → Sequencer. On the play screen, ▼ starts recording; tap chord pads, one tap per unit (1 beat, ½ bar, 1 bar or 2 bars; tapping the same chord again lengthens it, ◀ takes back the last one), and ▼ again saves. ▲ plays and stops.

• Transpose and re-color live: the root buttons move a playing progression to any key, and the mode buttons re-color it (Am F G in A minor becomes A F♯m G♯dim in A major).
• Chords from outside the scale: a chord recorded while another mode is pressed keeps that mode, so a song like Am D Dm Am C G E7 Am goes in (D from Dorian, E7 from harmonic minor) and stays as recorded.
• In time with your DAW: the progression starts with your DAW's Start, follows its tempo and song position, and Continue carries on where it stopped. It also plays from ▲, Settings → MIDI → Transport or the pedal (Play/Stop).
• Guide lights: the playing chord's pad glows white and the next one pulses, and the right half shows which melody notes fit the chord now.
• Type it instead: the web editor's new Progressions panel takes Am D Dm Am C G E7 Am as text and finds the pads and the borrowed scales for you.
• Everything that shapes a chord applies: voicing, spread, strum, voice leading, fold. With the arpeggiator on, the progression feeds it.

Step-by-step walk-throughs in the manual: record and play Am F G · a song with borrowed chords · type a song in the web editor · all of Progressions.

Also new

• Chord vel and Melody vel: a velocity curve for each half (Settings → Play), for example chords at an even Fixed 100 under a dynamic melody. Your old Velocity setting carries over to both. Progression chords play as hard as you tapped them, or at 100 with Chord vel Fixed 100. (Velocity)
• Pedal Target: send the sustain pedal to the chords, the melody or both, when the halves are on different MIDI channels (Settings → Pedal → Target). (Sustain pedal)
• Settings backups and the installer's step 2 now include your progressions.

Please check: record a progression, play it with your DAW, and send a test report. Reports from anyone with a sustain pedal are especially welcome: the pedal input is still not confirmed on a board (Settings → About → I/O test shows what the board sees).

theoryboard-usb.bin: 64,912 bytes, SHA256 d8a145d11648b4ef9a4275db8c58e1043137343289c064d560949c75587a5b3c (reproducible; GitHub's own build matched).

Superseded by 0.11.0 (chord progressions); the installer offers the newest version.

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings when updating.

Pad sensitivity: your TheoryBoard plays from a light touch

Set how lightly the pads play. Settings → Pads has three points, each adjustable in steps of 100:

• Trigger (default 1200): how light a touch starts a note.
• Release (default 600): how far you lift before the note ends. Aftertouch and other pressure count from here.
• Full (default 3500): how hard counts as maximum velocity and full pressure.

The new defaults play from a light touch, so most players no longer need a sensitivity mod. If you have one, raise Trigger (around 1900 is a good start) so neighbouring pads stay quiet. Settings → Pads → Pad test shows your pads' readings, so you can set it by numbers instead of guesswork. The manual walks you through it.

The board protects itself: each time it starts playing, it measures where your untouched pads rest and keeps Release above that, so a board whose pads rest high still releases every note. Pad test shows the measured level (REST) and marks any value it had to raise with !.

Changed

• The pads feel lighter after updating. Up to 0.9.1 the thresholds were fixed at 2500 / 1500 / 4000. For the old feel, set Trigger 2500, Release 1500, Full 4000.
• Pad test moved from Settings → About to Settings → Pads, and shows the values in use.

Please check: play with the defaults, try a lighter Trigger, and send a test report, especially if you have a sensitivity mod or an overlay.

theoryboard-usb.bin: 59,476 bytes, SHA256 3b0b3fabcdca1749fa3ecd0d40ec38d644a70a74ac9b5d709e911ca5aef0e3f9 (reproducible; GitHub's own build matched).

Superseded by 0.10.0 (pad sensitivity); the installer offers the newest version.

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings when updating.

A reliability update with a new measuring page. Nothing changes how the board plays out of the box.

Pad test (Settings → About → Pad test)

See what your pads measure, as numbers: the pads reading highest right now, how far a touch went (PEAK), the velocity the last note got, and how much a press spreads to the neighbouring pads. Useful if light touches don't register, a pad seems weaker than the others, or you use an overlay or a sensitivity modification. If you report a sensitivity problem, please include these numbers. The manual has a walk-through, and its Velocity section now explains what the Velocity settings do and don't change.

Fixed

• Notes left droning on a TRS synth when the computer is unplugged or goes to sleep mid-chord: they now end a few seconds later (with TRS out on and the board still powered).
• Pitch bend, aftertouch and pressure controllers now always return to rest: after a slow release (a bend could stay a few cents sharp), and when the web editor talks to the board while you hold a pad (a bend could stay fully up).
• Transport: with the board's transport running, using the web editor made a following DAW or drum machine jump back to bar one. It now pauses and continues (Stop, Continue).
• Voice lead with Voicing III and a very high chord octave could stop the board playing until Voice lead was turned off; such a pad now plays its row's chord.
• The buttons stopped working after 49.7 days of continuous power; they now keep working.

These came out of a code review with long randomised stress tests of the engine, layouts, controls and settings, now part of the test suites that run on every change.

Please check: Pad test on your board, and send a test report.

theoryboard-usb.bin: 58,700 bytes, SHA256 b2ff14791d69c0a1d8dd1b5c4f06cd93e73535fc3cd056fe3f6800a443a7fbeb (reproducible; GitHub's own build matched).

Superseded by 0.9.1 (pad test page, reliability fixes); the installer offers the newest version.

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings when updating.

Out of the box TBOSS plays like a regular TheoryBoard: everything below is off until you turn it on. The manual now walks through every feature with an example, why you'd use it and when not to.

Live notes (the original's promised Live Note Update)

• Settings → Layout → Layout → Live notes: columns 1–7 of the right half play the scale, columns 8–12 the notes of the chord you just played (C gives C E G C E). Solo over any chord without a wrong note.
• Live ch: give the live notes their own MIDI channel. Live in: chords your DAW sends to the board set the live notes.
• Settings → Chords → Sound Off: a chord pad that only picks the live notes, silently.

Smoother chords

• Voice lead (Settings → Chords): each chord takes the inversion that moves least from the chord before, so C → F → G plays C E G → C F A → D G B, like a pianist's hands.
• Fold (Settings → Chords): every chord inside one octave, as the original TheoryBoard's chords are described. TBOSS doesn't fold unless you turn it on.

Note repeat

• Settings → Play → Note repeat (1/4 to 1/32): hold a right-hand pad and it strikes again on every step, louder as you press harder. Hi-hat rolls in the Drums layout, pulsing synth notes.

Changed

• Tempo moved to Settings → Play (it drives the arpeggiator, note repeat, strum in note values and clock out).
• Live update is now called Restrike (held pads re-struck when you change key, scale, panel or live chord).

Please check: Live notes from your DAW (Live in), and note repeat with your instruments. Send a test report.

theoryboard-usb.bin: 57,420 bytes, SHA256 da6fe85255d37bc498668df7aea57728402783b79b630ad162e2098ced9b3c85 (reproducible; GitHub's own build matched).

Superseded by 0.9.0.

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings when updating.

Scales

• 86 built-in scales (61 new): pentatonics, six-note scales, Hungarian, Neapolitan, Persian, Indian thaats, bebop, Messiaen's modes and more. All are in Settings → Play → Scale.
• Families on M1–M7: Settings → Play → Family. Choose Major (as before), Melodic minor, Harmonic minor or Harmonic major, and M1–M7 play its seven modes. For example, M4 in Melodic minor is Lydian dominant.
• Favourites: keep up to 128 scales on the board. With Settings → Play → Arrows on Scale, ▲/▼ step through them.
• Scale library in the web editor:
  • browse by family, or from bright to dark;
  • find by notes: click them, or play them on any MIDI keyboard;
  • one note away: the scales you get by moving one note a semitone;
  • play a scale on the board, add it to favourites, or copy it to your own slots.

Strum

• Feel: Settings → Strum → Feel time (each note up to 40 ms late, at random) and Feel vel (up to ±30 velocity, at random) give a looser, more human strum.
• Guitar voicing, now on six real strings: standard tuning, open-chord shapes on the bottom row (C x32010, G 320003, D xx0232…), and positions up the neck on the rows above.
• Capo: Settings → Strum → Capo (frets 1–11) keeps the key but changes the shapes and sound.

Please check: does the guitar voicing sound like a guitar, with and without the capo? Does the feel sound natural? Send a test report.

theoryboard-usb.bin: 53,680 bytes, SHA256 1886fb4014c25904a18c1eabb60e99bff9f67f04cbd35f3bdea6d34d9c8d1146 (reproducible; GitHub's own build matched).

Superseded by 0.7.0.

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings when updating. New since 0.5.1: the chord panel, drums, more scales, strum and arpeggiator extras (see 0.6.2).

Changed

• The five buttons below the screen now light at 70 %. They were very dim before.

Confirmed on a board

• TRS MIDI out (Type A): a MIDI interface reads its messages correctly.

Manual

• New section: TBOSS and the original TheoryBoard. It compares TBOSS with the original's features and with the features promised in 2020.

theoryboard-usb.bin: 50,628 bytes, SHA256 967e07dc480f4d6468f638237971896d1516488665583a291fa1a3fa61fc1d92 (reproducible; GitHub's own build matched).

Superseded by 0.6.3.

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings when updating.

Everything in 0.6.0 and 0.6.1, plus:

Changed

• Octave buttons toggle: each tap turns that octave on or off, and every lit octave plays (lit octaves stack).
  • To move to a single octave, tap the new one, then the old one.
  • Turning off the last lit octave goes back to 0.
  • Quick taps no longer stack by accident. In 0.6.0 and 0.6.1 stacking needed a held button, and a finger still lifting counted as held.
• Unlit panel buttons are dimmer: 15 % instead of 30 %. Lit buttons stay at 100 %.

theoryboard-usb.bin: 50,604 bytes, SHA256 dc999f645468acb8b01d8c5346471139786aabb4c094c869882ee21e608c6f9b (reproducible; GitHub's own build matched).

Superseded by 0.6.2 (octave buttons toggle; quick taps no longer stack by accident).

Pre-release. The installer still offers 0.5.1 by default. To try 0.6.1: download theoryboard-usb.bin below, open the installer in Chrome or Edge, and pick it under Or use a file. Step 2 keeps your settings (0.5.x and 0.6.0 settings and backup files carry over).

Everything in 0.6.0, plus fixes from its first board check:

Fixed

• Octave V: the seven buttons now do what they say, −3 to +3. In 0.6.0 most of them picked a different octave. Voicing and spread were already right.

New

• Panel lights: a centre button is fully lit while its choice is on and dim (30 %) otherwise, so the panel always shows the voicing, spread and octaves in use.
• ▲ / ▼ on the play screen follow Settings → Play → Arrows:
  • Scale (default): next / previous scale, through all 37, including the extra scales and U4–U12, which have no button.
  • Melody octave
  • Preset
  • Tempo: 5 BPM per press.
• Melody octave is also Settings → Play → Melody oct (−2 to +2).
• Hold ◀ + ▲ / ▼ still switches presets.

Please check: that each panel button's own light goes full when you press it. Send a test report if one doesn't.

theoryboard-usb.bin: 50,616 bytes, SHA256 2cf5cfeab588fc76eb9da9f1261a9661316639440d24f9f65f1142f14bad7a7b (reproducible; GitHub's own build matched).

Superseded by 0.6.1: the octave V buttons are out of order in 0.6.0.

Pre-release, not yet checked on a board. The installer still offers 0.5.1 by default. To try 0.6.0: download theoryboard-usb.bin below, open the installer in Chrome or Edge, and pick it under Or use a file. Step 2 keeps your settings (0.5.1 settings and backup files carry over).

The chord panel works as printed

• Voicing I / II / III / guitar apply to every chord pad. Press again to turn it off.
• Spread I / II / III drops the lowest root 1, 2 or 3 octaves.
• Octave V: tap a button to move the chords to that octave. Hold one and tap others to play the chord in several octaves at once.
• The per-pad edits (add 7th / 9th / 6th, sus, strum on/off for one pad, reset) moved to Settings → Chords.

New

• Layouts (Settings → Layout): the melody half can be Scale, Chromatic, Fourths or Drums. Drums splits it into scale, bass and General MIDI drum grids, each on its own channel.
• Scales: 13 more built-in scales (blues, whole tone, harmonic major, Hungarian minor, Phrygian dominant, double harmonic, both diminished, bebop dominant, hirajoshi, in sen, Lydian dominant, altered); 12 user scales (U1 to U12) in the web editor.
• Strum: repeat while held, cutoff, strum times as note values at the tempo, and strum off for single pads.
• Arpeggiator: 8-step rhythm patterns, swing, sync start, a Chords pattern and latch.
• Expression: pitch bend from pressure, Light and Firm velocity curves, and an option for held pads to follow key changes.
• Pedal (Settings → Pedal): sustain, sostenuto, soft, portamento, play/stop, or a drum note.
• MIDI clock out with Start/Stop (Settings → MIDI).
• Violet and pink pad colours are further apart.

Changed shortcuts

• ▲ / ▼ on the play screen move the melody octave.
• Presets are now hold ◀ + ▲ / ▼.

Please check: press each centre button and check that the screen names its printed icon. The order of the panel buttons comes from a photo. A mismatch is a quick fix; please send a test report.

theoryboard-usb.bin: 50,024 bytes, SHA256 968a1340ce88ebb2f88300d147d170fff3809bc984fa35b74747a9f2b664391f (reproducible; GitHub's own build matched).

Superseded by 0.6.2.

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings when updating.

Fixed

• Pads never reacting / no MIDI: if any pad read as pressed when the board started, it refused to start playing at all. Now it starts anyway; only that pad stays silent until released once (it lights white). Settings → About → I/O test shows PADS HELD n and where the first one is.

New

• Rainbow pad lights (default): each pad the colour of its note, changing with root and mode; root columns brightest. Pads turn white while touched, brighter as you press harder. The previous look: Settings → Lights → Colours → Root+5th.
• Aftertouch per half: Settings → Play → Chord AT and Melody AT, each Off / Poly AT / Channel AT / CC1 / CC2 / CC11 / CC74. Chord pads now send poly aftertouch on each of their notes (notes another held pad also plays are skipped). Older saved settings apply their single pressure setting to both halves.
• Web editor: while you edit a scale, the whole board shows it (root white, scale notes in colour, others dark), the screen shows WEB EDITOR, the slot and the notes, and the editor's keys use the same colours.

TRS MIDI out and the sustain pedal (0.4.0) still await confirmation on a board: if you have a TRS Type A adapter or a pedal, please send a test report with what the I/O test shows.

theoryboard-usb.bin: 44,364 bytes, SHA256 95836fad9b3823d225bffb337b1e4572b75b16c36bc753f9742db062b9f4cc7e (reproducible; GitHub's own build matched).

Superseded by 0.5.1, which has everything here plus aftertouch per half. Please use 0.5.1.

Pre-release. Fixes boards where the pads never react and no MIDI arrives, and adds rainbow pad lights. Not yet checked on the developer's board; the installer's default stays 0.4.0 until it is.

Installing it

1. Download theoryboard-usb.bin below.
2. Open the installer, choose the file under Or use a file in step 1 (it should say TBOSS 0.5.0), then follow the steps.

Fixed

• Pads never reacting / no MIDI: if any pad read as pressed when the board started (a pad that rests slightly "pressed" on some boards), the board refused to start playing at all and kept retrying. Now it starts anyway; only that pad stays silent until it has been released once, and it lights white so you can see it. Settings → About → I/O test shows PADS HELD n and where the first one is: please include that line in a report.

New

• Rainbow pad lights (default): each pad the colour of its note, changing with root and mode; root columns brightest. Pads turn white while you touch them, brighter as you press harder. The previous look is under Settings → Lights → Colours → Root+5th.
• Web editor: while you edit a scale, the whole board shows it (root white, scale notes in colour, others dark) and the screen shows WEB EDITOR, the slot (U1–U3) and the notes.

theoryboard-usb.bin: 44,084 bytes, SHA256 1256c8d01bd92879bd92c656b06f51dfd607eb425cc16dc18010127f76e6bff5 (reproducible; GitHub's own build matched).

Superseded. This is an older version kept for reference. Install the current release with the installer; see Getting started.

Install: open the installer in Chrome or Edge; it offers this version. Step 2 keeps your settings when updating.

New

• TRS MIDI out (Type A adapter): everything the board sends over USB also goes to the jack. With no computer (USB charger or power bank), it plays to the jack alone after about 3 seconds. Settings → MIDI → TRS out.
• Sustain pedal: Settings → Pedal → Mode: Sustain (CC64), Hold (the board's hold while pressed) or Off. Off by default until the pedal input is confirmed. Type: Auto (plug the pedal in before switching on), Normal or Inverted.
• Settings → About → I/O test: shows the pedal input (PD13) and two alternatives (PA10, PD5) live, and sends middle C to the TRS jack every second.
• Installer: never waits forever when the board restarts; the log says clearly which image it installs.

Status

Checked on a board for everything except the jacks themselves: USB playing, menus, settings, editor, starting without a computer. The TRS jack and the pedal input are not yet confirmed: their pins come from the board's previous firmware. If you have a TRS Type A adapter or a pedal, please post a test report with what the I/O test shows.

theoryboard-usb.bin: 43,084 bytes, SHA256 69cf4eaf8184280d7dad68ddd10643b20d52a94a58fc217d6c7b8c877a5f6ef2 (reproducible; GitHub's own build matched).

Superseded. This is an older version kept for reference. Install the current release with the installer; see Getting started.

Alpha. A basic feature set that runs on a real board (tested on one unit so far). Please report what works and what doesn't: Issues · Discussions.

Install from the browser (Chrome or Edge, USB cable only): https://armandhammer.github.io/TBOSS/install.html. See the installation guide.

New since 0.2.0

• Browser installer using the board's own update mode. The board's start-up loader is never touched, so you can always repeat the install.
• Settings, presets and user scales are kept across an install (step 2 on the installer page).
• Settings menu as pages, driven by the five buttons below the display: ◀ back, ▲/▼ move or change, ● enter, ▶ deeper; only ◀ leaves (hold ◀ + ● goes straight home). On the play screen: ● opens the settings, ▶ hold, ▲/▼ presets.
• Version on the start-up screen and in Settings → About, also shown by the web editor.
• Web editor and installer hosted at https://armandhammer.github.io/TBOSS/.

Known issues

See the manual. Highlights: the arpeggiator is switched on and off in the menu only; it uses a test USB ID for now; no sequencer or drum mode yet.

theoryboard-usb.bin: 41,176 bytes, SHA256 a0d17a07d8830b20ba3dd826bfde57f616503cf17de57b798e53b814be7d2d3a (reproducible with Arm GNU Toolchain 14.3.Rel1, see building).

Superseded. This is an older version kept for reference. Install the current release with the installer; see Getting started.

First public release of TBOSS, open-source firmware for the TheoryBoard THY333.

Features: scale-degree chords (four voicings) and melody on 96 pressure pads; any key and scale plus three custom scales from the web editor; chord edits and chord names on the display; hold, strum and an arpeggiator with MIDI clock sync; separate MIDI channels for chords and melody; pressure as aftertouch or CC; 8 presets; pad lights for incoming MIDI; settings and external-memory backup from the browser.

Install: follow docs/flashing.md (needs an SWD adapter) with theoryboard-usb.bin below. Make the backup first. Then read the manual.

Image: theoryboard-usb.bin, 40,224 bytes, SHA256 3a6268580496cc1a4347dcd9162e16a4ce7e0a18858984cdac33cb3a691d2f86. Built from this tag with python scripts/tboss_build.py and Arm GNU Toolchain 14.3.Rel1 (reproducible).

Status: runs on a real board; tested on one unit so far. Reports from other boards are welcome in Issues.