Subsample configuration: library
The 4 settings under library, each with the type, default and limits its schema declares.
The playable sample library: where Subsample loads samples from, how much memory they may use, and where named references come from.
max_memory_mb in library
- Type
number- Limits
- above 0
Memory, in MB, for the samples held in the library. When a new sample would go over it, Subsample drops the oldest samples from memory; files on disk are never deleted. When absent, it is a share of max_memory_mb.
directory in library
- Type
stringornull- Default
samples/captures
Directory of samples to load at start-up, including its subdirectories. Subsample recreates missing .analysis.json and .preview.png sidecars, and deletes sidecars whose audio has gone. null loads nothing in bulk, so every sample comes from the MIDI map's directory: and path: rules, and watch has nothing to watch. A programs: block in the MIDI map overrides it.
reference_directory in library
- Type
stringornull- Default
null
Directory of reference fingerprints that a MIDI map can name in where: { reference: ... }. null uses the General MIDI set that ships with Subsample, so a name such as GM46_OpenHiHat resolves on any machine. Set it to a directory of your own references, whose names then replace the built-in ones. A reference given as a path is not affected.
watch in library
- Type
boolean- Default
false
Loads audio files that appear in library.directory while Subsample runs, without a restart. Subsample waits until a file stops growing, analyses it when it has no sidecar, and adds it to the library. Only the top level of the directory is watched. Requires library.directory and player.enabled.