SW Agent reference

• open_workspace

  Open a workspace: Opens one of the creation workspaces: as a tab beside this one inside Classic or Studio, or its own page.

  a script may call it; gives workspace.

  • workspace: an id (small letters, digits and dashes)
  • go: true or false
  • words: text, 1 to 400 characters

  Ask: “open the thumbnail maker”, “go to background motion”, “take me to the stem splitter”.

• build_project

  Build a project: Builds a Classic or Studio project with the look, frame shape, title, artist, country, animal or creature of myth already set (and a VJ deck's layers, master effect, clip length, strobe and band, or a colour that follows the music, when asked), and opens it.

  a script may call it; gives project.

  • engine: an id (small letters, digits and dashes)
  • mode: an id (small letters, digits and dashes)
  • aspect: one of 16:9, 9:16, 1:1, 4:5, 4:3 or 21:9
  • title: text, 1 to 90 characters
  • artist: text, 1 to 90 characters
  • country: an id (small letters, digits and dashes)
  • animal: an id (small letters, digits and dashes)
  • creature: an id (small letters, digits and dashes)
  • occasion: an id (small letters, digits and dashes)
  • surface: one of classic or studio
  • songUrl: text in its own form, up to 300 characters
  • query: text, 1 to 200 characters
  • withSong: true or false
  • lyrics: true or false
  • handedSong: text in its own form
  • actions: text, 1 to 400 characters
  • style: named values
  • deck: named values
  • colourBinding: text, 1 to 400 characters

  Ask: “make a tunnel visualizer”, “create a bars visualizer in 9:16”, “start a christmas lights video”.

• generate_visualizer

  Generate a visualizer from a picture or video: Redraws an attached picture as editable palette-based regions and reactive outlines with synthesized motion. For video, choose footage with overlays, a representative-frame redraw, or bounded on-device reconstruction of confident region translations from sampled frames; reconstruction makes editable artwork without a video underlay.

  a script may call it; works from image and video; gives workspace and file.

  • name: text, 1 to 80 characters
  • prompt: text, 1 to 300 characters
  • mode: one of footage, redraw-frame or reconstruct-motion
  • imageTreatment: one of redrawn or original
  • pictureLayer: one of kept or removed

  Ask: “redraw this picture as a visualizer”, “turn this image into an editable visualizer”, “make a visualizer from my photo”.

• animate_picture

  Animate a picture or video in Background Motion: Puts the attached picture or video into a Background Motion scene as a layer, ready to move to the song.

  a script may call it; works from image and video; gives workspace.

  It takes no values.

  Ask: “animate this picture”, “animate this in background motion”, “make this photo move”.

• send_file

  Send a file to a workspace: Sends the attached file to a workspace that takes it: Mastering, the Stem Splitter, Convert, the Thumbnail maker, the Image editor, Cover art, 3D models, Intros and outros, Watermarks, Lyric videos, the Playlist, Music video, or this project.

  a script may call it; changes the open project (a script with it is previewed with Apply or Cancel); works from audio, video, image and model; gives workspace and message.

  • destination: an id (small letters, digits and dashes)
  • kind: one of audio, video, image or model
  • words: text, 1 to 400 characters
  • consent: true or false
  • go: true or false
  • times: an object with start, end and cutLast
    • start: a number from 0 to 7200
    • end: a number from 0 to 7200
    • cutLast: a number from 0 to 7200

  Ask: “send this to mastering”, “master this song”, “split the stems of this track”.

• find_templates

  Find templates and visualizers: Searches every visualizer and its looks by engine, mode, country, animal, creature, occasion, colour or your own words.

  a script may call it; gives list.

  • query: text, 1 to 120 characters
  • engine: an id (small letters, digits and dashes)
  • country: an id (small letters, digits and dashes)
  • animal: an id (small letters, digits and dashes)
  • creature: an id (small letters, digits and dashes)
  • occasion: an id (small letters, digits and dashes)
  • aspect: one of 16:9, 9:16, 1:1, 4:5, 4:3 or 21:9
  • colour: text, 1 to 30 characters
  • limit: a whole number from 1 to 12
  • all: true or false
  • title: text, 1 to 90 characters
  • artist: text, 1 to 90 characters

  Ask: “find a christmas template”, “show me halloween visualizers”, “search for a calm lofi look”.

• apply_look

  Apply a look to this project: Makes a visualizer look the open project's look (Classic) or adds it as a layer (Studio), with the country, animal or creature you name.

  a script may call it; changes the open project (a script with it is previewed with Apply or Cancel); works on an open project in Classic or Studio; gives message.

  • engine: an id (small letters, digits and dashes)
  • mode: an id (small letters, digits and dashes)
  • country: an id (small letters, digits and dashes)
  • animal: an id (small letters, digits and dashes)
  • creature: an id (small letters, digits and dashes)
  • occasion: an id (small letters, digits and dashes)
  • place: one of top or bottom

  Ask: “apply the tunnel look”, “use the bars template on this project”, “switch the look to spectrum”.

• add_layer_assets

  Add layer assets to this project: Searches Sonic Weaver's built-in editable visualizer Layer Assets library, separate from the external Free Library and the /assets backgrounds, photos, music and sound-effect catalog. It previews and filters visualizer parts and add-on layers, including country, animal and sport variants. Questions and browse requests are read-only; a named add request adds only that layer. ‘Add all layers’ requires an explicit visualizer and look/scene, adds only that look's current eligible parts, and refuses the whole batch before changes if it exceeds the 12-layer safety limit. Random picks are unique and preserve the base visualizer.

  a script may call it; changes the open project (a script with it is previewed with Apply or Cancel); gives message and list.

  • words: text, 1 to 300 characters
  • engine: an id (small letters, digits and dashes)
  • mode: an id (small letters, digits and dashes)
  • all: true or false
  • count: a whole number from 1 to 12
  • random: true or false
  • names: a list of text, 1 to 80 characters (1 to 12)
  • assetIds: a list of an id (small letters, digits and dashes) (1 to 12)

  Ask: “add 5 random layers to this project”, “add the snow and sparkles layers”, “put a fog layer over this visualizer”.

• direct_scene

  Direct the scene: Previews how a scene direction will be interpreted, including its actions and song timing, and waits for the user to choose Apply or Cancel before changing the current project. Apply changes only the exact project and Studio layer that were previewed; the edit is one native undo step. Never call this as confirmed without a preview token from the Apply button. Examples include graze, sniff, run away, howl, celebrate, wave, sports actions, and a creature's roar or its power.

  a script may call it; changes the open project (a script with it is previewed with Apply or Cancel); works on an open project in Classic or Studio; gives message.

  • actions: text, 1 to 400 characters
  • confirmed: true or false
  • cancel: true or false
  • previewToken: text, 1 to 80 characters
  • layerId: text, 1 to 120 characters

  Ask: “make the deer run away on the drop”, “sniff at 2 seconds then run away”, “have the wolf howl on every phrase”.

• set_project_details

  Set the title, artist or frame shape: Sets the open project's song title and artist name, or its frame shape (16:9, 9:16, 1:1, 4:5, 4:3, 21:9).

  a script may call it; changes the open project (a script with it is previewed with Apply or Cancel); works on an open project in Classic or Studio; gives message.

  • title: text, 1 to 90 characters
  • artist: text, 1 to 90 characters
  • aspect: one of 16:9, 9:16, 1:1, 4:5, 4:3 or 21:9

  Ask: “set the title to night drive”, “change the artist to kai”, “make it vertical”.

• add_overlay

  Put an overlay over this project: Puts one of the overlays (film grain, light leaks, a vignette, a stream screen...) over the open project's whole video, with your headline on a stream screen. Classic draws overlays; Studio says how.

  a script may call it; changes the open project (a script with it is previewed with Apply or Cancel); works on an open project in Classic or Studio; gives message.

  • overlay: text in its own form
  • query: text, 1 to 120 characters
  • title: text, 1 to 60 characters
  • subtitle: text, 1 to 60 characters

  Ask: “put a film grain overlay on this”, “add the vhs overlay to my video”, “add a vignette overlay”.

• make_thumbnail

  Make a thumbnail from a picture: Runs the Thumbnail maker on the attached picture or video, picks its best layout and gives you the thumbnail as a file.

  a script may call it; works from image and video; gives file and workspace.

  • title: text, 1 to 90 characters

  Ask: “make a thumbnail from this picture”, “turn this into a youtube thumbnail”, “create a thumbnail”.

• make_project_thumbnail

  Make a thumbnail from the open project: Captures the current Classic or Studio project preview, makes a thumbnail in the existing editor Thumbnail maker, and returns the finished image to this chat.

  a script may call it; works on an open project in Classic or Studio; gives file and workspace.

  • title: text, 1 to 90 characters

  Ask: “make a thumbnail from this project”, “create a thumbnail of the current visualizer”, “make a youtube thumbnail from the open project”.

• suggest_song

  Suggest a free song: Suggests free songs from the site's music library, with links that open them in Classic.

  a script may call it; gives list.

  • query: text, 1 to 120 characters
  • limit: a whole number from 1 to 6

  Ask: “suggest a song”, “find me some free music”, “i need a song for my visualizer”.

• answer_help

  Answer a help question: Answers from the site's own documentation (help articles, tutorials, the glossary, the FAQ, tool guides, engine docs, the blog and the changelog), quoting it with links.

  a script may call it; gives passages.

  • question (needed): text, 1 to 300 characters
  • outside: true or false
  • country: text, 1 to 60 characters
  • animal: text, 1 to 60 characters
  • occasion: text, 1 to 60 characters
  • human: true or false
  • category: one of answer, explain, howto, compare, calculate, chart, research, write, code, recommend, plan, troubleshoot and 1 more

  Ask: “how do i export a video”, “what is a beat grid”, “how do i add lyrics”.

• list_functions

  What I can do: Lists every function and chain, and what each needs.

  not in scripts: it only explains what SW Agent can do; gives list.

  It takes no values.

  Ask: “what can you do”, “help”, “list your functions”.

• calculate

  Do the maths: Calculates exactly and shows the working: sums and fractions, bars and beats to seconds at a tempo, seconds to frames at a frame rate. It also writes a checked formula for a control from your words.

  a script may call it; gives message and list.

  • expression (needed): text, 1 to 500 characters
  • bpm: a number over 0, up to 999
  • fps: a number over 0, up to 1000

  Ask: “what is 2 bars at 128 bpm in seconds”, “frames in 3.5 seconds at 30 fps”, “what is 1/4 + 1/8”.

• check_writing

  Check my writing: Checks grammar, spelling, punctuation and clarity: each suggestion with its reason, a score, how easily it reads, and the corrected text to copy or download. Lyrics and captions keep their own style.

  a script may call it; gives message, list and file.

  • text: text, 1 to 2000 characters
  • mode: one of prose, caption, lyrics or title

  Ask: “check my grammar”, “proofread this caption”, “check the spelling in my lyrics”.

• remember

  Remember something about you: Remembers your frame shape, your artist name, where you post or your brand colours, so new work starts with them, or forgets them. See and change everything it remembers in Settings, SW Agent.

  not in scripts: a script never touches your account; gives message.

  • text: text, 1 to 300 characters
  • aspect: one of 16:9, 9:16, 1:1, 4:5, 4:3 or 21:9
  • artist: text, 1 to 90 characters
  • platform: an id (small letters, digits and dashes)
  • handle: text, 1 to 60 characters
  • colours: a list of text in its own form (up to 5)
  • forget: one of frame, artist, channel or brand-colours

  Ask: “remember i post on tiktok”, “remember my artist name is luna bay”, “remember my brand colours are #ff8800 and #220044”.

• export_project

  Export the video: Renders the open Classic project to a video file through Classic's own export, so the file is the same as pressing Export. First it says how long it will take on this device, then it shows progress and hands you the file.

  a script may call it; works on an open project in Classic or Studio; gives file.

  • confirm: true or false

  Ask: “export this project to a file”, “export it to an mp4 file now”, “render it to a file”.

• edit_project

  Change anything in the open project: Changes the active Classic or Studio project through its native editor history: controls, layers, frame rate, quality, playback, seeking, trim, undo or redo. Undo and redo act on the project being edited in this SW-Agent workspace, and scene changes are a single undoable step. It reports which changes were applied or refused.

  a script may call it; changes the open project (a script with it is previewed with Apply or Cancel); works on an open project in Classic or Studio; gives message.

  • words (needed): text, 1 to 400 characters

  Ask: “make it faster”, “turn the glow up a lot”, “set the speed to 1.5”.

• use_app

  Use a creator app: Works it out with one of the apps on SW Agent's canvas, from the numbers or words in your message: delay times at a tempo, a frame's size, a file's size and bitrate, a loudness target, a colour palette, a caption's length, hashtags, YouTube tags, hooks, a reel storyboard, text sizes, lyric syllables, engagement rate, a repurpose plan, a video script outline, a caption file and a release checklist. It says the result, and opens the app there to change.

  a script may call it; gives message, list and file.

  • app: an id (small letters, digits and dashes)
  • input: named values
  • words: text, 1 to 500 characters
  • strict: true or false
  • hints: an object with aspect, colour, title, artist and seconds
    • aspect: text, 1 to 10 characters
    • colour: text, 1 to 7 characters
    • title: text, 1 to 120 characters
    • artist: text, 1 to 120 characters
    • seconds: a number over 0, up to 36000

  Ask: “use the tempo and delay app for 128 bpm”, “run the file size app for a 3 minute video at 8 mbps”, “use the engagement rate app on my last post”.

• find_free_media

  Search the external Free Library: Searches the separate, source-attributed Free Library for openly licensed or public-domain pictures, paintings, video, sound, books and definitions. Each result carries its own source, licence, reuse tier and credit. This is not Sonic Weaver's built-in /assets catalog or its editable Layer Assets library. Inside an editor, Use in this project adds a permitted media item and keeps required credit for export.

  a script may call it; gives list.

  • words: text, 1 to 300 characters
  • query: text, 1 to 200 characters
  • kind: one of image, video, audio, book, term or model
  • use: an object with id, source, kind, title, creator, date, licence, tier, credit, shareAlike, page, media, thumb, alt, text, subjects and language
    • id (needed): text, up to 400 characters
    • source (needed): one of aic, openstax, gutenberg, commons, archive, wiktionary, cleveland, nga, met, polyhaven, kenney, openverse and 2 more
    • kind (needed): one of image, video, audio, book, term or model
    • title (needed): text, up to 300 characters
    • creator: text, up to 300 characters
    • date: text, up to 60 characters
    • licence (needed): an object with id, name and url
      • id (needed): one of cc0, pdm, public-domain, public-domain-us, cc-by or cc-by-sa
      • name (needed): text, up to 80 characters
      • url (needed): text, up to 300 characters
    • tier (needed): one of output-safe, credited or link-only
    • credit (needed): text, up to 400 characters
    • shareAlike: true or false
    • page (needed): text, up to 2048 characters
    • media: text, up to 2048 characters
    • thumb: text, up to 2048 characters
    • alt: text, up to 400 characters
    • text: text, up to 1200 characters
    • subjects (needed): a list of text, up to 120 characters (up to 12)
    • language: text, up to 12 characters
  • sendTo: text in its own form

  Ask: “find copyright free photos of the ocean”, “show me public domain artwork of flowers”, “royalty free images of a city at night”.

• make_document

  Make a document from every source: Reads our docs, world knowledge, Wikipedia and the external source-attributed Free Library on a topic, merges them into one answer with numbered sources, and gives it as a document to download, with cited external pictures and sounds to go with it.

  a script may call it; gives message, file and passages.

  • topic: text, 1 to 300 characters
  • question: text, 1 to 300 characters
  • country: text, 1 to 60 characters
  • animal: text, 1 to 60 characters
  • occasion: text, 1 to 60 characters
  • style: one of friendly, academic, useful, worker, professional or storyteller

  Ask: “write a document about synthwave”, “make me a report on the history of jazz”, “put together a fact sheet about the moon”.

• make_variations

  Make variations of a look: Makes several versions of one look, each with its own colours, motion, music reaction, effects and shape, every value inside the control's own range, and says what makes each one different. Each opens as its own project.

  a script may call it; gives project and list.

  • engine: an id (small letters, digits and dashes)
  • mode: an id (small letters, digits and dashes)
  • country: an id (small letters, digits and dashes)
  • animal: an id (small letters, digits and dashes)
  • creature: an id (small letters, digits and dashes)
  • occasion: an id (small letters, digits and dashes)
  • count: a whole number from 2 to 6
  • query: text, 1 to 200 characters
  • aspect: one of 16:9, 9:16, 1:1, 4:5, 4:3 or 21:9
  • title: text, 1 to 90 characters
  • artist: text, 1 to 90 characters

  Ask: “give me 4 variations of the tunnel look”, “make some versions of the particles visualizer”, “show me different versions of this look”.

• site_status

  Check the live status: Reports whether Sonic Weaver is working right now, as /status shows it: the overall state, any check that is down, the open incidents and when it was last checked.

  a script may call it; gives message and link.

  It takes no values.

  Ask: “is sonic weaver down”, “is the site working right now”, “check the live status”.

• make_beat

  Make a beat or a loop: Makes a beat with code in your browser, a drum groove with a bass line and chords, in the style, tempo, key and length you ask for, as a WAV to download, send to Mastering or Lyric videos, or build a visualizer with.

  a script may call it; gives file and message.

  • words: text, 1 to 300 characters

  Ask: “make a lofi beat”, “make me a beat at 120 bpm”, “a house loop in A minor”.

• read_data

  Read a data file: Reads an attached CSV, TSV or JSON file in your browser: its rows and columns, each number column's range, total and average, a chart, an answer to a question about it, and a summary to download.

  a script may call it; works from other; gives file and message.

  • words: text, 1 to 300 characters

  Ask: “summarise this csv”, “what is in this spreadsheet”, “chart this data”.

• change_setting

  Set any setting: Changes one setting of any workspace or of the open project for you: the tempo, the loudness target, a transition's length, a title, a frame rate, any control of the look. Inside an editor it changes it in place, one undo step; on a page it opens the workspace with it set. It says what it changed, where the control is, and the command that does it again.

  a script may call it; gives message and workspace.

  • words: text, 1 to 400 characters
  • key: a setting's key, workspace.setting
  • value: text, up to 300 characters, a number or true or false
  • by: a number
  • direction: one of up or down
  • amount: one of little, some or lot
  • how: true or false
  • workspace: an id (small letters, digits and dashes)
  • open: an id (small letters, digits and dashes)
  • settings: named values
  • batch: a list of an object with key and value (1 to 16)

  Ask: “set the mastering target to spotify”, “adjust the loudness target in mastering”, “set the transition length to 2 seconds”.

• list_settings

  List the settings and commands: Lists every setting of a workspace (or of the open project) as a command you can type, such as /set mastering.target streaming, with where each control is; or every workspace with its settings. Typed commands are read exactly: /set, /open, /keys, /how and /suggest.

  a script may call it; gives list.

  • words: text, 1 to 400 characters
  • workspace: an id (small letters, digits and dashes)

  Ask: “what settings are there”, “list the settings for mastering”, “what commands are there for mastering”.

• suggest_settings

  Suggest settings: Suggests settings to try for a mood, a genre or a platform (calm, punchy, lofi, EDM, TikTok, YouTube and more): the look's speed and pulse, the transition, the mastering target and preset, the frame shape. Each comes with Apply, and Apply all sets a workspace's together. Different words give different values, and Other values gives the next set.

  a script may call it; gives list.

  • words: text, 1 to 400 characters
  • recipe: an id (small letters, digits and dashes)
  • workspace: an id (small letters, digits and dashes)
  • vary: a whole number from 0 to 50

  Ask: “suggest settings for something calm”, “what settings suit a lofi vibe”, “make the whole thing punchier”.

• find_my_things

  Find my things: Finds what you have made and kept: your projects, your last export, the pictures and files you uploaded, your saved looks and styles, your templates and saved items, and your chats with me, each with a button to open or use it. Signed in it reads your account; signed out, this device.

  a script may call it; gives list.

  • words: text, 1 to 300 characters
  • what: one of project, export, upload, look, template, item or chat
  • go: text in its own form
  • draft: text, 1 to 200 characters
  • use: an object with href, name and type
    • href (needed): text in its own form
    • name (needed): text, 1 to 180 characters
    • type (needed): text, 1 to 100 characters

  Ask: “show my projects”, “show my newest project”, “show my exports”.

• write_blog_post

  Write a blog post: Writes a blog post on your topic in the structure you choose (short, medium or long, with extended thinking to read more) and the writing style you choose, pieced together from my sources: our docs, world knowledge, Wikipedia, the journals and the external source-attributed Free Library, every sentence numbered to its source. As Markdown and PDF to download.

  a script may call it; gives message, file and list.

  • topic: text, 1 to 160 characters
  • words: text, 1 to 500 characters
  • structure: one of short, medium or long
  • style: one of friendly, academic, useful, worker, professional or storyteller
  • extended: true or false
  • seed: a whole number from 0 to 10000
  • human: true or false

  Ask: “write a blog post about synthwave”, “draft an article on the history of jazz”, “write a short blog post about coffee”.

• make_titles

  Make post titles: Suggests titles for a post or video in the familiar patterns (how-to, list, question, number, guide), each with its headline score, and a meta description; or scores a headline you give, check by check. A number in a title is yours or the post's own, never made up.

  a script may call it; gives list.

  • topic: text, 1 to 160 characters
  • words: text, 1 to 500 characters
  • headline: text, 1 to 200 characters
  • style: one of friendly, academic, useful, worker, professional or storyteller
  • sections: a whole number from 1 to 12

  Ask: “give me titles for a post about synthwave”, “headline ideas for my article on coffee”, “title ideas for a blog about music production”.

• write_social

  Write social posts and bios: Writes the text for a post on X, Instagram, TikTok, YouTube, LinkedIn and Facebook, each inside that platform's own length with what shows before "more" first, and hashtags built from your words; or your bio for each, from what you tell me.

  a script may call it; gives list and file.

  • topic: text, 1 to 160 characters
  • words: text, 1 to 500 characters
  • title: text, 1 to 160 characters
  • kind: text, 1 to 40 characters
  • style: one of friendly, academic, useful, worker, professional or storyteller
  • platforms: a list of one of x, instagram, tiktok, youtube, linkedin or facebook (1 to 6)
  • sections: a list of text, 1 to 120 characters (up to 10)
  • link: text in its own form
  • bio: true or false
  • role: text, 1 to 60 characters
  • name: text, 1 to 60 characters
  • makes: text, 1 to 80 characters

  Ask: “write an instagram caption for my new single”, “a linkedin post about my workshop”, “write a tweet about my new video”.

• make_logo

  Make a logo: Draws logos for your brand with code: a wordmark, a monogram, an emblem, an abstract mark and a badge, light and dark, in colours from your words or your brand colours, each checked for contrast. As SVG, or a PNG to download or send to the Image editor, Cover art, Watermarks or another workspace. Without a name, logo ideas.

  a script may call it; gives file and list.

  • name: text, 1 to 60 characters
  • words: text, 1 to 400 characters
  • slogan: text, 1 to 80 characters
  • industry: one of music, tech, retail, food, finance, service, creative, wellness or media
  • mood: one of calm, bold, playful, elegant, natural, tech, retro or dark
  • colours: a list of text in its own form (up to 3)
  • concepts: a list of one of wordmark, monogram, emblem, abstract or badge (1 to 5)
  • initials: text in its own form
  • seed: a whole number from 0 to 10000
  • pick: an object with concept and colourway
    • concept (needed): one of wordmark, monogram, emblem, abstract or badge
    • colourway (needed): one of light or dark
  • send: text in its own form

  Ask: “make a logo for my band”, “design a logo for my coffee shop”, “logo ideas for my podcast”.

• make_names

  Make names and slogans: Suggests brand and business names built around your words, the easiest to say first, and slogans that claim nothing you have not said; with a reminder to check a name is free before you use it.

  a script may call it; gives list.

  • words: text, 1 to 400 characters
  • topic: text, 1 to 120 characters
  • kind: one of names, slogans or both
  • industry: one of music, tech, retail, food, finance, service, creative, wellness or media
  • name: text, 1 to 60 characters
  • seed: a whole number from 0 to 10000

  Ask: “business name ideas for a coffee shop”, “suggest a name for my band”, “brand names for a clothing line”.

• get_started

  How to use SW Agent: Shows how to use me: what I am, the six most useful things to ask where you are (each a button that runs it), how choices, chains, typed commands, research and jobs work, and where help lives. Ask it whenever you are unsure.

  not in scripts: it only explains what SW Agent can do; gives list.

  • tips: one of on or off

  Ask: “start me off”, “i dont understand how to use this”, “show me how to use sw agent”.

• run_script

  Run a script: Runs a script: one of the built-in scripts (a countries batch, every frame shape, the release pictures, a lyric video and more) or one of yours. First it shows every step, then runs them all or one at a time; each step is one undo step in the editors, and the first step that cannot finish stops it with the reason.

  not in scripts: a script cannot run a script: write its steps in instead; gives list, project and file.

  • words: text, 1 to 400 characters
  • builtIn: text in its own form
  • saved: a saved item's id
  • script: text, up to 65536 characters or named values
  • confirm: true or false
  • from: a whole number from 0 to 400
  • count: a whole number from 1 to 400
  • previewToken: text, 1 to 80 characters
  • cancel: true or false
  • previousFiles: a list of text, 1 to 120 characters (up to 12)

  Ask: “run the countries batch script”, “run my script”, “run the release thumbnail set script”.

• list_scripts

  List the scripts: Lists the built-in scripts by workspace and the scripts you saved, each with its steps to see before it runs and Run.

  not in scripts: it only explains what SW Agent can do; gives list.

  • words: text, 1 to 400 characters
  • workspace: an id (small letters, digits and dashes)

  Ask: “what scripts are there”, “show me the built-in scripts”, “list my scripts”.

• write_script

  Write a script from words: Writes a script from what you describe, each step one of my functions with its values ("for each of these countries make a 9:16 clip" repeats a step over the list), shows the steps to read and change, and saves it to your scripts (private to you) or runs it.

  not in scripts: it only explains what SW Agent can do; gives list.

  • words: text, 1 to 400 characters
  • script: named values
  • save: true or false
  • name: text, 1 to 80 characters

  Ask: “write a script that makes my project in every shape”, “make a script for a flag clip per country”, “automate making the release pictures”.

• set_expression

  Put an expression on a control: Puts a formula on one control of the open look or layer, so it moves by itself: written from your words with the song's tempo and the control's own range ("make the glow pulse on every beat"), or the formula you give, checked first and drawn as a curve. Remove it the same way. One undo step.

  a script may call it; changes the open project (a script with it is previewed with Apply or Cancel); works on an open project in Classic or Studio; gives message.

  • words: text, 1 to 400 characters
  • control: text in its own form
  • formula: text, 1 to 2000 characters
  • remove: true or false
  • layer: text in its own form

  Ask: “put an expression on the glow that pulses on every beat”, “add an expression to the speed: value * 2”, “remove the expression from the opacity”.

• preview_file

  Preview on the canvas: Opens the file you attach on my canvas with the controls of its kind: zoom and adjust a picture, play and trim a video or a song, turn a 3D model, read a document or a PDF, see a data file as a table and a chart, try a font.

  a script may call it; works from image, video, audio, model and other; gives message.

  • words: text, 1 to 300 characters

  Ask: “preview this”, “look at this one up close”, “let me see this clip here”.

• make_captions

  Make captions from a song or video: Listens to the song or video you attach, on your device, and writes its words as subtitles by the Song to SRT rules: an SRT, a WebVTT and an LRC, plus a review file with every word's time. They open in the Caption file app to adjust, and import into the editors' Captions panel.

  a script may call it; works from audio and video; gives file and message.

  • words: text, 1 to 400 characters
  • model: one of Xenova/whisper-tiny, Xenova/whisper-base or Xenova/whisper-small
  • isolate: true or false
  • consent: true or false

  Ask: “make captions for this video”, “make an srt from this song”, “transcribe this song”.

• make_pdf

  Make a PDF: Turns text you give me, my last answer or our whole chat into a PDF to download, laid out with headings, paragraphs and lists, made in your browser.

  a script may call it; gives file and message.

  • words: text, 1 to 400 characters
  • text: text, 1 to 20000 characters
  • what: one of text, last or chat
  • title: text, 1 to 120 characters

  Ask: “turn this into a pdf: my studio rules”, “make a pdf of that answer”, “save our chat as a pdf”.

• read_font

  Read a font file: Reads the font file you attach: its names, designer, licence text, how many letters it has, which alphabets it covers and its measurements, and writes your words in it as a picture and as outlines to download (SVG).

  a script may call it; works from other; gives file, message and list.

  • words: text, 1 to 400 characters
  • sample: text, 1 to 60 characters

  Ask: “what font is this”, “read this font file”, “show the glyphs in this font”.

• go_to_page

  Go to a page: Takes you to any page of the site by its name: your dashboard, settings, notifications and badges, the community, creators, help, the changelog, the status page, the legal pages and every tool, from the tool map.

  a script may call it; gives link.

  • words: text, 1 to 400 characters
  • href: text in its own form

  Ask: “take me to my settings”, “open my notifications”, “go to the community page”.

• my_rewards

  My level and badges: Says your level, your XP and the badges you hold, and the next badge closest to earning, SW Agent's own among them, from your account.

  a script may call it; gives message, list and link.

  • words: text, 1 to 400 characters

  Ask: “show my badges”, “what level am i”, “my rewards”.

• share_chat

  Share this chat: Makes a public link to our chat or to one answer, after showing you exactly what it will hold (text and links only; files and the names of your attachments stay with you), with Copy link and share buttons. Turn any link off in Settings, SW Agent.

  not in scripts: a script never touches your account; gives link and message.

  • words: text, 1 to 400 characters
  • scope: one of chat or last
  • confirm: true or false
  • title: text, 1 to 120 characters
  • revoke: text in its own form
  • list: true or false

  Ask: “share this chat”, “share that answer”, “make a link to this conversation”.

• set_agent_kind

  Change the kind of agent: Makes me an Agent (I choose and act), a Runner (I only run programs) or a Planner (I show my steps first), kept in this browser.

  not in scripts: a script never touches your account; gives message.

  • words: text, 1 to 400 characters
  • kind: one of agent, runner or planner

  Ask: “be a planner”, “switch to runner mode”, “act as an agent again”.

• find_videos

  Find a video about it: Links YouTube videos on a topic: our own channel's videos where they fit, and a YouTube search for the rest, always with a caution that videos are not checked sources.

  a script may call it; gives list and link.

  • words: text, 1 to 400 characters
  • topic: text, 1 to 120 characters

  Ask: “show me videos about mastering”, “a youtube tutorial on lyric videos”, “is there a video showing sonic weaver”.

• live_station

  Watch Sonic Weaver Live: Where to watch the 24/7 station (Twitch and Kick), the page that explains it, and its browser source for your own stream.

  a script may call it; gives link and list.

  • words: text, 1 to 400 characters

  Ask: “what's on the live station”, “is sonic weaver streaming”, “where can i watch the 24/7 station”.

• embed_code

  Embed a visualizer on your site: Writes the code to put a visualizer on your own website (WordPress, Squarespace, Webflow, Shopify, any HTML), in the look and frame shape you name, ready to copy.

  a script may call it; gives list and link.

  • words: text, 1 to 400 characters
  • engine: an id (small letters, digits and dashes)
  • mode: an id (small letters, digits and dashes)
  • aspect: one of 16:9, 9:16, 1:1, 4:5, 4:3 or 21:9

  Ask: “embed this visualizer on my website”, “get the embed code for the tunnel look”, “embed code for bars in 9:16”.

• agent_scores

  My benchmark scores: Shows how well I do on the test messages I never learn from, skill by skill, against each skill's floor, as /status shows them.

  a script may call it; gives list and link.

  • words: text, 1 to 400 characters

  Ask: “how accurate are you”, “show your benchmark scores”, “how good is sw agent at routing”.

• connect_ai

  Connect another AI to Sonic Weaver: How to connect Claude, ChatGPT or another assistant to Sonic Weaver through our MCP server, read-only and signed out: its address and what it can do.

  a script may call it; gives list and link.

  • words: text, 1 to 400 characters

  Ask: “connect claude to sonic weaver”, “how do i use sonic weaver from chatgpt”, “mcp server address”.

• make_chart

  Make a chart: Draws a chart from the numbers in your message, a table you paste, or the statistics packs (World Bank, Our World in Data and more): bar, line, area, pie, doughnut or scatter, the kind you name or the one your numbers suit. It says what the chart shows first, keeps the numbers in a table under it, and gives them as a CSV.

  a script may call it; gives message, file and list.

  • words: text, 1 to 2000 characters
  • kind: one of bar, line, area, pie, doughnut or scatter
  • subject: text, 1 to 200 characters

  Ask: “make a bar chart of these numbers”, “chart my monthly views jan 120 feb 180 mar 240”, “draw a line graph of my sales”.

• my_custom_visualizer

  Use my custom visualizer: Puts the visualizer made for you alone on the open project (the look in Classic, a layer in Studio), or opens a new project with it to make a video. Only yours: it is found by its name or its id, on your account, and nobody else's can be used.

  a script may call it; gives message and project.

  • words: text, 1 to 400 characters
  • visualizer: text, 1 to 80 characters
  • video: true or false
  • layer: true or false
  • place: one of top or bottom

  Ask: “use my custom visualizer”, “make a video with my visualizer”, “make a video with my custom visualizer”.

• message_the_team

  Message the team: Opens the form to write to the people who make Sonic Weaver (a question, a bug report, a feature idea or anything else), filled in with what you told me and, for a bug, the page you were on. Nothing is sent until you press Send, and our answer arrives in your notifications.

  not in scripts: a script never touches admin and moderation; gives link.

  • words: text, 1 to 1500 characters
  • kind: one of question, bug, idea or other
  • draft: text, 1 to 1500 characters

  Ask: “i want to report a bug”, “report a bug to the team”, “message the team”.

• transcribe_lyrics

  Write and time a song's lyrics: Listens to the song you attach and writes its lyrics, every line timed to the music, with the lyrics model running on your device (I ask before anything downloads, say its size, and it is kept on your device after the first time; the song never leaves it). The lyrics come as SRT, LRC and WebVTT files, go into Classic's captions when you are in Classic, and can be translated next.

  a script may call it; works from audio and video; gives file, message and list.

  • words: text, 1 to 400 characters
  • model: one of Xenova/whisper-tiny, Xenova/whisper-base or Xenova/whisper-small
  • isolate: true or false
  • title: text, 1 to 90 characters
  • consent: true or false
  • place: true or false

  Ask: “type out the lyrics of this track”, “what words are sung in this song”, “transcribe the lyrics from this audio”.

• split_stems

  Split a song into stems: Splits the song you attach into stems with the stem model running on your device's graphics card: the vocals and the instrumental, one stem, or all four (vocals, drums, bass and other). I ask before anything downloads, say its size, and it is kept on your device after the first time; the song never leaves your device. The stems come as WAV files, and the song opens in the Stem Splitter to change the cleanup and export again.

  a script may call it; works from audio; gives file, message and list.

  • words: text, 1 to 400 characters
  • job: one of vocals, drums, bass, other, all, all-quick or karaoke
  • consent: true or false

  Ask: “separate the vocals from the music in this track”, “give me the instrumental of this song”, “isolate the drums in this track”.

• translate_lyrics

  Translate lyrics: Translates lyrics into another language on your device, every line keeping its time: the caption file you attach (SRT, LRC or WebVTT), or the lyrics I just wrote from your song. The translation alone or under each line, as SRT, LRC and WebVTT files. I ask before anything downloads, say its size, and it is kept on your device after the first time. Machine translation of lyrics is a draft: read it through.

  a script may call it; gives file, message and list.

  • words: text, 1 to 400 characters
  • from: one of en, es, fr, de, zh, ja or vi
  • to: one of en, es, fr, de, zh, ja or vi
  • layout: one of translation or both
  • consent: true or false
  • place: true or false

  Ask: “translate the lyrics into french”, “put my lyrics in german”, “what do these lyrics say in english”.

• remove_background

  Take a picture's background out: Takes the background out of the picture you attach with the image editor's background removal, run on your device: the best model this device can run, or the one you choose (best edges, any subject, or people). I ask before anything downloads, say its size, and it is kept on your device after the first time; the picture is never uploaded. The cut-out comes as a PNG with a transparent background, and the picture opens in the Image editor.

  a script may call it; works from image; gives file, message and workspace.

  • words: text, 1 to 400 characters
  • choice: one of auto, best, fast or portrait
  • consent: true or false

  Ask: “remove the background from this picture”, “cut out the person in this photo”, “make this image a transparent png”.

• picture_depth

  Find a picture's depth: Finds how far away each part of the picture you attach is with the depth model, run on your device, so Generate visualizer moves nearer parts more as its camera drifts. I ask before anything downloads, say its size, and it is kept on your device after the first time; the picture is never uploaded. The look updates in Generate visualizer, and the depth map comes as a picture.

  a script may call it; works from image; gives file, message and workspace.

  • words: text, 1 to 400 characters
  • consent: true or false

  Ask: “find the depth in this picture”, “make a depth map of this photo”, “work out how far away everything is in this image”.

• list_models

  Models I can run on this device: Lists every model I can run on your device: what it does, its download size, whether it is already kept here and whether this device can run it, each with Run. With them, every workspace's settings, actions and models, so you can ask for any of them in words.

  a script may call it; gives list and message.

  • words: text, 1 to 400 characters
  • family: one of lyrics, stems, translation, background or depth

  Ask: “what ai models can you run”, “which models are on this device”, “list your on-device models”.

• after_effects_script

  After Effects script with beat markers: Writes an After Effects script for your export: a composition at its size, frame rate and length with the export and the song lined up and a marker on every beat, phrase and section of the song. Attach the export and its song, or ask in Classic after an export. Run it in After Effects from File, Scripts, Run Script File.

  a script may call it; gives file and link.

  • fps: a number from 1 to 99
  • beats: true or false
  • phrases: true or false
  • sections: true or false

  Ask: “make an after effects script with beat markers for this export”, “after effects script for my video”, “give me a jsx script for after effects”.

• visualizer_from_picture

  Picture to visualizer to project: Generate visualizer redraws your picture using its detected palette, editable regions and reactive outlines, then gives you a still of the look. In an editor it lands in the open project; on this page it opens in Classic as a new project. Then it suggests a free song.

  Make a video; gives a visualizer in a project; works from image.

  1. generate_visualizer: Making the look from your picture, gives the look, from image
  2. look_still: Drawing a still of the look, gives a still (PNG)
  3. look_to_project: Adding the look to this project, gives a layer in this project (in an editor)
  4. look_to_editor: Getting the look ready to open in Classic, gives a Classic project with the look (on a page)
  5. suggest_song: Finding a song to try it with, gives free songs to try
• visualizer_from_video

  Video to visualizer to project: Choose whether video stays as footage with visualizer layers, one representative frame is redrawn, or sampled frame motion is reconstructed as editable artwork. Motion reconstruction stays on-device, tracks confident region translations from at most 16 small frame samples, closes the loop, and has no video underlay; still-image motion is synthesized separately. Then it can make a still and move the result into the current project or Classic.

  Make a video; gives a visualizer in a project; works from video.

  1. generate_visualizer: Building a visualizer from your video, gives the look, from video
  2. look_still: Drawing a still of the look, gives a still (PNG)
  3. look_to_project: Adding the look to this project, gives a layer in this project (in an editor)
  4. look_to_editor: Getting the look ready to open in Classic, gives a Classic project with the look (on a page)
  5. suggest_song: Finding a song to try it with, gives free songs to try
• vertical_lyric_video

  Song to lyric video: Sets up a lyric video in the Kinetic Lyric Typescape look with your song, title and artist: 9:16 for Shorts, Reels and TikTok unless you name another shape (16:9 for YouTube, square for a feed). On this page it builds the project and hands your song over, with the words set to be written from the song; in an editor every step lands in the open project, your picture (if you attach one) becomes the background, and Lyric Videos opens for the words.

  Make a video; gives a lyric video project, 9:16 unless you name a shape; works from audio.

  1. build_project: Building the lyric project with your song, gives a Classic lyric project with your song (on a page)
  2. set_project_details: Setting the frame shape, gives the frame, 9:16 unless you named one (in an editor)
  3. apply_look: Applying the Kinetic Lyric Typescape look, gives the lyric look (in an editor)
  4. send_file: Using your picture as the background, gives the background (in an editor), from image when attached
  5. send_file: Making your song the project's song, gives the song (in an editor), from audio
  6. open_workspace: Opening Lyric Videos for the words, gives Lyric Videos, open (in an editor)
• thumbnail_from_picture

  Thumbnail from a picture: The Thumbnail maker opens your picture or video, picks its best frame and layout with your title, and gives you the thumbnail as a PNG; the design stays open in the maker to change.

  Pictures and thumbnails; gives a thumbnail to download; works from image and video.

  1. make_thumbnail: Designing the thumbnail, gives the thumbnail (PNG), from image and video
  2. open_workspace: Keeping the design in the Thumbnail maker, gives the design, open to change
• release_thumbnails

  Release thumbnail set: One design from your picture or video, made in four sizes for a release: the YouTube thumbnail, the Shorts and TikTok cover, a square cover and the YouTube channel banner, each a file to download. The design stays open in the Thumbnail maker.

  Pictures and thumbnails; gives four release pictures to download; works from image and video.

  1. make_thumbnail: Designing the thumbnail, gives the design, from image and video
  2. thumbnail_set: Making the YouTube, Shorts, cover and banner sizes, gives four pictures (PNG)
  3. open_workspace: Keeping the design in the Thumbnail maker, gives the design, open to change
• countries_batch

  One clip per country: Name the countries and it builds one Countries and Flags project for each, in the frame shape you ask for, each ready to open in Classic and export as its own clip.

  Many at once; gives a project for each country.

  1. pick_countries: Reading the countries you named, gives the countries
  2. country_projects: Building one project per country, gives a project for each country
• playlist_video

  Playlist to one video: Your songs, kept on this device, each get a look from a package that goes together (club night, chill set, clocks...), joined with crossfades into one Timeline that exports as one video. In an editor they join this project's Timeline; on this page the playlist opens in Classic.

  Make a video; gives one video of the whole playlist; works from audio.

  1. keep_songs: Keeping your songs on this device, gives your songs, from audio
  2. pick_playlist_looks: Choosing a look for each song, gives a look for each song
  3. playlist_to_project: Adding the songs to this project's Timeline, gives the Timeline, one part per song (in an editor)
  4. playlist_to_editor: Getting the playlist ready to open in Classic, gives a Classic Timeline project (on a page)
• every_frame

  Every frame shape: The same look in all six frame shapes the editors export (16:9, 9:16, 1:1, 4:5, 4:3 and 21:9): on this page, one project for each to open and export; in an editor, one button per frame to switch the open project before each export.

  Many at once; gives the look in six frame shapes.

  1. resolve_look: Choosing the look, gives the look (on a page)
  2. frame_set: Making all six frame shapes, gives six frame shapes
• stream_screens

  Stream screens from a project: The three stream screens (starting soon, be right back, ending) with your headline: each as a project over your look and as an OBS browser source, or in an editor one button each to put it over the open project. Then the Stream studio opens.

  Streaming; gives three stream screens.

  1. stream_screens: Making the starting soon, be right back and ending screens, gives three screens and their OBS sources
  2. open_workspace: Getting the Stream studio ready, gives the Stream studio
• song_prep

  Master a song and split its stems: Sends your song to Mastering for a louder, even mix and to the Stem Splitter for its vocals, drums, bass and the rest, each waiting in its own workspace.

  Songs and sound; gives a song in Mastering and in the Stem Splitter; works from audio.

  1. send_file: Sending your song to Mastering, gives the song in Mastering, from audio
  2. send_file: Sending your song to the Stem Splitter, gives the song in the Stem Splitter, from audio
• sound_effect

  Words to a sound effect: Finds the sound in Audio effects' library of synthesised presets that fits your words, renders it here as a WAV file to download, and opens Audio effects on it so you can change it.

  Songs and sound; gives a sound effect (WAV) and Audio effects, set up.

  1. pick_setup: Finding the sound for your words, gives the sound preset
  2. render_sound: Rendering the sound to a WAV file, gives the sound (WAV)
  3. launch_workspace: Opening Audio effects on it, gives Audio effects, set up
• cover_art

  Single artwork with your title and artist: Your picture goes into the Album art workspace and it opens as a square cover or a vertical Spotify Canvas loop, with your title and artist on it.

  Pictures and thumbnails; gives cover art, set up with your words.

  1. send_file: Putting your picture in Album art, gives your picture in Album art, from image and video when attached
  2. pick_setup: Choosing a cover or a Canvas, with your words, gives the cover's shape, title and artist
  3. launch_workspace: Opening Album art, gives Album art, set up
• picture_canvas

  On a canvas size in the Image editor: Your picture opens in the Image editor on the canvas size your words name (a 4K or 1080p background, a vertical background, a banner, a square, an overlay and the others), ready to place, retouch and export.

  Pictures and thumbnails; gives your picture on the right canvas; works from image.

  1. send_file: Opening your picture in the Image editor, gives your picture in the Image editor, from image
  2. pick_setup: Choosing the canvas size from your words, gives the canvas size
  3. launch_workspace: Opening the Image editor on it, gives the Image editor, set up
• channel_watermark

  Channel watermark: Opens the Watermarks designer on a ready watermark in the style your words pick, with your channel name and accent colour, to put on every export.

  Streaming; gives a watermark, set up.

  1. pick_setup: Choosing the watermark's style, name and colour, gives the watermark's style
  2. launch_workspace: Opening the Watermarks designer, gives Watermarks, set up
• free_assets

  Sonic Weaver's built-in asset library: Opens Sonic Weaver's own /assets catalog of built-in backgrounds, photos and loops, sound-effect presets, and original or bundled music. This is separate from the external Free Library search and the editable visualizer Layer Assets library. The catalog marks items that require credit; the word 'free' alone does not grant broader reuse rights.

  From our library; gives the asset library, searched.

  1. pick_setup: Reading which assets you want, gives the kind of asset and your search
  2. launch_workspace: Opening the asset library, gives the asset library, set up
• music_video_setup

  Music video, set up: Opens Music video on the gallery template or story your words fit, in the shape and pace you ask for, with your title and artist on the title card. A song you attach goes in as the video's song; without one, you choose it there.

  Make a video; gives Music video, set up.

  1. pick_setup: Choosing the template, shape and pace from your words, gives the music video's template
  2. send_file: Putting your song in Music video, gives your song in Music video, from audio when attached
  3. launch_workspace: Opening Music video, gives Music video, set up
• convert_for_platform

  Platform settings for a file: Your file goes into Convert and compress with the preset your words name set (YouTube, Shorts, Reels, TikTok, Discord, MP3, a podcast, FLAC, a GIF and the others), ready to convert in this tab.

  Songs and sound; gives your file in Convert, with the preset set; works from audio, video and image.

  1. send_file: Putting your file in Convert and compress, gives your file in Convert, from audio, video and image
  2. pick_setup: Choosing the preset from your words, gives the preset
  3. launch_workspace: Opening Convert and compress with it, gives Convert and compress, set up
• model_scene

  3D model, dressed and moving: Your 3D model (or one from the library your words name) opens in 3D models, moving to the beat, in the material your words pick.

  Make a video; gives a 3D model, set up.

  1. send_file: Putting your model in 3D models, gives your model in 3D models, from model when attached
  2. pick_setup: Choosing the model and its material, gives the model and material
  3. launch_workspace: Opening 3D models, gives 3D models, set up
• screensaver_setup

  Screensaver or live wallpaper: Opens the Screensaver on the starter your words fit, as a screensaver or a live desktop background, shuffled or in order, changing look as often as you say.

  Streaming; gives a screensaver, set up.

  1. pick_setup: Choosing the starter, mode and timing, gives the screensaver's settings
  2. launch_workspace: Opening the Screensaver, gives the Screensaver, set up
• transition_setup

  Transition between clips: Opens Transitions on the one your words name (crossfade, dip to black, wipe, glitch slam, film burn and the others), at the length and direction you say, to use at your Timeline's junctions.

  Make a video; gives a transition, set up.

  1. pick_setup: Choosing the transition, its length and direction, gives the transition
  2. launch_workspace: Opening Transitions, gives Transitions, set up
• intro_outro_cards

  Intro and outro cards: Sets up an intro card and an outro card in the style your words pick, with your title and accent colour: each opens in Intros and outros to finish and add to a project.

  Make a video; gives an intro card and an outro card.

  1. pick_setup: Choosing the intro card's style and words, gives the intro card
  2. launch_workspace: Setting up the intro card, gives Intros and outros, set up
  3. pick_setup: Choosing the outro card's style and words, gives the outro card
  4. launch_workspace: Setting up the outro card, gives Intros and outros, set up
• motion_graphic_setup

  Motion graphic for a release: Opens Motion graphics on the designs that match your words, in the look family and frame shape you name, ready to put your words and song in.

  Make a video; gives Motion graphics, searched.

  1. pick_setup: Reading what the design is for, gives the search
  2. launch_workspace: Opening Motion graphics, gives Motion graphics, set up
• moving_background

  Motion template, set up: Your picture goes into Background Motion to be animated, or without one, Background Motion opens on the motion template your words fit (aurora, nebula and the others), ready to use behind a project.

  Make a video; gives a moving background, set up.

  1. animate_picture: Putting your picture in Background Motion, gives your picture in Background Motion, from image and video when attached
  2. pick_setup: Choosing the motion template, gives the motion
  3. launch_workspace: Opening Background Motion, gives Background Motion, set up
• library_layer

  A layer from the library: Finds the layer your words name among every look's own parts and the added layers (snow, rain, sparkles, fog and the rest) and opens the Layers library on it, playing alone, ready to download or add to a project.

  From our library; gives a layer, open in the library.

  1. pick_setup: Finding the layer your words name, gives the layer
  2. launch_workspace: Opening the Layers library on it, gives the Layers library, set up
• particle_visualizer_layers

  Particle visualizer with library layers: Sets the open project to a Particles visualizer, then adds named or unique random eligible assets from the existing layer library. Uses the editor's native actions and keeps every successful addition if a later layer fails.

  Make a video; gives a particle visualizer with editable layers.

  1. apply_look: Setting the particle visualizer, gives the particle visualizer
  2. add_layer_assets: Adding the requested library layers, gives editable layers in the current project
• particle_visualizer_layers_thumbnail

  Particle visualizer, layers, and project thumbnail: Sets the active project to a particle visualizer, adds the requested or random editable library layers, and makes a thumbnail from that project's actual preview in its Thumbnail maker.

  Make a video; gives an editable particle project and its thumbnail.

  1. apply_look: Setting the particle visualizer, gives the particle visualizer
  2. add_layer_assets: Adding the requested library layers, gives editable layers in the current project
  3. make_project_thumbnail: Making a thumbnail from the finished project, gives a thumbnail of the active project
• tempo_reel_plan

  Tempo to delay times, a reel and its caption: From your song's tempo: the delay times for every note, a short reel planned with each cut on a bar, opening lines for it, and whether the first one fits each platform as a caption. Each step is one of SW Agent's apps, worked out here.

  Plans and numbers; gives delay times, a reel cut on the bars, hooks and a caption check; runs from the Chains panel, a button, a plan or a script.

  1. use_app: Working out the delay times at your tempo, gives the note lengths and the bar
  2. use_app: Cutting the reel on the bars, gives a reel plan on the bars
  3. use_app: Writing its opening lines, gives three hooks
  4. use_app: Checking the first hook as a caption, gives where the caption fits
• post_words

  Words for a post: hashtags, YouTube tags and a caption check: Hashtags and YouTube tags made only from your song, your name and your words, then the title with the hashtags checked as a caption against each platform's limit.

  Plans and numbers; gives hashtags, YouTube tags and where the caption fits; runs from the Chains panel, a button, a plan or a script.

  1. use_app: Making the hashtags from your words, gives hashtags
  2. use_app: Fitting the YouTube tags, gives YouTube tags
  3. use_app: Checking the title and hashtags as a caption, gives where the caption fits
• upload_fit

  An upload's pixels, bitrate and platforms: For a video you are about to post: its frame in pixels, the video bitrate that lands it under the size you name (Convert and compress's own rule), and each platform's frame and longest length for it.

  Plans and numbers; gives the frame, the bitrate that fits and each platform's limits; runs from the Chains panel, a button, a plan or a script.

  1. use_app: Working out the frame, gives the frame in pixels
  2. use_app: Finding the bitrate that fits, gives the bitrate for the size
  3. use_app: Planning it for each platform, gives each platform's frame and length
