fourier-samples 0.1.0__py3-none-any.whl

fourier/__init__.py

@@ -0,0 +1,28 @@
+"""Fourier Samples: curate a sample library into device-ready folders for hardware samplers."""
+from __future__ import annotations
+
+import os as _os
+import warnings as _warnings
+
+# librosa's and numba's warnings about a short or quiet input ("n_fft=1024 is too large for
+# input signal of length=...", "Trying to estimate tuning from empty frequency set") are
+# expected on one-shots and say nothing a user can act on, so they stay out of a build's
+# and an analysis' output, in this process and in every worker (each imports this package).
+# Errors are exceptions, never warnings, and stay visible; `fourier -v` (FOURIER_VERBOSE=1)
+# shows the warnings too.
+VERBOSE_ENV = "FOURIER_VERBOSE"
+# what to do about a missing core dependency (duckdb, librosa, soundfile: every install has
+# them, so one is missing only from a broken install)
+REINSTALL = ("it comes with Fourier Samples, so the install is incomplete: reinstall it (the "
+             "README's Updating section), then run `fourier doctor`")
+_QUIET = ((UserWarning, r"librosa(\.|$)"), (Warning, r"numba(\.|$)"))
+
+
+def quiet_library_warnings(on: bool = True) -> None:
+    """Hide (on) or show again (off) librosa's and numba's warnings in this process."""
+    for category, module in _QUIET:
+        _warnings.filterwarnings("ignore" if on else "default", category=category, module=module)
+
+
+if not _os.environ.get(VERBOSE_ENV):
+    quiet_library_warnings(True)

fourier/__main__.py

@@ -0,0 +1,5 @@
+"""python -m fourier: the fourier command."""
+from fourier.cli import main
+
+if __name__ == "__main__":
+    main()

fourier/_config/devices/digitakt_2.yaml

