Sound

Audio loudness normalization

Bring sound to a standard loudness, riding the level as it goes. -16 suits online video and podcasts, -23 is broadcast.

Shown on A narration recorded 17 dB too quietly

Before · the same request without it
After · Bring a voice recorded far too quietly up to a streaming loudness.
Transcript

High above the city, on a tall column, stood the statue of the Happy Prince. He was gilded all over with thin leaves of fine gold.

The entry

Add it to a clip's effects list. Entries run in the order you write them.

{
  "type": "loudness"
}

Every setting and default is in the docs

Run it

The whole request behind the render above. Paste it as it is, or swap the file for your own.

job.ts
import { createClient, outputUrl } from "@rendobar/sdk";


const rb = createClient({ apiKey: process.env.RENDOBAR_API_KEY });


const job = await rb.jobs.run({
  type: "compose",
  params: {
    schemaVersion: 1,
    output: {
      format: "mp3"
    },
    timeline: {
      tracks: [
        {
          clips: [
            {
              asset: {
                type: "audio",
                src: "https://cdn.rendobar.com/compose/showcase/media/narration-quiet.wav"
              },
              start: 0,
              effects: [
                {
                  type: "loudness"
                }
              ]
            }
          ]
        }
      ]
    }
  },
});


console.log(outputUrl(job));

Install with npm i @rendobar/sdk. jobs.run() submits and waits, so it returns the finished job in one call.

terminal
curl https://api.rendobar.com/jobs \
  -H "Authorization: Bearer $RENDOBAR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"compose","params":{"schemaVersion":1,"output":{"format":"mp3"},"timeline":{"tracks":[{"clips":[{"asset":{"type":"audio","src":"https://cdn.rendobar.com/compose/showcase/media/narration-quiet.wav"},"start":0,"effects":[{"type":"loudness"}]}]}]}}}'

Returns immediately with a job id. Poll GET /jobs/{id} or register a webhook rather than blocking on the request.

Questions

What does the loudness effect do in compose?

Bring sound to a standard loudness, riding the level as it goes. -16 suits online video and podcasts, -23 is broadcast. Bring a voice recorded far too quietly up to a streaming loudness.

How do I add loudness to a video with an API?

Send a compose job to the Rendobar API with this entry in the timeline: {"type":"loudness"}. Add it to a clip's effects list. Entries run in the order you write them. The request on this page is complete and renders as shown.

What are the default settings for loudness?

Every setting has a default, so the type on its own is enough: target -16. Set only the ones you want to change.

Footage and sound

More features

Visualizer The audiogram: the narration drawn as a moving line over the picture. On the timeline it draws the final mix. EQ More low end and more sparkle on a music bed. Compressor Even out a voice so quiet words and loud words sit at one level. Limiter Make music louder without letting the peaks clip. Noise gate Close the microphone when nobody is speaking, so the river drops away before and after the voice. High pass Cut the rumble under a voice. Wind, traffic and water live there.

See all 117 features →