• free_picture_visualizer

  Visualizer from external Free Library art: Picks a public-domain or openly licensed painting or photo from the source-attributed external Free Library, checks its licence, and sends it to Generate visualizer to split into layers that move to your song.

  Make a video; gives a visualizer from external Free Library art.

  1. pick_free_item: Picking external Free Library art for your words, gives a source-attributed picture
  2. send_free_item: Sending it to Generate visualizer, gives the picture in Generate visualizer
• free_sky_scene

  Moving scene from external Free Library art: Picks a sky, texture or painting from the source-attributed external Free Library (including Poly Haven), then puts it into Background Motion to animate behind your music.

  Make a video; gives a moving scene from external Free Library art.

  1. pick_free_item: Picking an external Free Library sky for your words, gives a source-attributed sky
  2. send_free_item: Putting it in Background Motion, gives the sky in Background Motion
• free_song_visualizer

  Visualizer with external Free Library music: Picks a jingle, loop or song from the source-attributed external Free Library (including Kenney CC0 jingles, Openverse and Wikimedia sounds), checks its licence, keeps it as the song, and builds a visualizer project that opens with it.

  Make a video; gives a project with external Free Library music.

  1. pick_free_item: Picking external Free Library music for your words, gives source-attributed audio
  2. free_song: Keeping it as the project's song, gives the song, ready for Classic (on a page)
  3. build_project: Building the project with it, gives a Classic project with the song

An open step (or /open) opens a workspace with launch settings applied. A set step (or /set) changes one setting by its key; every key is on the commands page. Settings of an open project, as keys: Classic, 11, Studio, 11 and The open look's controls, 442.

• background-motion: Background Motion

  7 settings; a script can open it set up:

  • template: A motion template id (find_background_motion lists them). Takes aurora-pulse, nebula-drift, silk-spectrum, sunrise-motion, city-afterglow, retro-horizon, chrome-pulse, midnight-orbit, ocean-caustics, studio-halo.
  • background: One of our pictures to animate, by its site path under /generated/ (find_background_motion lists them).
  • mode: With a picture: animated (default) or still. Takes animated, still.
  • workflow: Open the Picture tab (image-generation) or the Drawings tab (media-visualizer). Takes image-generation, media-visualizer.
  • shape: The scene's frame shape (on the page; inside an editor the scene takes the project's own). Takes 16:9, 9:16, 1:1, 4:5, 4:3, 21:9.
  • seconds (Loop length): The loop's length in whole seconds, 3 to 30. From 3 to 30 s.
  • fps (Frame rate): The loop's frame rate: 24, 30 or 60 frames a second. Takes 24, 30, 60.

• layers: Background & Layer Assets

  1 setting; a script can open it set up:

  • asset: One layer asset by its id: a look's own part (engine--mode--part) or an element preset. The library opens on it, playing alone, ready to download or add to a project.

