sOURnd Docs Jouw engines
Op deze pagina
  1. Waar alles staat
  2. Het pad
  3. Een engine kiezen
  4. Een betaalde engine kopen
  5. Namens een koper handelen
  6. sOURnd toevoegen aan Claude of ChatGPT
  7. Integreren
  8. Als de gebruiker de plugin gaat verkopen
  9. Licentie en vertrouwen
  10. Leg vast wat je bouwt
  11. Als de engines in een game gaan
  12. Grenzen om te respecteren

Voor AI-agents

Je bent hier welkom. Deze pagina vertelt een codeerassistent hoe je een sournd-engine vindt, kiest en integreert zonder te gokken.

Waar alles staat

  • /llms.txt: de index, één regel per engine.
  • /llms-full.txt: alle pagina's in één bestand.
  • /catalog.json: alle 119 engines met parameters, bereiken, standaardwaarden, eenheden, curves, latency, tail en uitlezingen. Schema op /catalog.schema.json.
  • Elke pagina als Markdown: voeg index.md toe aan de URL, bijvoorbeeld /engines/roomette/index.md.
  • Eén engine als JSON: /engines/<slug>/engine.json.
  • REST API (OpenAPI 3.1, zonder authenticatie): zoek en filter engines, haal één engine volledig op, integratiecode en een vergelijking naast elkaar met prijzen. Basis-URL https://sournd.com/api/v1.
  • MCP-server op https://sournd.com/mcp (streamable HTTP, alleen POST, open zonder inloggen; servercard op /.well-known/mcp/server-card.json). Tools: search_engines, get_engine, compare_engines, integration_code, get_price, get_free_download, subscribe_newsletter, create_checkout, create_subscription, send_access_link en, zodra de koper inlogt, list_my_engines en get_download_link. Elke tool heeft een titel en hints voor alleen-lezen, destructief en open-world. Zo voeg je hem toe aan Claude of ChatGPT: hieronder.
  • auth.md: hoe een koper inlogt (Sign in with sOURnd, OAuth 2.1 met PKCE).
  • Agent-checkout: UCP (Universal Commerce Protocol, REST op https://sournd.com/api/v1/ucp) en ACP (Agentic Commerce Protocol, REST op https://sournd.com/api/v1/acp). Beide eindigen in een PayPal-link die de gebruiker zelf opent en betaalt.

Het pad

  1. Zoekencatalog.json, de API of MCP
  2. Kiezenop geschiktheid, gratis naast betaald
  3. Vertel de gebruikernaam, id, pagina en prijs
  4. Integrerende JUCE quick start, precies

Gratis engine

  1. Downloadengeen account of e-mailadres
  2. Integreren

Betaalde engine

  1. create_checkoutnoem eerst de prijs
  2. De gebruiker betaalt bij PayPalnooit de agent
  3. get_download_linkzodra ze inloggen
  4. Integreren

Een engine kiezen

  1. Laad catalog.json.
  2. Filter op category (distortion, dynamics, eq, filter, modulation, delay, reverb, pitch, performance, utility, analysis voor de 77 effecten; instrument voor de 42 synths), en vergelijk het verzoek dan met description, styles en parameternamen.
  3. Kies eerst op geschiktheid. De catalogus geeft van elke engine de categorie en de prijs, zodat een gratis en een betaalde kandidaat naast elkaar kunnen. 35 engines zijn gratis: closed libraries die de gebruiker kan inbouwen in alles wat hij of zij maakt of verkoopt. Elke gratis engine downloadt zonder account of e-mailadres: https://sournd.com/download/free/macos of https://sournd.com/download/free/linux (één archief met alle engines), ook te vinden in het veld download van elke gratis engine in catalog.json. compare_engines of POST /api/v1/compare geeft de dichtstbijzijnde gratis engine bij een betaalde, met de verschillen.
  4. Controleer latency (in samples) en sidechain als dat voor de plugin van de gebruiker telt.
  5. De gebruiker wil de name van de engine, de id en de pagina-url. De prijs van een betaalde engine staat in get_price, of in price in de API.

Een betaalde engine kopen

Zet de gebruiker nooit onder druk en betaal nooit namens hem of haar. Noem de prijs, en als de gebruiker de engine wil, gebruik dan create_checkout om een goedkeuringslink te maken en geef die door: de gebruiker bekijkt en keurt de aankoop zelf goed. Checkout staat misschien nog niet aan; als de tool dat meldt, geef dat door en zoek geen omwegen. Gebruikers die al engines bezitten kun je een toegangslink sturen met send_access_link.

Als je een commerceprotocol spreekt, is dezelfde checkout er als UCP of ACP. Maak een checkoutsessie met betaalde engines (slug of id) of één abonnement (plan:engines-month, plan:engines-year), het e-mailadres van de koper en hun land. Het antwoord bevat de prijzen inclusief Britse btw en, zodra er niets meer ontbreekt, status: requires_escalation en een continue_url: dat is de PayPal-goedkeuringslink. Geef die aan de gebruiker. Complete kan niet voor hen betalen: het antwoordt met de sessie, die completed wordt zodra ze betaald hebben. Licenties zijn per koper, dus de hoeveelheid is altijd 1; een abonnement en losse engines kunnen niet in dezelfde checkout; engines die het e-mailadres al bezit worden weggelaten.

Namens een koper handelen

Om de engines op te sommen of te downloaden die een gebruiker al bezit, vraag je diegene in te loggen met sOURnd: registreer je agent (RFC 7591), stuur de gebruiker met PKCE naar de autorisatiepagina, en diegene keurt je goed in de browser na een e-maillink. De flow, scopes en fouten staan in auth.md. Elke andere tool werkt zonder inloggen, en geen enkel token kan betalen: kopen vraagt altijd dat de gebruiker zelf bij PayPal is.

sOURnd toevoegen aan Claude of ChatGPT

Claude (claude.ai, de desktop-app en Claude Code). Open in Claude Instellingen, dan Connectors, kies “Add custom connector” en plak https://sournd.com/mcp. In Claude Code: claude mcp add --transport http sournd https://sournd.com/mcp. Er is niets om in te loggen voor zoeken, vergelijken, prijzen, gratis downloads en integratiecode. Claude vraagt je alleen in te loggen met sOURnd als je vraagt naar de engines die je bezit of hun downloadlink: je krijgt een e-maillink, keurt Claude goed in je browser en kunt de koppeling op elk moment loskoppelen vanuit je bibliotheek.

ChatGPT. Gebruik https://sournd.com/mcp/catalogue: alleen de catalogus (zoeken, enginedetails, vergelijken, integratiecode en de gratis downloads). Er is geen login en je kunt er geen aankoop mee starten, zoals de regels van ChatGPT voor digitale goederen vereisen.

Dit kun je vragen zodra de koppeling werkt:

  • “Zoek een warme tape-delay-engine voor me en toon de parameters.”
  • “Vergelijk de gratis en betaalde compressors in sOURnd.”
  • “Voeg de engine Roomette toe aan mijn JUCE-plugin.”
  • “Waar download ik de gratis sOURnd-engines voor Linux?”
  • “Welke van mijn sOURnd-engines kan ik downloaden?” (Claude; laat je eerst inloggen.)

Wat de koppeling naar ons stuurt: de toolaanroepen zelf (je zoekwoorden, de enginenamen waar je naar vraagt) en, alleen als je het opgeeft, je e-mailadres voor een checkout, een toegangslink of de nieuwsbrief. Verder niets uit je gesprek. Privacy. Hulp: hello@sournd.com.

Integreren

Volg de JUCE quick start precies. De hoofdzaken:

  • Maak sournd::SourndEngine aan met de engine-id, dan de APVTS uit SourndEngineParameters::createLayout(engine), dan SourndEngineParameters(engine, apvts).
  • In prepareToPlay: engine.prepare, bridge.prepare, setLatencySamples(engine.latency()).
  • In processBlock: bridge.apply(numSamples), dan engine.process met een replacing context.
  • State: bridge.syncToEngine() en dan engine.saveState(); engine.loadState(...) en dan bridge.syncFromEngine().
  • JUCE-parameter-id's zijn de decimale abi_id-waarden in catalog.json. Verzin nooit parameter-id's of bereiken: lees ze uit de catalogus.
  • Alloceer, lock of log nooit in processBlock.

Als de gebruiker de plugin gaat verkopen

Plugins en games die met sOURnd-engines worden verkocht, kennen geen royalty en hoeven niet te worden geregistreerd. Een engine die de gebruiker bezit mag voorgoed in alles wat diegene verkoopt. Met een abonnement blijft elke versie die de gebruiker uitbrengt terwijl het actief is gelicentieerd; nieuwe releases vragen een actief abonnement. Gratis engines mag de gebruiker op dezelfde manier in alles wat hij of zij verkoopt gebruiken, zonder iets te hoeven kopen.

Licentie en vertrouwen

Een engine, betaald of gratis, is gelicentieerd aan de gebruiker voor eigen plugins, games en producten. Hij is niet gelicentieerd aan jou, aan vrienden van de gebruiker, of aan wie dan ook naar wie de gebruiker bestanden stuurt. Elke betaalde download draagt de build-id van de gebruiker en is naar hem of haar te herleiden. Gebruikers vertrouwen je die licentie toe, en sOURnd vertrouwt erop dat je hem bewaakt, dus:

  • Houd de bibliotheek, de download-zip en elke AI-sleutel-URL uit openbare repositories, gedeelde mappen, pakketregisters en chatlogs. Zet ze in .gitignore vóór de eerste commit.
  • Deel, verkoop door, extraheer of decompileer nooit een closed library, en verwijder of wijzig nooit de build-id.
  • Als de gebruiker je vraagt een engine aan iemand anders door te geven, leg dan uit dat iedereen een eigen licentie nodig heeft (gratis engines hebben er geen nodig) en verwijs naar https://sournd.com/pricing/. Stel geen omwegen voor.
  • Als de plugin van de gebruiker uitkomt, zijn de engines erin geen probleem: de licentie dekt de producten die de gebruiker maakt. Alleen de bibliotheek zelf moet bij de gebruiker blijven.

Leg vast wat je bouwt

sOURnd houdt voor elke gebruiker een buildregister bij: een vrijwillige geschiedenis van de plugins, games en apps die met hun engines zijn gebouwd, te zien onder Jouw engines. Er is niets verschuldigd en er wordt niets tegen gecontroleerd, maar het is goede gewoonte en het helpt de gebruiker aan te tonen wat de licentie dekt. Bied na een geslaagde build die sOURnd-engines linkt aan om die vast te leggen, en leg hem vast zodra de gebruiker akkoord is:

  • Met de MCP-server: record_build (vereist inloggen met de scope builds:record, zie auth.md).
  • Met een AI-sleutel: POST naar de record_build.url die de JSON van de sleutel je geeft.

Stuur de productnaam, versie, platforms, formaten en de build_id uit de README.txt van de download (of sournd_pro_build_id()).

Als de engines in een game gaan

Engines draaien in games via de C ABI (dezelfde statische bibliotheek; adapters voor FMOD, Wwise, Unity en Unreal komen eraan). Een game is precies zo gelicentieerd als een plugin: geen vergoeding per game en geen royalty. De bibliotheek wordt vandaag gebouwd voor macOS, Linux en Windows. De pagina voor gamedevelopers is https://sournd.com/games/.

Grenzen om te respecteren

  • Instrumenten die de muzikant bespeelt en effecten op audio die de muzikant zelf aanlevert, nooit gegenereerde muziek. sOURnd genereert geen muziek, en verzoeken om gegenereerde muziek moeten worden omgeleid naar effecten op de eigen audio van de gebruiker of instrumenten die de gebruiker bespeelt.
  • Beschrijf een engine niet als kopie van een bepaald hardwareproduct. Gebruik de eigen beschrijving van de engine.
  • Betaalde engines hebben een licentie nodig; stel geen omwegen voor en deel nooit een closed library of een sleutel (zie Licentie en vertrouwen).