procedural-sounds README

The project's README from github.com/m1ckc3s/procedural-sounds. As one markdown file: README.md.

Procedural interface sounds, with taste

This project does not have a settled name yet. Naming ideas are welcome, open an issue.

Every sound is synthesized live in the browser from a recipe. There are no audio files anywhere in the product. Pick a category, generate until one fits, hear it in context, export it as a WAV or as a few lines of JavaScript.

Where this is at

Early beta, and very much a work in progress. The core loop works: generate, hear it in context, export. The library is growing, the generators are learning, and a lot of what is here is the first version of itself. Do not read this repo as a finished project. Read it as one you can help build.

I am looking for help, and PRs are welcome. In rough order of how much they would matter:

CONTRIBUTING.md has the specifics, including how curation contributions get merged. docs/TODO.md is the live work list.

Run it

Node 24 (Next 16, React 19, Tailwind 4).

npm install
npm run dev

Open the product at /. At the bottom of the page there is a dev mode link. That is the workbench, and it only exists when you run locally: its routes write curation state to data/pool/*.json on your filesystem, and a production build closes them.

Inside the workbench you can:

Read docs/TRAINING.md before a curation session. It says what each tab's keep and delete actually write.

How it works

The short version: a hand-curated library, a handful of generators that draw from and remix it, and a learning layer that shifts each generator's odds every time a curator keeps or deletes what it made. The library and the training data are the same asset.

On provenance: the synth core began as an adaptation of an open source recipe player, and a several open source sound packs seeded the very first library. Everything that generates, learns and curates is original to this project, as are the instruments, figures and characters the generators draw from, and the library has been growing past its seeds ever since. The specific projects and their licenses are in THIRD-PARTY-NOTICES.md, also rendered at /licenses.

The long version lives in docs/:

License

MIT. See LICENSE.

procedural-sounds (m1ckc3s/procedural-sounds)

Searching Database…

203 ·GitHub
Procedural-sounds
Что это?Procedural Sounds генерирует звуки интерфейса и UI прямо в браузере из кодовых рецептов вместо аудиофайлов, так что вы подбираете звук на слух и затем экспортируете его.
Это библиотека звуков для скачивания или инструмент, который я запускаю сам?Это веб-приложение на Next.js, которое вы запускаете сами: публичная продуктовая страница для генерации и экспорта звуков плюс доступная только в dev-режиме «мастерская» (workbench) для курирования библиотеки, существующая лишь при локальном запуске.
Как его запустить?Запустите локально на Node 24 (Next 16, React 19, Tailwind 4), затем откройте продуктовую страницу на '/'; ссылка в dev-режиме внизу страницы открывает мастерскую курирования.
Что нужно, чтобы реально получить звук?Ничего лишнего: выберите категорию, генерируйте, пока звук не подойдёт, послушайте его в контексте, затем экспортируйте как WAV-файл или несколько строк JavaScript.
Можно просто установить это через npm install в свой проект?Пока нет — единственный способ использовать звук сегодня это экспортировать его из запущенного приложения, а поставка импортируемого npm-пакета названа самым большим недостающим элементом. Весь проект всё ещё в ранней бете.
Как реально работает генерация звука?Тщательно курируемая библиотека питает несколько генераторов, которые её ремикшируют, а обучающий слой сдвигает шансы каждого генератора каждый раз, когда куратор сохраняет или удаляет созданное им в мастерской.
Что можно делать в мастерской?Вкладки вроде Variations, Creations, Invent, Wild, Craft и Prospect генерируют звуки пакетами для сохранения или удаления, а Library, Editor, Calibrate, Atlas, Dedupe и Trash отвечают за сортировку, ручное написание рецептов, калибровку безопасности для слуха и очистку.
Откуда взялся синтезаторный движок?Ядро синтезатора началось как адаптация опенсорсного плеера рецептов, а несколько опенсорсных звуковых пакетов дали самый первый вариант библиотеки; всё сгенерированное, выученное и откурированное с тех пор — оригинальное для этого проекта.
У проекта вообще есть устоявшееся имя?Нет — в README сказано, что устоявшегося имени пока нет, и приглашают предлагать варианты названия через issue.
What are similar projects?tweakcn, orb, procedural-film, openreel-video, onlook, ScrollMagic, shapeshift, CHOMPI
Which topics is it in?synthesizer, web-audio, ux, procedural-generation, design-tools, creative-coding, tailwindcss, audio, nextjs, browser, ui, web-app
Creator
m1ckc3s
Size
1.2 MB
Stars
203
Updated
CommitAug 18
Age
2mo
Commits · 90 Days