Understanding five terms makes the rest of Filament straightforward.
A keyswitch is a complete configuration state that you can switch to instantly during performance. Each keyswitch contains its own voice layers, routing, arpeggiators, and MIDI processing.
Each keyswitch contains 8 voice layers. A voice layer defines how incoming MIDI is processed before being routed to outputs.
A saved version of a keyswitch's complete musical configuration: all 8 voice layers, the routing matrix, arpeggiators, clip launchers, smart modifiers, and MIDI plugins.
.orch.json filesA saved version of the mixer and all its instruments: which plugins are loaded into each output row, their effect chains, articulation maps, and macro assignments.
.libset.json filesA bank defines the structure that connects orchestrations to library sets: the layout of output rows, track names, and the number of keyswitches.
.bank.json filesBanks act as the bridge between orchestrations and library sets, keeping them completely independent:
Think of it like sheet music (orchestrations) and musicians (library sets)—the bank is the seating chart that tells everyone where to sit, but the music and the players are independent.