• stems: Stem Splitter / Mix & Master

  1 setting; a script can open it set up:

  • tab (Workspace tab): Split a song into stems (split), or mix the stems and master the result (master). Takes split, master.

• transitions: Transitions

  3 settings; a script can open it set up:

  • transition (Transition): A transition (list_transitions). Takes cut, continue, smooth, crossfade, dip-black, dip-white, flash, wipe, slide, zoom-in, zoom-out, blur, spin, iris, blinds, cinematic-fade, glitch-slam, neon-streak, film-burn, light-leak, beat-pop, sweep-reveal, hologram, ink-wipe and 10 more.
  • duration (Length): With a transition that has a length: seconds, 0.2 to 5 in steps of 0.1. Cut and Continue are instant. From 0.2 to 5 s.
  • direction (Direction): With Wipe or Slide: the way it moves. Takes left, right, up, down.

• intros: Intros and Outros

  6 settings; a script can open it set up:

  • kind: intro (default) or outro. Takes intro, outro.
  • style: A card style. Takes clean-rise, news-lower-third, type-on, letter-drop, wipe-reveal, glitch-hit, bounce-pop, dream-blur, scale-card, corner-tag, flash-title, drop-down.
  • title: The words on the card (up to 60 characters).
  • accent: The card's accent colour as #rrggbb.
  • duration (Duration): Seconds the card animates in, 1 to 10 in steps of 0.1. From 1 to 10 s.
  • card: A whole card as JSON (what a community post's Use link carries); when set, the other settings are not read. Set by a typed command or a button, not read from a sentence.

• overlays: Overlays

  2 settings; a script can open it set up:

  • category: Show one category of overlays. Takes Visual FX, Ambient, Color Grade, Frame, Stream.
  • q: Words to search the overlays' names, descriptions and tags, every word found (up to 60 characters); list_overlays names them all.

• motion-graphics: Motion Graphics

  10 settings; a script can open it set up:

  • q: Words to search the designs' titles and descriptions.
  • look: A look family. Takes audio-reactive, particles-space, immersive, organic-nature, typographic, geometric, stylized, seasonal, countries, animals, sports, mythology.
  • shape: A frame shape: the gallery lists the designs that suit it, and a design opens in it. Takes 16:9, 9:16, 1:1, 4:5, 4:3, 21:9.
  • era: Which versions to show (all when absent). Takes current, earlier, v2, v1.
  • sort: featured (default) or newest. Takes featured, newest.
  • track: One of our songs (find_assets) every design opens with.
  • beat: A bundled preview beat every design opens with (ignored when a track is set). Takes pulse, groove, drive.
  • title (Title): The member's own title on the design they open (up to 90 characters).
  • artist (Artist): The member's own artist name on the design they open (up to 90 characters).
  • seconds (Length): How long the download is, in seconds. Takes 5, 10, 15, 30, 60.

• lyrics: Lyric Videos

  5 settings; a script can open it set up:

  • look (Look): A visualizer look by its template id (find_engine), or a scene clip such as scene-clips-rain-window, which draws the words inside the scene.
  • lyrics: The words, one line per row (up to 160 lines and 4000 characters).
  • animation: How the words appear; a scene clip brings its own unless one is given. Takes karaoke, word-by-word, typewriter, fade-in, cinematic, 3d-fly-in, keyword-punch, line-card.
  • colour: The words' colour. Takes white, yellow, cyan, pink, lime, orange.
  • size: The words' size. Takes small, medium, large, xlarge.

• audio-effects: Audio Effects

  1 setting; a script can open it set up:

  • preset: One of the 304 synthesised sound presets, by id; it opens in its category, ready to play, change and export. Takes sp-01, sp-02, sp-03, sp-04, sp-05, sp-06, sp-07, sp-08, sp-09, sp-10, sp-11, sp-12, sp-13, sp-14, sp-15, dm-01, dm-02, dm-03, dm-04, dm-05, dm-06, dm-07, dm-08, dm-09 and 280 more.

• albums: Cover Art and Canvas

  4 settings; a script can open it set up:

  • kind: A square cover (1:1) or a vertical Spotify Canvas loop (9:16). Takes 1:1, 9:16.
  • title: The release title on the artwork (up to 80 characters).
  • artist: The artist on the artwork (up to 80 characters).
  • image: One of our pictures as the cover, by its site path under /generated/ (find_assets type backgrounds or photos).

• thumbnails: Thumbnail Maker

  5 settings; a script can open it set up:

  • image: One of our pictures, by its site path under /generated/ (find_assets type backgrounds or photos).
  • layout: With image and format: a template layout. Takes title-left, title-center, band-bottom, frame-card, out-now, frame-only, banner-name, banner-left, banner-schedule, banner-socials, banner-live.
  • format: With image and layout: the template's size. Alone: a banner or profile picture size to start (list_still_formats). Takes youtube, youtube-phone, shorts, square, portrait, stream, banner, avatar, story, pinterest-pin, x-header, facebook-cover, linkedin-banner, twitch-banner, kick-banner, offline-screen, soundcloud-header, spotify-header, discord-banner, reddit-banner, patreon-cover.
  • title (Title): With a template: its first words (up to 60 characters).
  • subtitle (Subtitle): With a template: its second line (up to 60 characters).

• image-editor: Image Editor

  1 setting; a script can open it set up:

  • canvas: The canvas to start on, at its platform's size. Takes youtube-thumbnail, background-1080, background-4k, vertical, cover-art, square, spotify-canvas, banner, watermark, overlay, portrait, avatar, pinterest-pin, x-header, facebook-cover, linkedin-banner, twitch-banner, kick-banner, soundcloud-header, spotify-header, discord-banner, reddit-banner, patreon-cover.

• watermarks: Watermark Maker

  4 settings; a script can open it set up:

  • style: A watermark style; with it, the designer opens a ready watermark. Takes corner-bug, handle-tag, name-badge, lower-third, sting, end-stamp, signature, tiled.
  • name: The channel name or the member's own words (up to 60 characters).
  • handle: The @handle, letters, numbers, dots, dashes and underscores (the @ is added).
  • accent: The accent colour as #rrggbb.

• assets: Asset Library

  5 settings; a script can open it set up:

  • type: The kind of asset (find_assets lists them). Takes music, sound-effects, backgrounds, photos.
  • facet: One of that type's facets: a genre, a mood or a category.
  • q: Search words (up to 100 characters).
  • free: "1" for only the assets that are free to use anywhere. Takes 1.
  • sort: Newest first, or A to Z (featured when absent). Takes newest, az.

• templates: Templates

  9 settings; a script can open it set up:

  • use: Made for: one or more values, comma-separated. Takes lyric-video, spotify-canvas, release-promo, podcast-talk, dj-livestream, logo-brand.
  • mood: Mood: one or more values, comma-separated. Takes chill, energetic, dark, dreamy, retro, elegant, cinematic, playful.
  • genre: Genre: one or more values, comma-separated. Takes hip-hop, edm-dance, lofi-chill, rock-metal, pop, ambient-cinematic, synthwave-80s, acoustic-indie.
  • shape: Shape: one or more values, comma-separated. Takes circular, bars, wave-line, particles, scene, typography, geometric, depth-3d.
  • look: Engine family: one or more values, comma-separated. Takes audio-reactive, particles-space, immersive, organic-nature, typographic, geometric, stylized, seasonal, countries, animals, sports, mythology.
  • aspect: Frame shapes, comma-separated (16:9, 9:16, 1:1 and others the catalogue offers).
  • q: Search words (up to 80 characters).
  • sort: Newest or recently updated first (featured when absent). Takes newest, updated.
  • view: The engines grid or a library tab instead of the looks. Takes engines.

• mastering: Mastering

  2 settings; a script can open it set up:

  • preset (Preset): A mastering chain preset. Takes transparent, gentle-polish, loud-punchy, warm, bright-airy, bass-control, podcast-voice, lofi.
  • target (Loudness target): Where the master should sit: a platform's published loudness, with its ceiling. Takes streaming, apple, club, podcast, broadcast.

• playlist: Playlist

  4 settings; a script can open it set up:

  • package: A set of looks, one per song (list_playlist_packages). Takes club-night, vj-set, chill-set, timekeepers, aurora-drift, cinematic-night, geometric-dream, lyric-story, nature-and-water, sports-arena, celebration-lights.
  • name: The playlist's name (up to 60 characters).
  • shape: The video's frame shape. Takes 16:9, 9:16, 1:1.
  • transition: The change between songs. Takes cut, crossfade, dip-black, dip-white, flash, wipe, slide, zoom-in, zoom-out, blur, spin, iris, blinds, cinematic-fade, glitch-slam, neon-streak, film-burn, light-leak, beat-pop, sweep-reveal, hologram, ink-wipe, checkerboard, diagonal-wipe and 8 more.

• music-video: Make a Music Video

  7 settings; a script can open it set up:

  • template: A music video template from the gallery (list_music_video_styles). Takes neon-night, dreamy, festival, cinematic, warm-acoustic, club, retro-pop, space, road-trip, synthwave-highway, cabin-by-the-lake, paper-town, lofi-study, hip-hop-street, rock-stage, country-back-road, late-night-jazz, indie-storybook, edm-drop, ambient-ocean, cyber-arcade, lyric-first.
  • story: A story from the gallery instead of a template; it wins when both are given. Takes night-drive-home, day-in-my-town, seasons-at-the-cabin, lyrics-tell-it, performance-cutaways, sketch-to-colour, into-space, festival-night, sunset-to-moonrise, memory-lane, rainy-city-lofi, rise-and-fall, release-day, block-party, garage-to-stadium.
  • song: One of the free library songs, loaded on arrival (the member's own song is chosen on the page). Takes neon-pulse, circuit-breaker, synth-storm, deep-drift, laser-grid, digital-rain, voltage, aurora-bloom, ripple-effect, starfall, rainy-window, comet-trail, crystalline-air.
  • aspect: The video's shape. Takes 16:9, 9:16, 1:1, 4:5.
  • pacing: How often it cuts: calm (a shot per part), standard (every 4 to 8 bars) or fast. Takes calm, standard, fast.
  • title: The song title on the title card (up to 120 characters).
  • artist: The artist on the title card and the credits (up to 120 characters).

• convert: Convert & Compress

  2 settings; a script can open it set up:

  • preset: A converter preset: every option set for a platform or an editor. Takes youtube, youtube-shorts, instagram-reels, instagram-feed, tiktok, spotify-canvas, discord, web-small, editor-background, editor-song, editor-overlay-prores, editor-overlay-webm, mp3-320, podcast, streaming-loudness, cd-wav, flac, voice-note, gif-social, gif-sticker, youtube-thumbnail, cover-art, web-webp, png-lossless.
  • format: Without a preset: just the output format. Takes mp4, webm, mov, mov-prores, gif, mp3, wav, ogg, flac, m4a, png, jpg, webp, avif.

• generate-visualizer: Generate visualizer

  3 settings; a script can open it set up:

  • template: A starter look, made from its own picture. Takes synthwave-drive, sunset-lanterns, aurora-silk, storm-front, neon-rain, city-bokeh, rooftop-fireworks, ocean-swell, pool-caustics, beach-sunset-waves, stage-halo, spotlight-solo, campfire-friends, forest-fog, autumn-wind, first-snow, violet-ink, liquid-gold, prism-mandala, starfield-warp.
  • reference: A motion reference the next picture moves like: a gallery id, or mode:<engine>:<mode>, template:<id>, starter:<id>.
  • open: With a template: carry the look straight on into Classic or Studio. Takes classic, studio.

• model-3d: 3D Models

  3 settings; a script can open it set up:

  • model: A model from the 3D library, opened moving to the sample beat. Takes vinyl-turntable, vinyl-record, speaker, microphone, headphones, cassette, guitar, piano-keys, drum, equalizer, crystal, gem, heart, star, planet-rings, island, neon-ring, logo-plate.
  • material: A material worn on every part of the model. Takes matte, gloss, metal, brushed-metal, chrome, glass, neon, rubber, wood, marble, carbon-fibre, fabric, vinyl-grooves, holographic, toon.
  • frame: The frame shape the still and the loop are made in: landscape 16:9, vertical 9:16 or square 1:1. Takes 16:9, 9:16, 1:1.

• stream: Stream

  3 settings; a script can open it set up:

  • station: A whole station as the studio encodes it (the text after ?station= in its OBS source link). Set by a typed command or a button, not read from a sentence.
  • channel: The member's Twitch channel, for the chat beside the stream.
  • engines: Visualizer engines whose looks take turns, comma-separated (find_engine ids); all when absent.

• screensaver: Screensaver

  5 settings; a script can open it set up:

  • starter: A starter screensaver: its looks, rotation, overlays and sound. Takes scene-loops, horizons, rainy-night, desk-clock, party, vj-wall, liquid-calm, sketchbook, every-visualizer.
  • reference: A Motion reference id; its look joins the rotation (ignored when a starter is given).
  • mode: A screensaver, a live desktop background, or both. Takes saver, background, both.
  • order: The looks in order, or shuffled. Takes in-order, shuffle.
  • seconds (Seconds per look): How long each look stays up: whole seconds, 10 to 3600. From 10 to 3600 s.

• assistant: SW Agent

  83 settings; a script does not open it.

  • prompt: A message put in SW Agent's box for the member to send (up to 300 characters). Nothing runs until they press Send.
  • chain: A chain to preview in the chain picker, ready to run. Takes visualizer_from_picture, visualizer_from_video, vertical_lyric_video, thumbnail_from_picture, release_thumbnails, countries_batch, playlist_video, every_frame, stream_screens, song_prep, sound_effect, cover_art, picture_canvas, channel_watermark, free_assets, music_video_setup, convert_for_platform, model_scene, screensaver_setup, transition_setup, intro_outro_cards, motion_graphic_setup, moving_background, library_layer and 8 more.
  • app: One of SW Agent's apps to open on its canvas, with the values given in its own fields filled in. Takes frame-size, colour-palette, caption-length, hashtags, youtube-tags, hooks, reel-storyboard, type-scale, tempo-delay, file-size, lyric-lines, engagement-rate, repurpose-plan, video-script, caption-file, release-checklist, loudness-target, headline-tester, post-titles, business-names, slogan-maker, bio-writer, blog-outline, unit-converter and 11 more.
  • ratio: A value for one of SW Agent's apps: it needs app (frame-size, type-scale) and is checked against that app's own field. Takes minor-third, major-third, perfect-fourth, perfect-fifth, golden.
  • width: A value for one of SW Agent's apps: it needs app (frame-size) and is checked against that app's own field.
  • height: A value for one of SW Agent's apps: it needs app (frame-size) and is checked against that app's own field.
  • base: A value for one of SW Agent's apps: it needs app (colour-palette, type-scale) and is checked against that app's own field.
  • harmony: A value for one of SW Agent's apps: it needs app (colour-palette) and is checked against that app's own field. Takes complementary, analogous, triad, split, monochrome.
  • topic: A value for one of SW Agent's apps: it needs app (hashtags, hooks, video-script, post-titles, blog-outline, lyric-writer) and is checked against that app's own field.
  • title: A value for one of SW Agent's apps: it needs app (hashtags, youtube-tags, hooks, release-checklist, title-card) and is checked against that app's own field.
  • artist: A value for one of SW Agent's apps: it needs app (hashtags, youtube-tags) and is checked against that app's own field.
  • genre: A value for one of SW Agent's apps: it needs app (hashtags, youtube-tags) and is checked against that app's own field.
  • platform: A value for one of SW Agent's apps: it needs app (hashtags) and is checked against that app's own field. Takes instagram, tiktok, youtube, x, linkedin, facebook.
  • count: A value for one of SW Agent's apps: it needs app (hashtags) and is checked against that app's own field.
  • words: A value for one of SW Agent's apps: it needs app (youtube-tags, business-names, slogan-maker) and is checked against that app's own field.
  • kind: A value for one of SW Agent's apps: it needs app (youtube-tags) and is checked against that app's own field. Takes visualizer, lyric-video, music-video, audio.
  • formula: A value for one of SW Agent's apps: it needs app (hooks, video-script) and is checked against that app's own field. Takes question, promise, story, contrast, list, number.
  • audience: A value for one of SW Agent's apps: it needs app (hooks) and is checked against that app's own field.
  • result: A value for one of SW Agent's apps: it needs app (hooks) and is checked against that app's own field.
  • number: A value for one of SW Agent's apps: it needs app (hooks, post-titles) and is checked against that app's own field.
  • seconds: A value for one of SW Agent's apps: it needs app (reel-storyboard, file-size, repurpose-plan) and is checked against that app's own field.
  • scenes: A value for one of SW Agent's apps: it needs app (reel-storyboard) and is checked against that app's own field.
  • bpm: A value for one of SW Agent's apps: it needs app (reel-storyboard, tempo-delay, srt-maker) and is checked against that app's own field.
  • beatsPerBar: A value for one of SW Agent's apps: it needs app (reel-storyboard, tempo-delay) and is checked against that app's own field.
  • aspect: A value for one of SW Agent's apps: it needs app (type-scale, title-card) and is checked against that app's own field. Takes 16:9, 9:16, 1:1, 4:5, 4:3, 21:9.
  • quality: A value for one of SW Agent's apps: it needs app (type-scale) and is checked against that app's own field. Takes 1080, 1440, 4k.
  • note: A value for one of SW Agent's apps: it needs app (tempo-delay) and is checked against that app's own field. Takes 1/1, 1/2, 1/4, 1/8, 1/16, 1/32.
  • feel: A value for one of SW Agent's apps: it needs app (tempo-delay) and is checked against that app's own field. Takes straight, dotted, triplet.
  • videoKbps: A value for one of SW Agent's apps: it needs app (file-size) and is checked against that app's own field.
  • audioKbps: A value for one of SW Agent's apps: it needs app (file-size) and is checked against that app's own field.
  • targetMb: A value for one of SW Agent's apps: it needs app (file-size) and is checked against that app's own field.
  • followers: A value for one of SW Agent's apps: it needs app (engagement-rate) and is checked against that app's own field.
  • views: A value for one of SW Agent's apps: it needs app (engagement-rate) and is checked against that app's own field.
  • likes: A value for one of SW Agent's apps: it needs app (engagement-rate) and is checked against that app's own field.
  • comments: A value for one of SW Agent's apps: it needs app (engagement-rate) and is checked against that app's own field.
  • shares: A value for one of SW Agent's apps: it needs app (engagement-rate) and is checked against that app's own field.
  • saves: A value for one of SW Agent's apps: it needs app (engagement-rate) and is checked against that app's own field.
  • minutes: A value for one of SW Agent's apps: it needs app (video-script) and is checked against that app's own field.
  • sections: A value for one of SW Agent's apps: it needs app (video-script) and is checked against that app's own field.
  • shift: A value for one of SW Agent's apps: it needs app (caption-file) and is checked against that app's own field.
  • format: A value for one of SW Agent's apps: it needs app (caption-file, colour-converter, srt-maker) and is checked against that app's own field. Takes srt, vtt, lrc, all, hex, rgb, hsl, oklch, lab, cmyk.
  • target: A value for one of SW Agent's apps: it needs app (loudness-target) and is checked against that app's own field. Takes streaming, apple, club, podcast, broadcast.
  • measured: A value for one of SW Agent's apps: it needs app (loudness-target) and is checked against that app's own field.
  • peak: A value for one of SW Agent's apps: it needs app (loudness-target) and is checked against that app's own field.
  • headline: A value for one of SW Agent's apps: it needs app (headline-tester) and is checked against that app's own field.
  • style: A value for one of SW Agent's apps: it needs app (post-titles, bio-writer, title-card) and is checked against that app's own field. Takes friendly, academic, useful, worker, professional, storyteller, centered, lower-third, corner, band, split, frame.
  • industry: A value for one of SW Agent's apps: it needs app (business-names) and is checked against that app's own field. Takes music, tech, retail, food, finance, service, creative, wellness, media.
  • take: A value for one of SW Agent's apps: it needs app (business-names, slogan-maker, lyric-writer) and is checked against that app's own field.
  • name: A value for one of SW Agent's apps: it needs app (slogan-maker, bio-writer) and is checked against that app's own field.
  • role: A value for one of SW Agent's apps: it needs app (bio-writer) and is checked against that app's own field.
  • makes: A value for one of SW Agent's apps: it needs app (bio-writer) and is checked against that app's own field.
  • place: A value for one of SW Agent's apps: it needs app (bio-writer) and is checked against that app's own field.
  • person: A value for one of SW Agent's apps: it needs app (bio-writer) and is checked against that app's own field. Takes first, third.
  • structure: A value for one of SW Agent's apps: it needs app (blog-outline, lyric-writer) and is checked against that app's own field. Takes short, medium, long, verse-chorus, verse-chorus-bridge, rap-verse, hook.
  • value: A value for one of SW Agent's apps: it needs app (unit-converter) and is checked against that app's own field.
  • from: A value for one of SW Agent's apps: it needs app (unit-converter) and is checked against that app's own field. Takes mm, cm, m, km, in, ft, yd, mi, nmi, mg, g, kg, t, oz, lb, st, ml, l, tsp, tbsp, floz, cup, pt, qt and 52 more.
  • to: A value for one of SW Agent's apps: it needs app (unit-converter, text-case) and is checked against that app's own field. Takes mm, cm, m, km, in, ft, yd, mi, nmi, mg, g, kg, t, oz, lb, st, ml, l, tsp, tbsp, floz, cup, pt, qt and 60 more.
  • mode: A value for one of SW Agent's apps: it needs app (percentages, date-calculator) and is checked against that app's own field. Takes of, off, increase, decrease, tip, what-percent, change, until, between, add, weekday, age.
  • first: A value for one of SW Agent's apps: it needs app (percentages) and is checked against that app's own field.
  • second: A value for one of SW Agent's apps: it needs app (percentages) and is checked against that app's own field.
  • date: A value for one of SW Agent's apps: it needs app (date-calculator) and is checked against that app's own field.
  • other: A value for one of SW Agent's apps: it needs app (date-calculator) and is checked against that app's own field.
  • amount: A value for one of SW Agent's apps: it needs app (date-calculator) and is checked against that app's own field.
  • unit: A value for one of SW Agent's apps: it needs app (date-calculator) and is checked against that app's own field. Takes days, weeks, months, years.
  • today: A value for one of SW Agent's apps: it needs app (date-calculator) and is checked against that app's own field.
  • colour: A value for one of SW Agent's apps: it needs app (colour-converter, 3d-title, title-card) and is checked against that app's own field.
  • mood: A value for one of SW Agent's apps: it needs app (lyric-writer) and is checked against that app's own field. Takes hopeful, sad, happy, romantic, angry, nostalgic, hype, chill.
  • scheme: A value for one of SW Agent's apps: it needs app (lyric-writer) and is checked against that app's own field. Takes aabb, abab.
  • word: A value for one of SW Agent's apps: it needs app (rhymes) and is checked against that app's own field.
  • key: A value for one of SW Agent's apps: it needs app (chord-progressions) and is checked against that app's own field. Takes C, Csharp, D, Dsharp, E, F, Fsharp, G, Gsharp, A, Asharp, B.
  • scale: A value for one of SW Agent's apps: it needs app (chord-progressions) and is checked against that app's own field. Takes major, minor.
  • progression: A value for one of SW Agent's apps: it needs app (chord-progressions) and is checked against that app's own field. Takes pop, sad, epic, jazz, lofi, blues, doowop, rock, dark, andalusian.
  • source: A value for one of SW Agent's apps: it needs app (srt-maker) and is checked against that app's own field. Takes words, lyrics.
  • barsPerLine: A value for one of SW Agent's apps: it needs app (srt-maker) and is checked against that app's own field.
  • start: A value for one of SW Agent's apps: it needs app (srt-maker) and is checked against that app's own field.
  • text: A value for one of SW Agent's apps: it needs app (3d-title) and is checked against that app's own field.
  • depth: A value for one of SW Agent's apps: it needs app (3d-title) and is checked against that app's own field.
  • bevel: A value for one of SW Agent's apps: it needs app (3d-title) and is checked against that app's own field.
  • background: A value for one of SW Agent's apps: it needs app (3d-title, title-card) and is checked against that app's own field.
  • shape: A value for one of SW Agent's apps: it needs app (3d-title) and is checked against that app's own field. Takes none, plate, ring, disc.
  • move: A value for one of SW Agent's apps: it needs app (3d-title) and is checked against that app's own field. Takes orbit, push-in, fly-past, still.
  • subtitle: A value for one of SW Agent's apps: it needs app (title-card) and is checked against that app's own field.
  • accent: A value for one of SW Agent's apps: it needs app (title-card) and is checked against that app's own field.

An edit step says one of these in words; Classic or Studio reads it against your open project, one undo step each.

• Set a control: Sets any control of the main look or a layer to a value: a number in its range, one of its options, a colour, on or off, or its text.

  Say: “set the speed to 1.5”, “make the primary colour #ff3366”, “turn on beat sync all”, “set the frequency focus to bass heavy”.

• Turn a control up or down: Moves a control a little, some or a lot from where it is, within its range.

  Say: “make the particles bigger”, “a lot faster”, “slightly less glow”, “turn the sensitivity down”.

• Reset a control: Puts a control back to its default.

  Say: “reset the speed”, “put the glow back to default”.

• Change a layer's look: Changes the look of a layer (or the main look) to another engine or mode. Explicitly changing the visualizer/look changes the main look; adding a visualizer creates a separate layer.

  Say: “switch the main look to the tunnel visualizer”, “change the visualizer to particles”, “make the logo layer use the bars visualizer”.

• Add a layer: Adds a visualizer layer over the main look.

  Say: “add particles”, “add a particles layer”, “put a tunnel layer on top”.

• Remove a layer: Removes a layer (the main look stays).

  Say: “remove the bars layer”, “delete layer 2”.

• Duplicate a layer: Adds a copy of a layer, with all its settings, on top.

  Say: “duplicate the bars layer”, “make a copy of the particles layer”.

• Show or hide a layer: Shows or hides a layer without removing it.

  Say: “hide the logo layer”, “show the particles again”.

• Fade a layer: Sets a layer's opacity from 0 to 100%.

  Say: “make the bars layer 50% transparent”, “set the logo opacity to 80%”.

• Blend a layer: Sets how a layer mixes with what is under it (screen, multiply, overlay and the rest).

  Say: “blend the particles with screen”, “set the bars layer blend mode to multiply”.

• Rename a layer: Gives a layer a new name.

  Say: “rename the bars layer to Chorus bars”.

• Reorder a layer: Moves a layer up, down, to the top or to the bottom of the stack.

  Say: “move the logo to the top”, “send the particles down”.

• Select a layer: Selects a layer, so its settings show and the next change goes to it.

  Say: “select the bars layer”, “select the main look”.

• Frame rate: Sets the export frame rate: 24, 25, 30, 50 or 60.

  Say: “export at 60 fps”, “set the frame rate to 24”.

• Export quality: Sets the export quality: 1080p, 1440p or 4K.

  Say: “export in 4k”, “set quality to 1440p”.

• File format: Sets the export file: MP4 or WebM.

  Say: “export as webm”, “make it an mp4”.

• Name the project: Names the project (not the song title).

  Say: “call this project summer tour”.

• Undo and redo: Undoes or redoes the last change.

  Say: “undo that”, “redo”.

• Play and pause: Plays or pauses the preview with the song.

  Say: “play it”, “pause”.

• Go to a time: Moves the playhead to a time in the song.

  Say: “go to 1:30”, “jump to 45 seconds”.

• Trim the song: Keeps only part of the song for the video, from a start to an end time.

  Say: “trim the song from 0:30 to 1:45”, “use only 10 to 40 seconds”.

• Open or close the Timeline: Shows or hides the Timeline panel.

  Say: “open the timeline”, “close the timeline”.

• Mute the preview: Mutes or unmutes the song while you edit (the export keeps its sound).

  Say: “mute it”, “unmute”.

• Export the whole song or the trim: Exports the full song, or only the trimmed part.

  Say: “export the full song”, “export only the trimmed part”.

• Reset the look: Puts every setting of the look back to its template's defaults.

  Say: “reset everything”, “back to the template defaults”.

• Clear the overlays: Removes the visual overlays (grain, light leaks and the rest) from the project.

  Say: “remove all overlays”, “clear the overlays”.

• Keyframe a control: Sets a control's value at a time on the song, so it moves there over time.

  Say: “set the glow to 1.5 at 1:00”, “add a keyframe for speed at 0:30”.

• Make a control follow the music: Makes a control follow the beat, the bass, the mids, the treble, the hits or the loudness.

  Say: “make the glow react to the bass”, “make the speed pulse with the beat”.

• Stop a control following the music: The control stops following the music and holds its value.

  Say: “stop the glow reacting”, “make the speed stop following the music”.

• Put a formula on a control: Puts a formula in the expression language on one control (value is its own value; beat, bar, bass, kick and the rest are the song), or takes it off. The formula is checked before it is written.

  Written by set_expression.

• Add a caption: Adds one caption to Classic's captions: its words, when it starts and when it ends (3 seconds when no end is said).

  Say: “add a caption "Hello" at 0:10”, “add the caption "Goodbye" from 0:20 to 0:24”. In Classic only.

• Change a caption: Changes one caption's words or its times, by its number on the list.

  Say: “change caption 2 to "See you"”, “move caption 1 to 0:30”. In Classic only.

• Remove a caption: Removes one caption, by its number on the list.

  Say: “remove caption 2”, “delete the first caption”. In Classic only.

• Clear the captions: Removes every caption.

  Say: “clear the captions”, “remove all the captions”. In Classic only.

• Add an LFO: Makes a control of the main look move on its own: a sine, triangle, sawtooth, square, noise or bounce wave, at a rate in Hz or in time with the bars, across its range or between two values.

  Say: “add an lfo to the speed”, “put a square lfo on the speed at 2 hz”, “make the speed move with an lfo every bar”. In Classic only.

• Change an LFO: Changes a control's LFO: its wave, its rate, its timing to the bars, or its range.

  Say: “make the glow lfo a triangle wave”, “set the glow lfo to 4 hz”. In Classic only.

• Remove an LFO: Stops a control's LFO; the control holds its value.

  Say: “remove the lfo on the glow”, “stop the glow lfo”. In Classic only.

• Clear the LFOs: Removes every LFO.

  Say: “clear all the lfos”, “remove every lfo”. In Classic only.

• Split the Timeline: Splits the clip under a time (or the playhead) in two on Classic's Timeline; the new clip keeps the same look until you change it.

  Say: “split the timeline at 1:11”, “cut the clip here”. In Classic only.

• Change a Timeline clip: Removes a clip, renames it, or sets the transition into it, by its number along the Timeline.

  Say: “remove clip 2”, “rename clip 1 to intro”, “use a flash transition into clip 2”. In Classic only.

• Change a Timeline part: Removes, renames, duplicates or moves one part (a song or a title card) of the Timeline.

  Say: “delete part 2”, “rename part 1 to verse”, “duplicate part 2”, “move part 2 to the start”. In Classic only.

• Undo and redo on the Timeline: The Timeline's own Undo and Redo: only Timeline steps.

  Say: “undo the last timeline change”, “redo on the timeline”. In Classic only.

• Group layers: Puts two or more layers in one group (a folder in Studio's Layers panel).

  Say: “group the bars layer and the logo layer”, “put layer 1 and layer 2 in a group”. In Studio only.

• Add a shape layer: Adds a 2D or 3D shape layer to Studio's composition.

  Say: “add a shape layer”, “add a 3d shape”. In Studio only.

• Add a graph node: Adds a node to Studio's graph: an audio source, math, remap, envelope, LFO, seeded random, engine input, effect, merge, feedback or output node.

  Say: “add an lfo node”, “add a math node to the graph”. In Studio only.

• Wire two graph nodes: Wires one node's output into another node in Studio's graph; a wire the graph cannot take is refused with why.

  Say: “connect the lfo node to the output node”, “wire node 1 to node 2”. In Studio only.

• Set a graph node's setting: Sets one setting of a node in Studio's graph, such as an LFO node's frequency or an output's target.

  Say: “set the lfo node frequency to 2”, “set node 1 amplitude to 0.5”. In Studio only.

• Make the colour follow the music: Makes the look's colour, or one of its layers' (the snow, the lights, the sky), follow the music: the song's energy, the bass, the low or high mids, the highs, the beat, the brightness of the sound or its sections, as a sweep between colours, a hue turn or a flash on the beat; or stops it.

  Say: “make the colours follow the bass”, “let the colour drift with the song”, “flash the colours white on the beat”, “sweep the colours between blue and pink with the highs”.

• A project setting: Sets one of the project's own settings: the tempo (BPM) in both editors, and in Studio the grid offset, beats per bar, beat unit, width, height, duration, background and preview quality. A number can move from where it is (+10 bpm, a bit faster).

  Say: “set the bpm to 128”, “change the tempo to 140 bpm”, “make the tempo a bit faster”, “raise the bpm by 10”.

The project's own settings

• bpm: BPM, 20 to 400 bpm (Classic and Studio)
• grid-offset: Grid offset, -60 to 60 s (Studio)
• beats-per-bar: Beats per bar, 1 to 32 (Studio)
• beat-unit: Beat unit, one of 2, 4, 8, 16 (Studio)
• width: Width, 16 to 8192 px (Studio)
• height: Height, 16 to 8192 px (Studio)
• duration: Duration (seconds), 0.04 to 86400 s (Studio)
• background: Background (Studio)
• preview-quality: Preview quality, one of auto, low, medium, high, ultra (Studio)

Where send_file (and a step that takes what the step before made) can put a file, by its kind.

• mastering: Mastering, takes audio
• stems: Stem Splitter, takes audio
• convert: Convert & compress, takes audio, video and image
• thumbnails: Thumbnail maker, takes video and image
• banner-maker: Banner maker, takes video and image
• image-editor: Image editor, takes image
• generate-visualizer: Generate visualizer, takes image
• background-motion: Background Motion, takes image and video
• project: This project, takes audio, video and image
• model-3d: 3D models, takes model
• cover-art: Cover art, takes image and video
• music-video-library: My library, takes video, where it applies
• intros: Intros and outros, takes image
• watermarks: Watermarks, takes image
• lyrics: Lyric videos, takes audio
• playlist: Playlist, takes audio
• music-video: Music video, takes audio, image, video and model
• motion-graphics: Motion graphics, takes audio
• stream: Stream studio, takes audio
• screensaver: Screensaver, takes image, where it applies
• assistant: SW Agent, takes audio, video, image and model, where it applies

What another AI assistant can ask Sonic Weaver through its MCP server. Connect an AI assistant.

• list_capabilities

  What this site can do, with live counts

  The engines, modes and overlays this site ships right now, and the two surfaces that can run them. Every count is derived from the same registries the pages render from, so it cannot drift from what the site actually serves. Call this first when you do not yet know what is available.

• find_engine

  Find an engine from a plain-language description

  Describe the look or the track ('something calm for lo-fi', 'reacts hard to the kick', 'geometric and tunnel-like') and get the engines that fit, best first, each with the URL that opens it. Returns an empty list rather than a bad guess when nothing matches.

  Takes description and limit.

• get_engine

  Read one engine's modes, controls and URLs

  Everything the server holds about a single engine: its modes, the controls a person can move, which of those react to audio or can be keyframed, its performance budgets, and the URLs that open it in the Classic editor and Creator Studio. This is the handoff point: the URL is what an AI browser or a person then drives.

  Takes engineId and modeId.

• build_editor_setup

  Build a Classic or Studio URL with the look already applied

  Build a deep link that opens Classic (/editor) or Creator Studio (/studio) with engine, mode, frame aspect, a Sonic Weaver free song URL, overlay, intro/outro template, song title and artist toggles, a Countries & Flags country, an Animals animal, a Mythological Creatures creature, a VJ Deck's own settings (deck: its layers, master effect, clip length, strobe and driving band), a colour that follows the music (colour: in words, or colorBindingJson), optional layers (elementsJson) and optional scene actions (what the animals, people or flag do and when: sceneActions) already applied. The visitor or an AI browser opens the URL and presses Export; this server never renders, records or exports.

  Takes engineId, modeId, surface, aspect, audioUrl, overlayId, overlayOpacity, overlayTitle, overlaySubtitle, introTemplateId, outroTemplateId, countryId, animalId, creatureId, deck, showSongTitle, showAuthorText, songTitle, artistName, elementsJson, colour, colorBindingJson, sceneActions, lookVersion, timelineOpen and edit.

• list_overlays

  The overlay library

  Every overlay that can be layered over a visualizer, with its category, default opacity and tags. Overlays composite in the same browser tab as the engine.

  Takes category.

• find_assets

  Find Sonic Weaver's built-in music, backgrounds and photos

  Search Sonic Weaver's built-in public /assets catalog: original music, sample loops, sound effects, backgrounds, photos and photo loops for videos. This is separate from the external Free Library (use find_free_media) and editable visualizer Layer Assets (use find_layer_assets). Built-in items that need credit carry their credit line. Our music, backgrounds and photos are made with generative AI and say so (aiGenerated, aiModels). Each result has its page, its file and the editors it opens in.

  Takes type, query, category, noCreditOnly and limit.

• get_asset

  One built-in Sonic Weaver asset

  One item from Sonic Weaver's built-in public /assets catalog by its type and id (as find_assets gives them): its file, whether it needs credit, and the editors it opens in. This does not retrieve external Free Library items or editable visualizer Layer Assets; use find_layer_assets for editable visualizer parts.

  Takes type and id.

• find_layer_assets

  Find editable visualizer Layer Assets

  Read-only search of Sonic Weaver's public editable visualizer Layer Assets: look parts and reusable effect presets. Search by subject, name, engine, mode, role or category, including animal, sport and country variants. Results are compact metadata plus a browser link; they are not downloadable image files and this public MCP server never adds them to a private project. To add a result, open Classic or Studio and ask SW-Agent there.

  Takes query, engineId, assetType, category, limit and offset.

• find_motion_graphics

  Find motion graphics

  Search the motion graphics: every look of every visualizer as a short video a person customises (colours, text, shape, length, soundtrack) and downloads from their own browser. Returns each design's page; the video is made in the browser, not by this server.

  Takes query, shape and limit.

• find_background_motion

  Find background visualizer templates and recipes

  Search public Background Motion Studio templates, drawing recipes, shader names and starter loops. Results link to editable browser workspaces and static preview files; this read-only tool cannot inspect private uploads, split images or render media.

  Takes query and limit.

• list_tool_docs

  Find tool guides and previews

  List or search Sonic Weaver's public tool guides. Each result links to the tool and its guide, and names the preview type the browser page provides. Use the browser for live interaction; this read-only server does not render or export media.

  Takes query, category and limit.

• list_editor_workspaces

  Discover tools inside Classic and Studio editors

  List the full creation workspaces currently docked in the Classic and Studio editors, with their supported capabilities, guides and direct routes. This is a public read-only index; use the browser editor for private projects, live previews, processing and exports.

  Takes query, editor and limit.

• open_workspace

  Open a workspace already set up

  Build the URL that opens one of the creation workspaces (list_editor_workspaces) with settings already applied. Workspaces with a launch contract: background-motion (template, background, mode, workflow, shape, seconds, fps); generate-visualizer (template, reference, open); motion-graphics (q, look, shape, era, sort, track, beat, title, artist, seconds); intros (card, kind, style, title, accent, duration); thumbnails (image, layout, format, title, subtitle); assistant (prompt, chain, app, ratio, width, height, base, harmony, topic, title, artist, genre, platform, count, words, kind, formula, audience, result, number, seconds, scenes, bpm, beatsPerBar, aspect, quality, note, feel, videoKbps, audioKbps, targetMb, followers, views, likes, comments, shares, saves, minutes, sections, shift, format, target, measured, peak, headline, style, industry, take, name, role, makes, place, person, structure, value, from, to, mode, first, second, date, other, amount, unit, today, colour, mood, scheme, word, key, scale, progression, source, barsPerLine, start, text, depth, bevel, background, shape, move, subtitle, accent); music-video (template, story, song, aspect, pacing, title, artist); lyrics (look, lyrics, animation, colour, size); transitions (transition, duration, direction); overlays (category, q); screensaver (starter, reference, mode, order, seconds); albums (kind, title, artist, image); assets (type, facet, q, free, sort); audio-effects (preset); templates (look, use, mood, genre, shape, aspect, q, sort, view); layers (asset); model-3d (model, material, frame); mastering (preset, target); convert (preset, format); stems (tab); watermarks (style, name, handle, accent); playlist (package, name, shape, transition); stream (station, channel, engines); image-editor (canvas). Each setting goes through the page's own reader: one the page would not apply is refused with the reason, never written. Other workspaces open plainly. Nothing runs on the server.

  Takes workspace and settings.

• ask_sw_agent

  Ask SW Agent what it would do

  Run SW Agent (Sonic Weaver's own scripted agent, v1.0.3, no AI model) on a message, read-only: it returns the function or chain it would run, the chain's steps with the data each passes on and the workspaces it uses, what it read from the message (look, frame, title, artist, country, workspace), and links that open it in a browser (SW Agent with the message ready, or the editor or workspace already set up). It also returns the checks it would make before acting (“thinking”: a contradiction, a missing file, a destination that cannot take the file, the best-practice rules that apply with their official sources, the facts it stands on, the values it would choose) and "How I would do it" in words. A help question is answered from the site's docs; a project or template request is answered from the catalogue. Nothing runs on the server: the visitor's browser runs the tools. Say which files the person has (attachments) so the plan matches.

  Takes message, surface and attachments.

• search_help

  Search Sonic Weaver's documentation

  Search every help article, FAQ answer, glossary term, tutorial, blog post, tool guide, engine page, overlay, motion graphics family and release note on the site (the BM25F index SW Agent answers help questions from). Returns up to two verbatim quotes with links to the exact section, the pages to read more, or found: false when the docs do not answer it (never a made-up answer).

  Takes query.

• list_still_formats

  Thumbnail, post, banner and profile picture sizes

  The picture sizes the Thumbnail maker designs and exports, grouped (video thumbnails, posts and stories, channel banners and headers, profile pictures), with each one's pixel size, file limit and safe area. The Every platform section downloads any set of them in one ZIP. Sizes marked assumed in the source came from third-party guides, not the platforms.

  Takes group.

• list_transitions

  Transitions and video effects

  Every transition the Classic Timeline and Studio can put between two parts of a video, and every effect it can lay over it, with what each does and its page (preview, length and direction, and downloads: a sample clip, a transparent overlay and a luma matte for other programs).

  Takes query.

• list_playlist_packages

  Playlist visualizer packages

  The Playlist visualizer's packages: sets of visualizer looks that go together, applied one per song across a playlist that exports as one video. Each look names its engine and mode (see get_engine), and the settings it plays with in that package when it has its own (a VJ set's clip length and strobe).

• list_music_video_styles

  Music video maker styles and shots

  The music video maker's pre-settings: its styles (mood words, palette, pacing), pacings, frame shapes and the shelves of shot recipes it cuts a song into. The video is built in the visitor's browser on the page; this lists the choices only.

• calculate

  Calculate exactly, with the working

  Sonic Weaver's calculator (its own engine, no AI model): exact fractions (1/3 + 1/6 = 1/2) and units for music and video. It turns bars and beats into seconds at a tempo ("2 bars at 128 bpm in seconds" = 15/4 s), seconds into frames at a frame rate ("how many frames is 3.5 s at 30 fps" = 105), and handles ms, minutes, px, percent, degrees, radians and turns, with functions (sqrt, sin, log, clamp, lerp, noise, the Penner easings, the superformula). It returns the result, its exact form, the working and where an error is. Describe a motion instead ("pulse the scale on every kick", "loop every 2 bars") and it writes a formula for a Sonic Weaver control, checked against the control's range, its cycle and the flash limit, timed exactly from the tempo, with every fact it used and its source.

  Takes question, bpm, fps and beatsPerBar.

• check_writing

  Check grammar, spelling and clarity

  Sonic Weaver's writing check (its own rules and an English dictionary from WordNet, no AI model): grammar (a or an, "could of", "their is", repeated words, capitals), punctuation and spacing, spelling with suggestions, and clarity (wordy phrases, passive voice with a doer, long sentences). Each suggestion has its exact character range, the replacements and a one-line reason; the result also gives a score out of 100, the word count, the reading time, how easily it reads (Flesch), and the text with every fix applied. Mode `lyrics` and `caption` keep the writer's own capitals and punctuation.

  Takes text and mode.

• list_recent_changes

  Recent changes

  What is new on Sonic Weaver: the latest releases from the changelog, newest first, each with its date, summary and every change (added, improved or fixed). Give words to keep only the changes that mention them all, across every release. Default 3 releases, at most 10.

  Takes limit and query.

• get_sw_agent_scores

  SW Agent benchmark scores

  SW Agent's benchmark scoreboard, as the status page shows it: for each skill (routing a message, reading its details, answering help, planning chains and more) the share of test messages it gets right now, its top-3 score, the floor a release must not drop below and the change since the last version, plus what SW Agent is built from (its code, tests, documents and phrasings). The tests are written apart from what it learns from, and the release gate checks they never overlap.

• run_creator_app

  Run one of SW Agent's creator apps

  Runs one of the creator apps on SW Agent's canvas with the same function the site uses, and returns its result. Read-only: nothing is saved. Apps and their input fields: - frame-size: ratio (text up to 20 characters, optional), width (a whole number from 1 to 16384, optional), height (a whole number from 1 to 16384, optional). - colour-palette: base (text up to 7 characters, required), harmony (complementary, analogous, triad, split, monochrome; required). - caption-length: text (text up to 5000 characters, required). - hashtags: topic (text up to 200 characters, required), title (text up to 120 characters, optional), artist (text up to 120 characters, optional), genre (text up to 120 characters, optional), platform (instagram, tiktok, youtube, x, linkedin, facebook; required), count (a whole number from 1 to 60, optional). - youtube-tags: title (text up to 200 characters, optional), artist (text up to 120 characters, optional), genre (text up to 120 characters, optional), words (text up to 300 characters, optional), kind (visualizer, lyric-video, music-video, audio; optional). - hooks: topic (text up to 160 characters, required), formula (question, promise, story, contrast, list, number; required), audience (text up to 80 characters, optional), result (text up to 80 characters, optional), number (text up to 40 characters, optional), title (text up to 120 characters, optional). - reel-storyboard: seconds (a number from 5 to 600, required), scenes (a whole number from 3 to 8, optional), bpm (a number from 40 to 240, optional), beatsPerBar (a whole number from 2 to 12, optional). - type-scale: aspect (16:9, 9:16, 1:1, 4:5, 4:3, 21:9; required), ratio (minor-third, major-third, perfect-fourth, perfect-fifth, golden; required), quality (1080, 1440, 4k; optional), base (a number from 6 to 400, optional). - tempo-delay: bpm (a number from 20 to 300, required), beatsPerBar (a whole number from 1 to 12, optional), note (1/1, 1/2, 1/4, 1/8, 1/16, 1/32; optional), feel (straight, dotted, triplet; optional). - file-size: seconds (a number from 1 to 36000, required), videoKbps (a number from 0 to 200000, optional), audioKbps (a number from 0 to 1536, optional), targetMb (a number from 1 to 100000, optional). - lyric-lines: lyrics (text up to 6000 characters, required). - engagement-rate: followers (a whole number from 1 to 1000000000000, required), views (a whole number from 0 to 1000000000000, optional), likes (a whole number from 0 to 1000000000000, optional), comments (a whole number from 0 to 1000000000000, optional), shares (a whole number from 0 to 1000000000000, optional), saves (a whole number from 0 to 1000000000000, optional). - repurpose-plan: seconds (a number from 1 to 36000, required). - video-script: topic (text up to 160 characters, required), minutes (a number from 0.25 to 60, optional), sections (a whole number from 1 to 8, optional), formula (question, promise, story, contrast, list, number; optional). - caption-file: captions (text up to 50000 characters, required), shift (a number from -3600 to 3600, optional), format (srt, vtt, lrc; optional). - release-checklist: title (text up to 120 characters, optional). - loudness-target: target (streaming, apple, club, podcast, broadcast; optional), measured (a number from -70 to 0, optional), peak (a number from -30 to 6, optional). - headline-tester: headline (text up to 200 characters, required). - post-titles: topic (text up to 160 characters, required), number (a whole number from 2 to 30, optional), style (friendly, academic, useful, worker, professional, storyteller; optional). - business-names: words (text up to 120 characters, required), industry (music, tech, retail, food, finance, service, creative, wellness, media; optional), take (a whole number from 0 to 20, optional). - slogan-maker: words (text up to 120 characters, required), name (text up to 60 characters, optional), take (a whole number from 0 to 20, optional). - bio-writer: role (text up to 60 characters, required), name (text up to 60 characters, optional), makes (text up to 80 characters, optional), place (text up to 60 characters, optional), style (friendly, academic, useful, worker, professional, storyteller; optional), person (first, third; optional). - blog-outline: topic (text up to 160 characters, required), structure (short, medium, long; optional). - unit-converter: value (a number from -1000000000000000 to 1000000000000000, required), from (mm, cm, m, km, in, ft, yd, mi, nmi, mg, g, kg, t, oz, lb, st, ml, l, tsp, tbsp, floz, cup, pt, qt, gal, ukgal, ms, s, min, h, day, week, year, bit, B, KB, MB, GB, TB, KiB, MiB, GiB, TiB, cm2, m2, km2, ft2, mi2, acre, ha, mps, kph, mph, knot, hz, khz, mhz, pa, kpa, bar, psi, atm, j, kj, cal, kcal, kwh, w, kw, hp, deg, rad, turn, c, f, k; required), to (mm, cm, m, km, in, ft, yd, mi, nmi, mg, g, kg, t, oz, lb, st, ml, l, tsp, tbsp, floz, cup, pt, qt, gal, ukgal, ms, s, min, h, day, week, year, bit, B, KB, MB, GB, TB, KiB, MiB, GiB, TiB, cm2, m2, km2, ft2, mi2, acre, ha, mps, kph, mph, knot, hz, khz, mhz, pa, kpa, bar, psi, atm, j, kj, cal, kcal, kwh, w, kw, hp, deg, rad, turn, c, f, k; required). - percentages: mode (of, off, increase, decrease, tip, what-percent, change; optional), first (a number from -1000000000000 to 1000000000000, required), second (a number from -1000000000000 to 1000000000000, required). - date-calculator: mode (until, between, add, weekday, age; optional), date (text up to 60 characters, optional), other (text up to 60 characters, optional), amount (a whole number from -100000 to 100000, optional), unit (days, weeks, months, years; optional), today (text up to 10 characters, optional). - colour-converter: colour (text up to 80 characters, required), format (all, hex, rgb, hsl, oklch, lab, cmyk; optional). - lyric-writer: topic (text up to 80 characters, required), mood (hopeful, sad, happy, romantic, angry, nostalgic, hype, chill; optional), structure (verse-chorus, verse-chorus-bridge, rap-verse, hook, short; optional), scheme (aabb, abab; optional), take (a whole number from 0 to 50, optional). - rhymes: word (text up to 30 characters, required). - chord-progressions: key (C, Csharp, D, Dsharp, E, F, Fsharp, G, Gsharp, A, Asharp, B; optional), scale (major, minor; optional), progression (pop, sad, epic, jazz, lofi, blues, doowop, rock, dark, andalusian; optional). - text-insights: text (text up to 20000 characters, required). - text-case: text (text up to 2000 characters, required), to (title, sentence, upper, lower, slug, camel, snake, kebab; optional). - srt-maker: source (words, lyrics; optional), input (text up to 100000 characters, required), bpm (a number from 20 to 300, optional), barsPerLine (a number from 0.25 to 16, optional), start (a number from 0 to 36000, optional), format (srt, vtt, lrc; optional). - 3d-title: text (text up to 40 characters, required), depth (a number from 0.05 to 2, optional), bevel (a number from 0 to 0.2, optional), colour (text up to 7 characters, optional), background (text up to 7 characters, optional), shape (none, plate, ring, disc; optional), move (orbit, push-in, fly-past, still; optional). - title-card: title (text up to 80 characters, required), subtitle (text up to 120 characters, optional), style (centered, lower-third, corner, band, split, frame; optional), aspect (16:9, 9:16, 1:1, 4:5; optional), colour (text up to 7 characters, optional), background (text up to 7 characters, optional), accent (text up to 7 characters, optional). A value out of range or of the wrong kind is refused with the reason.

  Takes app and input.

• list_editor_commands

  Every edit SW Agent can make in Classic

  Lists every edit SW Agent makes in the open Classic project when asked in words: any control of the main look or a layer (set, turn up or down, reset), the layer stack (add, remove, show, hide, fade, blend, rename, reorder, select), frame rate, quality, file type, project name, play, pause, jump to a time, trim the song, mute, undo and redo. Give an engine (and a mode) to also get that look's every control with its kind, range, step, options and default. The edits run in the visitor's open editor (the SW Agent tab), never on this server.

  Takes engine and mode.

• list_novus_sites

  List every site in the Novus network

  The other Novus Stream Solutions sites and what each one is for. Call this when the request is not about music visualizers, so you can point at the right site instead of forcing an answer out of this one.

• list_settings

  Every setting of every workspace, as keys

  Lists Sonic Weaver's settings as keys named workspace.setting (mastering.target, thumbnails.title, classic.bpm, look.speed): every setting of every creation workspace (from each one's own launch contract), of the open project in Classic and Studio, and every control of every look. Each comes with its kind, range or options, default, where it is by hand, how SW Agent applies it and the exact command to type into SW Agent (/set mastering.target streaming). Give a workspace for its keys, or words to find keys by name; with neither, every workspace and its count. Change one with change_setting.

  Takes workspace, query and limit.

• change_setting

  Change one setting, checked exactly

  Checks one key (list_settings) and a value as SW Agent does: a number in its range on its step, one of its options (by value, label or another word: spotify is the streaming target), a colour, on or off, words, or a step such as +10 for a number. A workspace's setting comes back as the URL that opens that workspace with it applied, through the page's own reader (other settings of the same workspace can go in `settings`). A setting of the open project in Classic or Studio, or a look's control, comes back as the exact command to type into the SW Agent tab of the visitor's open editor, with that tab's address. Nothing runs on the server; a value that does not fit is refused with the key's own range or options.

  Takes key, value, editor and settings.

• find_free_media

  Search the external Free Library for pictures, sounds, music, 3D models and books

  Searches the separate external Free Library: public-domain and openly licensed artworks (The Met, the Art Institute of Chicago, the Cleveland Museum of Art, the National Gallery of Art), skies, textures and 3D models (Poly Haven), sound effects and music (Kenney and OpenGameArt, served from sonicweaver.com), and books (Project Gutenberg, OpenStax). This is separate from Sonic Weaver's built-in public /assets catalog and editable visualizer Layer Assets (search those with find_layer_assets). Each item has its own licence, the credit line to carry with it, its page, and its file when it has one. Use the credit line wherever the item is used. Only compiled collections are searched, never live services.

  Takes query, kind and limit.

• list_scripts

  List SW Agent's built-in scripts

  Lists the built-in scripts of Sonic Weaver's SW Agent (its own automation, no AI model): the eight named ones (picture to project, a 9:16 lyric video, a countries batch, a playlist video, every frame shape, the release pictures, stream screens, an animal scene) and every chain as a script, each with the workspaces it runs on, the files it needs, its steps as they run (each one SW Agent function with its values, or a chain with words) and its text form. Give `workspace` (an editor workspace id, see list_editor_workspaces) to list only its scripts, or `named: true` for the eight. Read-only: scripts run in the visitor's browser on their own project, from SW Agent's page; members' own scripts are private and never listed.

  Takes workspace and named.

• list_agents

  List SW Agent's agents

  Lists the agents of Sonic Weaver's SW Agent (its own code, no AI model): the Visualizer, Editor, Writer, Designer, Audio, Researcher, Library, Script, Export and Planner agents, and Auto, where SW Agent (the controller) answers itself, hands a request to one agent or splits it among several and reports what each did. Each agent comes with what it is for, its rules, the kinds of tool it works with, its functions, workflows (chains, with their steps), apps and workspaces, the approvals it asks for, its limits for one job (steps, seconds, requests) and a link that opens SW Agent with a request for that agent ready to send. Give `agent` (an agent id) for one. Read-only: an agent runs in the visitor's browser, from SW Agent's chat.

  Takes agent.