Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sonilo for Codex

Generate commercially licensed music, sound effects, and newly mixed videos from text or video, directly in Codex — powered by Sonilo's hosted generation service.

Status: publication development. The plugin is installable locally, but it is not yet listed in the public Plugins Directory.

Requirements

  • A Sonilo Platform account at platform.sonilo.com — this is the developer/API account you sign in with during authorization. It is separate from a consumer sonilo.com account; if you only have the latter, create a Platform account first.
  • Codex with plugin support.

No API key is configured in this plugin. Access is per-user via OAuth — you sign in with your Sonilo Platform account, no key to copy or paste.

Install

Clone this repository, add it as a Codex plugin marketplace, then install sonilo.

git clone https://github.com/sonilo-ai/sonilo-codex-plugin.git
codex plugin marketplace add ./sonilo-codex-plugin
codex plugin add sonilo@sonilo

Authorize

The first time Codex calls a Sonilo tool, it opens your browser to sign in to your Sonilo Platform account and approve access (authorize → consent → callback). Codex stores the resulting token locally per user; the plugin itself ships no key, secret, or token. Run codex mcp login sonilo anytime to review or refresh the connection.

Capabilities

  • Create music from a text prompt
  • Match music to the pacing and edits of a public HTTPS video URL
  • Generate sound effects from text or a public HTTPS video URL
  • Return a new video with generated music while optionally preserving speech
  • Return a new video with generated sound effects mixed in
  • Duck music under voice audio
  • Inspect Sonilo Platform account services and usage

See the Sonilo MCP server for tool details and limits.

Example prompts

  • "Create 30 seconds of upbeat lo-fi music for a product demo."
  • "Create a cinematic 3-second whoosh sound effect."
  • "Add cinematic music to this public HTTPS video and return a new video while preserving speech: <url>"

Billing

Generation tools (text_to_music, text_to_sfx, video_to_music, video_to_sfx, video_to_video_music, video_to_video_sfx, audio_ducking) are paid and run against your Sonilo Platform account. Account and usage tools (get_account_services, get_usage, get_generation_task) are read-only and never incur a charge. Paid tools run only after you explicitly ask for them.

What this plugin connects to

This plugin adds a single remote MCP server and connects only to Sonilo's hosted endpoint:

  • Endpoint: https://api.sonilo.com/mcp (HTTPS, Streamable HTTP MCP)
  • Authorization server: Sonilo's Clerk instance (OAuth 2.1 + PKCE; the plugin registers dynamically — no pre-shared client secret)
  • Data sent: your prompts and any media URLs you provide to a tool
  • Data stored: the OAuth token, kept locally per user by Codex

No local command or binary is executed by this plugin.

Support

Release verification

Run the structural checks locally:

python3 scripts/check_release.py

Include production endpoint, OAuth metadata, and public-link checks:

python3 scripts/check_release.py --live

License

MIT — see LICENSE.

About

Codex plugin for Sonilo music and sound effects

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages