vossodocs
Open studio
  • Overview
  • With your agent
  • What is vosso
  • Make your first video
  • Keyboard shortcuts

Studio

    • Install the recorder
    • Record a tab
    • Record a window or the screen
    • Webcam and microphone
    • Tab and system audio
    • Take a screenshot
    • Record without the extension
    • Bring a video file
    • Record with the CLI
    • Record a desktop app
    • Zooms
    • Adjust a zoom
    • Add and delete zooms
    • Camera styles
    • Follow the cursor
    • Tilt
    • Cursor and clicks
    • Trim and split
    • Speed
    • Freeze
    • Range chips
    • Add footage and transitions
    • Text
    • Media
    • Reuse a file
    • HTML layers
    • Live layers
    • Soundtrack
    • Voice and levels
    • Backdrop
    • Card and frame
    • Webcam
    • History
    • Save and autosave
    • Projects and recipes
    • Files
    • Export a video
    • The program itself
    • Publish
    • The watch page
    • Embed a vos
    • Remix and duplicate
    • Every release

Agents and code

    • The agent contract
    • Install the skills
    • What your agent does on your machine
    • Bring a Remotion or HyperFrames video
    • Push and pull
    • Versions and conflicts
    • Folders and recipes
    • Credentials
  • Start

    • Install and log in
    • The take directory

    Reference

    • Verbs
    • actions.json
    • doc.json
    • HTML layers
  • Programs

    • Overview and auth
    • Config format
    • Voses and versions

    Catalogs

    • Fonts
    • Music and SFX
    • 3D typefaces
    • Backdrops
    • Limits
Back to vos.so

API › Catalogs

Music and SFX

The CC0 audio catalog: loudness-normalized tracks and built-in SFX with their hosted URLs.

previous← Fontsnext3D typefaces →

The hosted audio catalog: CC0 music tracks, loudness-normalized to −16 LUFS, plus a small set of built-in SFX. Everything is self-hosted on assets.vos.so, so a document that names these URLs renders the same everywhere. The table below is read from GET vos.so/api/music, the same answer the Sound panel and the CLI read, so it is the library as it stands.

Using a track

Reference the absolute URL as an audio clip's key in doc.audio:

JSON
"audio": [{ "id": "a1",
            "key": "https://assets.vos.so/music/fresh-focus.mp3",
            "start": 0, "gain": 0.5, "duck": true,
            "loop": true, "loopLen": 24 }]

A music bed starts at 0, sits around gain 0.5, ducks under a voiced recording, and loops to fill the cut when the track is shorter. Audio is mixed and muxed on full renders only.

Pick the bed for the film, not for a word: vos music pick <take> ranks every track against the cut's length, its beats and its voice, and prints the vos score line that places each pick; vos score <take> --track best places the first one on the film's payoff. The studio's Sound page shows the same three picks under For this cut.

Music

Every track is CC0, so there is nothing to credit and nothing to clear. The receipts are at vos.so/api/music/LICENSES.txt.

Tracks come in genres. A track's mood is its genre's handle, which vos plan --music <slug|mood> takes; each genre in genres carries its label and the line that says what it is for. Each track also carries its loudness, envelope, swells and a 48-bar bars picture.

Since version: 2 every track also says what it is. Measured from the mastered file: bpm and the beat grid beat {first, period, error} in seconds (a grid, never a rounded number: a 2.5% error drifts a cut three quarters of a second over a 30 s film), beatConfidence (high, low, or confirmed once a person listened with a click track; score cuts on a low beat with care), intro (seconds until it reaches half its loud level), seam (0..1, how alike its end and its start are), ending (fade, hard or ring), sections [{at, level}] and busyness (0..1). Written by a person who listened: vocals (none, chops or lead), tags from a closed vocabulary, one description sentence, and loops. The beat list rides GET vos.so/api/music/<slug>.json as beats. A track measured before these fields carries null in them. energy is deprecated and goes with the next CLI release; read busyness.

trackgenre (mood)lengthbeatvocalsurl

Built-in SFX

Short synthesized sounds for punctuating clicks and reveals.

soundlengthurl
Click0.07shttps://assets.vos.so/audio-sfx/sfx-click.wav
Pop0.12shttps://assets.vos.so/audio-sfx/sfx-pop.wav
Whoosh0.6shttps://assets.vos.so/audio-sfx/sfx-whoosh.wav
Chime1.4shttps://assets.vos.so/audio-sfx/sfx-chime.wav

Related

  • doc.json for the full audio clip shape.