| 1 | # Sound Effect Library |
| 2 | |
| 3 | This directory is PPT Master's global sound-effect library. It contains 186 |
| 4 | CC0 sound effects prepared as PowerPoint-compatible WAV files: |
| 5 | |
| 6 | | Namespace | Source | Files | Primary use | |
| 7 | |---|---|---:|---| |
| 8 | | `kenney-interface` | Kenney Interface Sounds | 100 | Interface and object-animation cues | |
| 9 | | `kenney-ui` | Kenney UI Audio | 51 | Click, rollover, and state-change cues | |
| 10 | | `bigsoundbank` | BigSoundBank selection | 35 | Whoosh, notification, chime, and pencil cues | |
| 11 | |
| 12 | Source snapshots, license declarations, and modifications are recorded in |
| 13 | [THIRD_PARTY_NOTICES.md](./THIRD_PARTY_NOTICES.md). Machine-readable metadata |
| 14 | for every sound lives in [sounds_index.json](./sounds_index.json). The complete |
| 15 | planning-side identity map is [sound-vocabulary.md](./sound-vocabulary.md). |
| 16 | |
| 17 | ## Project-local selection |
| 18 | |
| 19 | The files here are a discovery library, not project inputs. Project creation |
| 20 | does not create a `sounds/` directory or copy the library. Copy only the sounds |
| 21 | explicitly selected for a deck: |
| 22 | |
| 23 | ```bash |
| 24 | python3 skills/ppt-master/scripts/sound_sync.py projects/deck bigsoundbank/1797 kenney-interface/click_001 |
| 25 | ``` |
| 26 | |
| 27 | The command copies only those files to: |
| 28 | |
| 29 | ```text |
| 30 | projects/deck/sounds/bigsoundbank/1797.wav |
| 31 | projects/deck/sounds/kenney-interface/click_001.wav |
| 32 | ``` |
| 33 | |
| 34 | Animation and transition configuration must reference these project-relative |
| 35 | paths. Do not reference this global directory from a project. Unknown IDs are |
| 36 | reported and cause a non-zero exit before any file is copied. The same batch |
| 37 | preflight rejects a destination that escapes the resolved project root through |
| 38 | a symlink, as well as an existing project file whose content differs from the |
| 39 | selected library ID; the tool never silently overwrites that conflict. |
| 40 | |
| 41 | ## Vocabulary and optional filtering |
| 42 | |
| 43 | After a resolved motion row has a concrete auditory job, read |
| 44 | [sound-vocabulary.md](./sound-vocabulary.md) completely. It groups all 186 |
| 45 | canonical ids by objective cue context and includes each label, duration, and |
| 46 | registered context without a recommendation ranking. |
| 47 | |
| 48 | Use the CLI only to locate an already-considered id, label, tag, or context: |
| 49 | |
| 50 | ```bash |
| 51 | python3 skills/ppt-master/scripts/sound_sync.py list --query transition |
| 52 | ``` |
| 53 | |
| 54 | The filter is optional and never replaces complete vocabulary review or current |
| 55 | motion judgment. Sound remains opt-in, and silence is valid. |
| 56 | |
| 57 | ## Format boundary |
| 58 | |
| 59 | All bundled files are PCM signed 16-bit little-endian, 44.1 kHz WAV. Original |
| 60 | mono or stereo channel layout is preserved. The files were not trimmed and |
| 61 | received no loudness processing. This normalization keeps one predictable |
| 62 | package format while preserving each source recording's complete duration and |
| 63 | channel presentation. |
| 64 |