@@ -0,0 +1,90 @@
+id: digitakt_2
+name: Elektron Digitakt 2
+# VERIFIED against the Digitakt II manual OS1.16 (manual: below),
+# with page citations at the bottom of this file (checked by tests/test_device_citations.py).
+# The sequencer has 16 tracks (p.17), each an audio or a MIDI track.
+description: >
+  16-track sequencer/sampler: every track is individually assignable as an audio track or
+  a MIDI track. 400 MB project RAM (about 72 min mono / 36 min stereo) and 1016 sample slots
+  per project, separate from the +Drive's 20 GB / 2048-preset library. Elektron Transfer
+  converts all audio files to 16-bit/48 kHz on transfer (which input formats it accepts
+  isn't listed in the manual), so pack folders just need to be well organized. Native
+  format: 16-bit/48 kHz, mono or stereo (p.73; the 24-bit figure in the tech specs is the
+  converters, p.91). Sample slots are assigned to tracks on the Digitakt after transfer;
+  Fourier manages the sample pool, organized by function so it's easy to find per track.
+manual:
+  title: Digitakt II User Manual
+  version: OS1.16 (2026-09-09)
+  url: https://www.elektron.se/wp-content/uploads/2026/09/Digitakt-2-User-Manual_ENG_OS1.16_260909.pdf
+  sha256: 9445909f94bc0f074be4621791f981bf2c268e91465b8d5ed43a46f1a398706d
+load: transfer              # Elektron Transfer: never overwrites a file of the same name (Transfer's manual, pp. 10-11)
+sample_refs: path           # the device follows renames (p.29), but a deleted sample drops out of presets,
+                            # so renders keep paths stable and retired files stay
+
+paths:
+  folder_depth: {value: 2, status: convention, cite: browser-hierarchy}
+    # CATEGORY/family, like the M8 render; the +Drive browser opens directories and steps
+    # back up the hierarchy (p.71). Folding the family into the file name would put a whole
+    # category in one list.
+  files_per_folder: {value: 128, status: convention}   # browsing comfort; no documented device cap
+  max_name_length: {status: unverified}                # check on the hardware
+
+audio:
+  sample_rate: {value: 48000, cite: native-format}
+  bit_depth: {value: 16, cite: native-format}
+  channels: {value: stereo, cite: native-format}
+    # keep each file's channels: mono and stereo both supported (p.73), and stereo keeps
+    # width/panning options on the device. Stereo files whose channels are identical are
+    # rendered mono (same sound, half the RAM).
+  formats: {value: [wav], status: convention}
+  max_slices: {value: 64, status: convention, cite: slice-grid}
+    # the largest count CREATE SLICE GRID's [FUNC] snap offers (2/4/8/16/32/64, p.99); the
+    # manual states no hard maximum
+  dither: {value: true, status: convention}
+
+storage_mb: {value: 20000, cite: drive-size}   # +Drive is 20 GB (p.29); per project: 400 MB / 1016 slots (p.17)
+
+# Checked by tests/test_device_citations.py: each quote must be on its page of the manual
+# named in manual: above. page: is the PDF page (1-based), not the printed page number.
+# Update page/quote, and manual:, when the manual version changes.
+citations:
+  tracks:
+    claim: 16 tracks, each audio or MIDI
+    page: 17
+    quote: "The Digitakt II sequencer has 16 tracks that can be either an audio track or a MIDI track"
+  project-memory:
+    claim: 400 MB of samples per project, 1016 slots
+    page: 17
+    quote: "You can load up to 400 MB (about 72 minutes in mono, 36 minutes in stereo) of samples in a project"
+  project-slots:
+    claim: 1016 sample slots per project
+    page: 17
+    quote: "using a maximum of 1016 sample slots"
+  drive-size:
+    claim: +Drive is 20 GB; 2048 presets
+    page: 29
+    quote: "The total size of the +Drive is 20 GB. The +Drive library can hold up to 2048 presets"
+  native-format:
+    claim: native format 16-bit / 48kHz, mono and stereo
+    page: 73
+    quote: "converts all audio files to 16 bit, 48 kHz audio files, the Digitakt II native audio format. Both mono and stereo files are supported"
+  converters:
+    claim: 24-bit applies to the converters, not sample storage
+    page: 91
+    quote: "48 kHz, 24-bit D/A and A/D converters"
+  slice-grid:
+    claim: slice grid snaps to 2-64 slices
+    page: 99
+    quote: "snaps the slice count to values 2, 4, 8, 16, 32, and 64"
+  tune-range:
+    claim: tune range +/- 5 octaves
+    page: 100
+    quote: "The range is +/- 5 octaves"
+  sampling-time:
+    claim: max sampling time 66 seconds
+    page: 68
+    quote: "The maximum sampling time is 66 seconds"
+  browser-hierarchy:
+    claim: the +Drive browser navigates a directory hierarchy
+    page: 71
+    quote: "back one step up in the directory hierarchy"

fourier/_config/devices/generic_44k.yaml

@@ -0,0 +1,21 @@
+id: generic_44k
+name: Generic 44100 Hz sampler
+status: unverified
+description: >
+  For a device without its own profile: 44100 Hz / 16-bit stereo WAV in CATEGORY/family
+  folders. Nothing here was checked against a manual, so it sets no path-length limit and
+  no storage size; copy the render to the device yourself. An agent can draft a real
+  profile from the device's manual (docs/device-profiles.md).
+load: copy
+sample_refs: path
+
+paths:
+  folder_depth: {value: 2, status: unverified}
+  files_per_folder: {value: 128, status: unverified}
+
+audio:
+  sample_rate: {value: 44100, status: unverified}
+  bit_depth: {value: 16, status: unverified}
+  channels: {value: stereo, status: unverified}
+  formats: {value: [wav], status: unverified}
+  dither: {value: true, status: unverified}

fourier/_config/devices/generic_48k.yaml

@@ -0,0 +1,21 @@
+id: generic_48k
+name: Generic 48000 Hz sampler
+status: unverified
+description: >
+  For a device without its own profile: 48000 Hz / 16-bit stereo WAV in CATEGORY/family
+  folders. Nothing here was checked against a manual, so it sets no path-length limit and
+  no storage size; copy the render to the device yourself. An agent can draft a real
+  profile from the device's manual (docs/device-profiles.md).
+load: copy
+sample_refs: path
+
+paths:
+  folder_depth: {value: 2, status: unverified}
+  files_per_folder: {value: 128, status: unverified}
+
+audio:
+  sample_rate: {value: 48000, status: unverified}
+  bit_depth: {value: 16, status: unverified}
+  channels: {value: stereo, status: unverified}
+  formats: {value: [wav], status: unverified}
+  dither: {value: true, status: unverified}

fourier/_config/devices/generic_folder.yaml

@@ -0,0 +1,21 @@
+id: generic_folder
+name: Generic folder (a DAW or a computer)
+status: unverified
+description: >
+  For a folder on a computer, such as a DAW's sample folder: 44100 Hz / 24-bit WAV that keeps
+  each file's channels, in CATEGORY/family folders, with no folder, name, path or storage
+  limit. It describes no device and cites no manual; copy the render where you want it.
+  For a sampler, start from `fourier devices new` (docs/device-profiles.md).
+load: copy
+sample_refs: path
+
+paths:
+  folder_depth: {value: 2, status: unverified}
+  files_per_folder: {value: null, status: unverified}   # no limit
+
+audio:
+  sample_rate: {value: 44100, status: unverified}
+  bit_depth: {value: 24, status: unverified}
+  channels: {value: stereo, status: unverified}
+  formats: {value: [wav], status: unverified}
+  dither: {value: true, status: unverified}

fourier/_config/devices/generic_sd_card.yaml

@@ -0,0 +1,25 @@
+id: generic_sd_card
+name: Generic SD-card sampler
+status: unverified
+description: >
+  A cautious start for a sampler that reads WAV files from an SD card and has no profile
+  yet: 44100 Hz / 16-bit WAV that keeps each file's channels, under /Fourier on the card
+  (`fourier sync` copies it there), CATEGORY/family folders of at most 128 files, and
+  plain-ASCII names. None of it was checked against a manual and it sets no path, name or
+  storage limit, so check your device's manual, or make a profile of your own with
+  `fourier devices new` (docs/device-profiles.md).
+load: card-sync
+sample_refs: path
+
+paths:
+  card_dir: {value: /Fourier, status: unverified}
+  folder_depth: {value: 2, status: unverified}
+  files_per_folder: {value: 128, status: unverified}
+  ascii_names: {value: true, status: unverified}       # NFC, then plain ASCII
+
+audio:
+  sample_rate: {value: 44100, status: unverified}
+  bit_depth: {value: 16, status: unverified}
+  channels: {value: stereo, status: unverified}
+  formats: {value: [wav], status: unverified}
+  dither: {value: true, status: unverified}

fourier/_config/devices/m8_tracker.yaml

@@ -0,0 +1,118 @@
+id: m8_tracker
+name: Dirtywave M8 Tracker
+description: >
+  Portable tracker with 8 tracks. Samples are organized in user-defined folders on the SD
+  card (Fourier renders go under /Samples/Fourier). The Sampler reads 1- or 2-channel PCM
+  .wav ONLY (not AIFF) at 8/16/24/32-bit.
+  Samples stream from the SD card rather than RAM, so mono and 16-bit reduce card load
+  and raise the pitch ceiling; they don't save memory. The whole sample path must be under
+  128 characters. No per-folder file limit is documented; shallow folders browse best.
+  SAMPLER PLAY modes (manual-verified): FWD, REV, FWDLOOP, REVLOOP, FWD PP, REV PP,
+  OSC, OSC REV, OSC PP, REPITCH/BPM (10 modes).
+manual:
+  title: M8 Operation Manual
+  version: v20260421
+  url: https://cdn.shopify.com/s/files/1/0455/0485/6229/files/m8_operation_manual_v20260421.pdf?v=1776791699
+  sha256: 006360bd2a2819e900d785b8ed4bafdc14030eb74acc4add265fdaca65dbeac7
+load: card-sync             # the M8 in disk mode: fourier sync
+sample_refs: path
+
+paths:
+  card_dir: {value: /Samples/Fourier, status: convention}   # counts toward max_path_length
+  folder_depth: {value: 2, status: convention}              # CATEGORY/family under card_dir
+  files_per_folder: {value: 128, status: convention}
+    # browsing comfort, not a device limit (fewer, fuller folders)
+  max_path_length: {value: 127, cite: path-length}          # "entire path length ... under 128 characters"
+
+audio:
+  sample_rate: {value: 44100, status: convention, cite: render-format}
+    # M8 renders at 44.1 kHz; the manual states no playback rate
+  bit_depth: {value: 16, cite: prefer-16-bit}   # convert 24/32-bit to 16/8-bit where possible
+  channels: {value: stereo, cite: wav-channels}
+    # keep each file's channels, as on the Digitakt 2: the Sampler plays 1- or
+    # 2-channel wav. The master is already mono where stereo isn't needed (KICKS, SUB,
+    # near-mono files; p.11), and identical-channel stereo is rendered mono. Stereo streams
+    # twice the data and lowers the pitch ceiling (p.61).
+  formats: {value: [wav], cite: wav-channels}
+  max_slices: {value: 128, cite: slice-markers}
+  max_duration_s: {value: null, cite: no-length-limit}      # samples stream from SD
+  dither: {value: true, status: convention}
+
+storage_mb: {value: 32000, status: convention}   # a typical SD card, not a device limit
+
+# Checked by tests/test_device_citations.py: each quote must be on its page of the manual
+# named in manual: above. page: is the PDF page (1-based), which is the manual's printed
+# page + 7. Update page/quote, and manual:, when the manual version changes.
+citations:
+  wav-channels:
+    claim: Sampler reads 1- or 2-channel PCM wav only
+    page: 61
+    quote: "Only 1 or 2 channel (stereo) PCM .wav files are supported"
+  bit-depths:
+    claim: accepted bit depths; PCM only
+    page: 74
+    quote: "Sample is 8,16, 24, or 32 bit and is mono or stereo"
+  path-length:
+    claim: whole sample path under 128 characters
+    page: 74
+    quote: "The entire path length of the sample is under 128 characters"
+  streams-from-sd:
+    claim: samples stream from the SD card, not memory
+    page: 11
+    quote: "they are streamed directly from the SD card. They are not read from memory"
+  prefer-mono:
+    claim: prefer mono (e.g. kicks) and 16-bit to reduce card load
+    page: 11
+    quote: "Convert stereo samples to mono where stereo is not necessary"
+  prefer-16-bit:
+    claim: prefer 16-bit or 8-bit over 24/32-bit
+    page: 11
+    quote: "Convert 32-bit or 24-bit samples to 16-bit or 8-bit where possible"
+  pitch-ceiling:
+    claim: pitch ceiling depends on bit depth and mono/stereo
+    page: 61
+    quote: "there is an upper-pitch limitation enforced based on bit-depth and mono/stereo samples"
+  slice-markers:
+    claim: up to 128 slice markers stored in the wav
+    page: 64
+    quote: "Add up to 128 markers that are stored within the wav file"
+  render-format:
+    claim: renders are 16-bit 44.1kHz stereo wav
+    page: 54
+    quote: "16-bit 44.1kHz stereo wav file"
+  tracks:
+    claim: 8 tracks
+    page: 47
+    quote: "sends all 8 tracks and effect individually"
+  browser-sort:
+    claim: the file browser sorts a directory by name only on request
+    page: 16
+    quote: "will sort a directory by name if it is unsorted"
+  no-length-limit:
+    claim: samples stream from SD with no memory or length limit
+    page: 98
+    quote: "No memory/length limitation"
+  slice-mode:
+    claim: SLICE cuts the sample into equal length sections
+    page: 61
+    quote: "the sample into equal length sections and maps each slice"
+  degrade:
+    claim: DEGRADE is sample rate reduction only
+    page: 62
+    quote: "DEGRADE - Sample rate reduction effect"
+  mixer-sends:
+    claim: mixer sends are DRY, MFX, DEL, REV
+    page: 62
+    quote: "MFX - ModFX send effect volume"
+  loop-points:
+    claim: loop points are stored in the wav
+    page: 63
+    quote: "Edits the start and end loop points which are stored"
+  slice-playback:
+    claim: wav slice markers play in 01 FILE slice mode
+    page: 64
+    quote: "The markers can be played back when"
+  card-formats:
+    claim: card formats
+    page: 98
+    quote: "FAT32 / exFAT compatible"

fourier/_config/presets/ambient-cinematic.yaml

@@ -0,0 +1,35 @@
+description: ambient, cinematic and sound design; pads, textures, drones and FX first (long pads welcome), few drum loops
+extends: breaks-acid    # its budgets are what the weights below scale
+# ambient-cinematic: PADS, FX and acoustic instruments get the biggest budgets, pads up to
+# 60 s and FX up to 45 s (DUR_CAP; mind a sampler's RAM), and the drum categories and
+# drum loops are small, with a harmonicity gate that takes percussion over a bed or a
+# reverb tail.
+tempo: 70-120
+size: auto            # fit the devices' storage; a pool's surplus moves to the others
+loudness: gentle
+retune: detect
+stereo: keep
+categories:
+  DRUMLOOPS: 0.2
+  PHRASES: 0.8
+  KICKS: 0.4
+  SNARES: 0.4
+  HATS: 0.4
+  CLAPS: 0.4
+  TOMS: 0.5
+  CYMBALS: 0.7
+  PERC: 0.8
+  SUB: 0.5
+  SYNTH: 0.8
+  STABS: 0.6
+  PADS: 2.0
+  FX: 1.6
+  BLIPS: 0.8
+  VOX: 1.2
+  PIANO: 1.3
+  ACOUSTIC: 1.5
+  WAVES: 0.8
+advanced:
+  DUR_CAP: {KICKS: 4.0, SNARES: 3.0, CLAPS: 3.0, HATS: 4.0, TOMS: 5.0, PERC: 4.0, CYMBALS: 12.0,
+    SUB: 8.0, SYNTH: 10.0, STABS: 4.0, PADS: 60.0, VOX: 30.0, BLIPS: 3.0, FX: 45.0}
+  DRUMLOOP_HAR_MAX: 0.75      # percussion over a bed or a reverb tail reads tonal

fourier/_config/presets/balanced.yaml

@@ -0,0 +1,12 @@
+description: every category, budgets spread evenly, drum loops of every style from 70 to 180 BPM (the default)
+# balanced: the default style, and the code's own defaults, so this preset resolves to no
+# overrides. Every category, budgets spread evenly (drum loops 1,140, then phrases, pads and
+# keys), 5-BPM loop bands from 70 to 180 BPM (hip hop to dnb), drum loops of every style
+# (only folders that hold no drum loops are left out). size auto: budgets fit the smallest
+# device's storage, and what a category's pool can't fill goes to the categories that filled
+# theirs. The other styles scale its budgets with `categories` weights.
+tempo: 70-180
+size: auto            # fit the devices' storage; a pool's surplus moves to the others
+loudness: standard
+retune: detect
+stereo: fold-near-mono

fourier/_config/presets/breaks-acid.yaml

@@ -0,0 +1,16 @@
+description: breaks, jungle, drum and bass and acid first, house after; the biggest budget goes to drum loops (85-180 BPM, half time folded up), then synths and basses
+# breaks-acid: breaks, jungle / dnb and acid first, house after: drum loops get the biggest
+# budget (1,900), then SYNTH and SUB; 5-BPM loop bands from 85 to 180 BPM, half and double
+# time folded into 90-180; loops limited up to 3 dB; tonal one-shots retuned to C. The drum
+# loops leave out trap, dubstep and future bass folders, take loops up to 16 s and hold them
+# to the break prompts' CLAP gate. The other genre styles extend it.
+tempo: 85-180
+loudness: standard
+retune: detect
+stereo: fold-near-mono
+advanced:
+  BUDGETS: {DRUMLOOPS: 1900, PHRASES: 600, KICKS: 825, SNARES: 750, HATS: 750, PERC: 600,
+    SUB: 900, TOMS: 340, CLAPS: 360, CYMBALS: 300, FX: 660, SYNTH: 1000, PADS: 600,
+    STABS: 325, BLIPS: 225, VOX: 375, PIANO: 350, WAVES: 350, ACOUSTIC: 350}
+  POOL_SURPLUS: false
+  DRUMLOOP_STYLE_EXCLUDE: '(?<![a-z])(?:dubstep|brostep|trap|future ?bass|fx ?loops?|impact ?fx|synth ?bass|brass ?stab)(?![a-z])'

fourier/_config/presets/hiphop-lofi.yaml

@@ -0,0 +1,29 @@
+description: hip hop, boom bap and lo-fi; drum loops at 70-100 BPM (8 bars welcome), keys, vocals and textures
+extends: breaks-acid    # its budgets are what the weights below scale
+# hiphop-lofi: drum loops banded 70-100 BPM and folded into that range (a 170 BPM read of a
+# boom-bap loop is filed at 85; a loop that would fold out of it keeps its tempo), loops and
+# phrases up to 28 s (8 bars at 70 BPM), no breaks-only exclusions, and a harmonicity gate that
+# takes lo-fi drum loops (filtered, or under a chord). More phrases, keys,
+# vocals and acoustic instruments; fewer synth blips and single-cycle waves.
+tempo: 70-100
+size: auto            # fit the devices' storage; a pool's surplus moves to the others
+loudness: standard
+retune: detect
+stereo: fold-near-mono
+categories:
+  DRUMLOOPS: 0.9
+  PHRASES: 1.4
+  SUB: 0.8
+  SYNTH: 0.7
+  STABS: 1.1
+  PADS: 1.1
+  PIANO: 1.5
+  ACOUSTIC: 1.3
+  VOX: 1.4
+  BLIPS: 0.6
+  WAVES: 0.5
+advanced:
+  DRUMLOOP_STYLE_EXCLUDE: '(?<![a-z])(?:fx ?loops?|impact ?fx|synth ?bass|brass ?stab)(?![a-z])'
+  DRUMLOOP_DUR_MAX: 28.0
+  DRUMLOOP_HAR_MAX: 0.78      # lo-fi drums (filtered, under a chord) read more tonal
+  PHRASE_DUR: [1.0, 28.0]

fourier/_config/presets/house-techno.yaml

@@ -0,0 +1,26 @@
+description: house and techno; four-on-the-floor drum loops at 118-140 BPM (no breakbeat folding), stabs, chords and basses
+extends: breaks-acid    # its budgets are what the weights below scale
+# house-techno: drum loops banded 118-140 BPM, folded only within that range (a 174 BPM
+# break stays at 174, outside the bands, instead of being halved to 87), and held to
+# four-on-the-floor prompts by the drum loops' CLAP gate. More stabs, basses and vocals.
+tempo: 118-140
+size: auto            # fit the devices' storage; a pool's surplus moves to the others
+loudness: standard
+retune: detect
+stereo: fold-near-mono
+categories:
+  DRUMLOOPS: 1.0
+  PHRASES: 1.1
+  STABS: 1.4
+  SUB: 1.0
+  PADS: 1.0
+  VOX: 1.2
+  PIANO: 0.8
+  ACOUSTIC: 0.6
+  WAVES: 0.8
+advanced:
+  BREAK_PHRASES: [four on the floor house drum loop, house drum loop, techno drum loop,
+    minimal techno beat, deep house groove, tech house drum loop, kick and hi-hat loop,
+    driving techno kick loop, disco drum loop, acid house drum loop, garage drum loop,
+    electro drum loop, swung house groove, industrial techno loop, percussion loop,
+    tribal drum loop]

fourier/_config/presets/trap.yaml

@@ -0,0 +1,30 @@
+description: trap and drill; 808s and hard drums, drum loops at 130-160 BPM (half time at 65-80 folded up), vocals and FX
+extends: breaks-acid    # its budgets are what the weights below scale
+# trap: drum loops banded 130-160 BPM (a 70 BPM half-time read is filed at 140), held to
+# trap prompts by the drum loops' CLAP gate, no trap exclusion, a harmonicity gate that takes
+# drum loops with an 808 under them; more 808s (SUB), hats,
+# claps and vocals, fewer breaks-style phrases and acoustic instruments.
+tempo: 130-160
+size: auto            # fit the devices' storage; a pool's surplus moves to the others
+loudness: hot
+retune: detect
+stereo: fold-near-mono
+categories:
+  SUB: 1.4
+  HATS: 1.2
+  CLAPS: 1.1
+  DRUMLOOPS: 0.8
+  PHRASES: 0.8
+  PADS: 0.8
+  VOX: 1.2
+  TOMS: 0.6
+  CYMBALS: 0.6
+  PIANO: 0.8
+  ACOUSTIC: 0.5
+  WAVES: 0.5
+advanced:
+  DRUMLOOP_STYLE_EXCLUDE: '(?<![a-z])(?:fx ?loops?|impact ?fx|synth ?bass|brass ?stab)(?![a-z])'
+  DRUMLOOP_HAR_MAX: 0.75      # an 808 under the drums reads tonal
+  BREAK_PHRASES: [trap drum loop, trap hi-hat roll loop, 808 trap beat, drill drum loop,
+    half-time hip hop drum loop, rolling hi-hat loop, hard trap drums, phonk drum loop,
+    trap snare roll loop, hip hop drum break, boom bap break, percussion loop]

fourier/_config/providers/path.yaml

@@ -0,0 +1,60 @@
+# The path provider (src/fourier/metadata/shadow.py): canonical labels from folder and file
+# names. Each label lists regexes matched, case-insensitively, against the sample's
+# library-relative path with separators turned into spaces; the file's name and folder
+# speak first, the folders above only when those give no category; class.oneshot and class.loop
+# count only in the file's name and its folder (shadow.shape_labels). With Sononym these
+# labels are only scored against its own; without it they classify (metadata/providers.py).
+# Generic words only: never a vendor, pack or person. Sections below the labels:
+#   weak       words that describe as often as they name ("Noise Clap", "Metal Lead",
+#              "Voice 3" of a synth): their label counts only when no other word gives one
+#   near_only  weak words that count in the file's name and folder, not in the folders
+#              above (where "Synths" or "Synth Drums" is a pack name)
+#   not_words  case-sensitive words dropped before matching: a name that isn't the thing
+#              it spells
+class.loop: ['\bloops?\b', '\b(?:drum)loops?\b', '\bbreaks?\b', '\bbreakbeats?\b', '\d{2,3} ?bpm\b', '\bgrooves?\b', '\bbeats?\b', '\bfills?\b']
+class.oneshot: ['\bone ?-?shots?\b', '\bhits?\b', '\bsingle\b', '\bshots?\b']
+kick: ['\bkicks?\b', '\bkiks?\b', '\bkcks?\b', '\bbd\b', '\bbass ?drums?\b']
+snare: ['\bsnares?\b', '\bsnr\b', '\bsd\b', '\brims?(?:shots?)?\b', '\bside ?sticks?\b']
+clap: ['\bclaps?\b', '\bhand ?claps?\b']
+snap: ['\bsnaps?\b', '\bfinger ?snaps?\b']
+hat: ['\bhi-?hats?\b', '\bhihats?\b', '\bhh\b', '\bhats?\b']
+tom: ['\btoms?\b']
+cymbal.crash: ['\bcrash(?:es)?\b', '\bsplash\b', '\bchina\b', '\bcymbals?\b', '\bcyms?\b']
+cymbal.ride: ['\brides?\b']
+perc.hand: ['\bcongas?\b', '\bbongos?\b', '\bdjembe\b', '\btablas?\b', '\bcuica\b', '\btimbales?\b', '\bshakers?\b', '\btambourines?\b', '\bcabasas?\b', '\bmaracas?\b']   # shaken: percussion (a name rule still files a shaker named alone with the hats, DRUM_NAME_RULES)
+perc.wood: ['\bwood ?blocks?\b', '\bclaves?\b', '\bwood\b', '\blog drum\b']
+perc.metal: ['\bcowbells?\b', '\bagogo\b', '\btriangles?\b', '\banvil\b']
+perc.scrape: ['\bguiros?\b', '\bvibraslap\b', '\bscrape\b']
+scratch: ['\bscratch(?:es)?\b', '\bvinyl scratch\b']
+zap: ['\bzaps?\b']
+bass: ['\bbass\b', '\bsub ?bass\b', '\breese\b']      # not a bare 808: a TR-808 hat is a hat
+lead: ['\bleads?\b', '\barps?\b', '\bplucks?\b']      # "synth": near_only, below
+keys: ['\bpianos?\b', '\be-?pianos?\b', '\brhodes\b', '\borgans?\b', '\bwurli(?:tzer)?\b', '\bclavs?\b', '\bclavinet\b', '\belectric piano\b', '\bharpsichords?\b']   # PIANO's
+blip: ['\bblips?\b', '\bbleeps?\b']
+pad: ['\bpads?\b', '\btextures?\b', '\bdrones?\b', '\batmospheres?\b']
+stab: ['\bstabs?\b', '\borch(?:estra)? hits?\b', '\bchords?\b']
+bell: ['\bbells?\b', '\bchimes?\b']
+vocal: ['\bvox\b', '\bvocals?\b', '\bacapellas?\b', '\bchants?\b']
+fx.smash: ['\bsmash(?:es)?\b', '\bglass\b']
+fx.rustle: ['\brustle\b', '\bcrackles?\b', '\bfoley\b']
+fx.impact: ['\bimpacts?\b', '\bexplosions?\b', '\bbooms?\b', '\bgun ?shots?\b']
+fx.nature: ['\bnature\b', '\brain\b', '\bwind\b', '\bfield ?recordings?\b']
+fx.noise: ['\bstatic\b', '\bhiss\b']
+fx.sweep: ['\bsweeps?\b', '\brisers?\b', '\bup ?lifters?\b', '\bdown ?lifters?\b', '\blasers?\b']
+fx.whoosh: ['\bwhoosh(?:es)?\b', '\bswoosh(?:es)?\b', '\bwhips?\b']
+weak:
+  fx.noise: ['\bnoise\b', '\bdistortion\b', '\bs?fx\b', '\b(?:sound ?)?effects?\b']   # a bare "FX": FX
+  perc.metal: ['\bmetal\b']
+  perc.hand: ['\bpercs?\b', '\bpercussions?\b']    # a bare "Perc": PERC, unless a drum is named too
+  vocal: ['\bvoices?\b']
+  fx.nature: ['\bambien(?:ce|t)\b']
+  bass: ['\b808s\b', '\bsubs?\b']   # a folder of 808s; a bare 808 isn't one ("808/Hat 01")
+  pad: ['\bstrings?\b', '\bviolins?\b', '\bviolas?\b', '\bcellos?\b']   # a named violin or cello is ACOUSTIC's by its name first
+  lead: ['\bbrass\b', '\btrumpets?\b', '\bsax(?:ophone)?s?\b', '\bhorns?\b']   # a named one is ACOUSTIC's by its name first
+  keys: ['\bkeys\b', '\bkeyboards?\b']   # "Synth Keys" says lead too
+near_only:
+  lead: ['\bsynths?\b']        # not saw / square: waveform names bass and lead alike
+  hat: ['\bch\b', '\boh\b']   # closed / open hat abbreviations ("CH_01"), in the file's own name or folder
+  clap: ['\bcp\b']
+  keys: ['\bep\b']           # an electric piano ("EP_C3"), in the file's own name or folder (not a record's EP)
+not_words: ['\bTOM\b']

fourier/_config/providers/sononym.yaml

@@ -0,0 +1,36 @@
+# Sononym's labels in the canonical vocabulary (src/fourier/metadata/vocab.py).
+# The taxonomy (curate_config CATEGORIES) names only canonical labels; this file is the one
+# place Sononym's own category names appear. Every class and category Sononym uses must be
+# listed: an unmapped one fails `fourier tools db-stats --metadata` (parity) and the build.
+classes:
+  OneShot: class.oneshot
+  Loop: class.loop
+categories:
+  Perc Kicks: kick
+  Perc Snares: snare
+  Perc Claps: clap
+  Perc Snips & Snaps: snap
+  Perc Hats & Shakers: hat
+  Perc Toms: tom
+  Perc Cymbal Crashes: cymbal.crash
+  Perc Cymbal Rides: cymbal.ride
+  Perc Bongos & Congas: perc.hand
+  Perc Wood Hits: perc.wood
+  Perc Metal Hits: perc.metal
+  Perc Vibraslap & Guiro: perc.scrape
+  Perc Vinyl Scratches: scratch
+  Perc Zaps & Blips: zap
+  Tone Bass & LowKeys: bass
+  Tone Leads & MidHiKeys: lead
+  Tone Blips & HighKeys: blip
+  Tone Pads & Textures: pad
+  Tone Stabs & Orch. Hits: stab
+  Tone Triangles & Bells: bell
+  Tone Voice & Acapella: vocal
+  XFX Breaks & Smashes: fx.smash
+  XFX Cracks & Rustle: fx.rustle
+  XFX Explosions & Shots: fx.impact
+  XFX Nature & Athmospheric: fx.nature
+  XFX Noise & Distortion: fx.noise
+  XFX Sweeps & Lasers: fx.sweep
+  XFX Whooshes & Whips: fx.whoosh