add-sfx

Ajouter un nouvel effet sonore à @remotion/sfx

npx skills add https://github.com/remotion-dev/remotion --skill add-sfx

Prerequisites

Sound effects must first be added to the remotion.media package.
Then it can be deployed using bun run build. The .env may be missing if we are in a worktree, but on the main non-worktree branch it should be present.

The source of truth is generate.ts in that repo. A sound effect must exist there before it can be added to @remotion/sfx.

Sound effects must be:

  • WAV format
  • CC0 (Creative Commons 0) licensed
  • Normalized to peak at -3dB

Steps

1. Add to remotion.media repo (must be done first)

In the remotion-dev/remotion.media repo:

  1. Add the WAV file to the root of the repo
  2. Add an entry to the soundEffects array in generate.ts:
    {
      fileName: "my-sound.wav",
      attribution:
        "Description by Author -- https://source-url -- License: Creative Commons 0",
    },
    
  3. Run bun generate.ts to copy it to files/ and regenerate variants.json
  4. Deploy

2. Add the export to packages/sfx/src/index.ts

Use camelCase for the variable name. Avoid JavaScript reserved words (e.g. use uiSwitch not switch).

export const mySound = 'https://remotion.media/my-sound.wav';

3. Create a doc page at packages/docs/docs/sfx/<name>.mdx

Follow the pattern of existing pages (e.g. whip.mdx). Include:

  • Frontmatter with image, title (camelCase export name), crumb: '@remotion/sfx'
  • <AvailableFrom> tag with the next release version
  • <PlayButton> import and usage
  • Description
  • Example code using @remotion/media's <Audio> component
  • Value section with the URL in a fenced code block
  • Duration section (fetch the file and use afinfo on macOS to get duration/format)
  • Attribution section with source link and license
  • Convert section with a full-link sentence: [Open this file on remotion.dev/convert](https://remotion.dev/convert?url=<encoded-sfx-url>)
  • See also section linking to related sound effects

4. Register in sidebar and table of contents

  • packages/docs/sidebars.ts — add 'sfx/<name>' to the @remotion/sfx category items
  • packages/docs/docs/sfx/table-of-contents.tsx — add a <TOCItem> with a <PlayButton size={32}>

5. Regenerate SFX waveforms

After the sound is added to packages/remotion-media and exported from packages/sfx/src/index.ts, regenerate the waveform samples used by the docs:

bun packages/docs/generate-sfx-waveforms.ts

This uses ffmpeg to sample every exported sound effect into around 2000 waveform samples and updates packages/docs/components/sfx-demos/sfx-waveforms.ts.

6. Update the skills rule file

Add the new URL to the list in packages/skills/skills/remotion-markup/sfx.md.

7. Build

cd packages/sfx && bun run make

Naming conventions

File nameExport name
my-sound.wavmySound
switch.wavuiSwitch (reserved word)
page-turn.wavpageTurn

Version

Use the current version from packages/core/src/version.ts. For docs <AvailableFrom>, increment the patch version by 1.

Plus de skills de remotion-dev

3d
remotion-dev
Contenu 3D dans Remotion en utilisant Three.js et React Three Fiber.
accept-element
remotion-dev
Accepter une contribution externe d’élément Remotion en vérifiant ses aperçus commités, en les téléversant vers R2, en supprimant les actifs temporaires, et en préparant le…
add-bug
remotion-dev
Ajouter une nouvelle entrée de bug Remotion dans packages/bugs/api/[v].ts. Utiliser lorsque l'utilisateur décrit un bug et les versions de Remotion concernées qui doivent être remontées via le…
add-cli-option
remotion-dev
Ajouter une nouvelle option CLI ou de configuration Remotion en créant un AnyRemotionOption, en enregistrant l'analyse CLI, en connectant les paramètres de configuration et en mettant à jour la documentation. Utiliser lorsque…
add-effect
remotion-dev
Ajouter un nouvel effet à @remotion/effects, incluant l'implémentation, les exports du package, la documentation, les démos, les images d'aperçu, les mises à jour de la compétence Remotion, les tests, le formatage, et…
add-expert
remotion-dev
Ajouter un nouvel expert à la page des experts Remotion
add-new-package
remotion-dev
Ajouter un nouveau package au monorepo Remotion, incluant le scaffolding du package, l'enregistrement dans le monorepo, la documentation, les scripts de build, les tests et la checklist de publication…
add-webcodecs-bug
remotion-dev
Ajouter un bug WebCodecs de navigateur à la page de documentation des bugs WebCodecs de Remotion Mediabunny. Utiliser lorsqu'une URL de problème Chromium, WebKit ou Firefox doit être suivie…