Skip to content

Soundbox v0.3.0-beta.2 (custom endpoints preview)

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 24 Oct 22:34
v0.3.0-beta.2
dc94782

A test build of custom audio endpoints (#22, PR #24), not a stable release. It replaces v0.3.0-beta.1.

What to try

Settings → Endpoints → Add endpoint sends sound effects, music or speech to a server you already run, instead of downloading the model:

  • Pick a preset (LocalAI ACE-Step music, LocalAI sound effects, OpenAI-compatible /v1/audio/speech) or start blank.
  • Set the URL, an optional Bearer key, and the JSON body template. Variables: {{prompt}}, {{lyrics}}, {{instrumental}}, {{duration}}, {{bpm}}, {{key}}, {{seed}}, {{text}}, {{voice}}, {{voice_ref_b64}} and more.
  • Press Test. It renders one short clip and reports what came back.
  • Save it. The endpoint appears in the model picker for its task.

WAV and PCM responses are read directly. MP3, FLAC and other formats need ffmpeg on the machine running Soundbox. Full guide: docs/ENDPOINTS.md.

Also in this build

  • Reverse proxies and other machines (#26). The server now accepts the names in SOUNDBOX_ALLOWED_HOSTS as the Host header, so it works behind Caddy or nginx. In dev mode, SOUNDBOX_DEV_HOST lets the UI listen beyond localhost. docs/INSTALL.md has the setup.
  • Desktop updates (#25). The app checks for a newer release on launch and offers to install it. Pre-releases are never offered, so this build moves to v0.3.0 once that's released.

Notes

  • Inside the app and in the installer file names, this build calls itself 0.2.0. Windows installers can't carry a -beta suffix, so only the tag and this page say beta.
  • Linux / Docker: there is no Linux installer. Build the image from the branch instead:
    git clone -b feat/22-custom-endpoints https://github.com/HamSanders/soundbox && cd soundbox && docker compose up -d --build
    The image already includes ffmpeg. To reach it through a proxy, set SOUNDBOX_ALLOWED_HOSTS in docker-compose.yml to the name the proxy uses.
  • Installers are not yet signed. Windows shows a SmartScreen prompt (More info → Run anyway); macOS asks you to allow the app in System Settings → Privacy & Security. docs/DESKTOP.md has the details.

Please report problems on #22.

Assets 7
Loading