Brands

A brand is everything that makes a render look and sound like a specific artist: the name on the title card, the logo top-right, the narrator voice the AI Lyric Generator writes to, and the YouTube / TikTok / Instagram accounts the video ends up on. Most users only need one brand — the app creates it for you the first time you open Settings. If you run more than one channel or artist from the same machine, you can add more, and the UI expands to let you switch between them.

What a brand is

A brand bundles four things:

• Identity — artist / channel name, logo image, logo height. Baked into every render (see Set up your brand).
• Voice — the AI Lyric Generator config: genre, vocal type, Your Sound narrator, explicit-content policy, plus the optional Advanced fingerprint block (see AI Lyric Generator).
• Showcase entry — the YouTube / TikTok URLs and opt-in toggle that decide whether this brand appears in Showcase.
• Platform connections — each brand stores its own OAuth tokens for YouTube, TikTok, and Instagram. Connecting one brand to YouTube does not connect any other brand.

When to use multiple brands

Multiple brands are for people running more than one distinct project from the same install. A few concrete examples:

• One YouTube channel per artist. You produce for two solo acts; each has its own name, logo, sound, and YouTube channel. Keeping them as separate brands means every render is tagged with the right name and uploads land in the right channel automatically.
• Separate niches on the same hardware. A “Dark Pop” lane and a “Lo-fi instrumental” lane with very different Voice fingerprints. Switching brands switches the LLM’s narrator along with the identity.
• Client work. You render for an artist on contract; their brand lives next to yours without clobbering your settings.

If you’re a single-artist user, ignore this feature. The first brand is created for you and nothing in the UI changes.

Creating a second brand

On the Brand settings page, scroll past the active brand’s identity fields to the Create another brand button at the bottom. It opens a small dialog — enter a name, hit Create, and the app immediately switches you to the new brand so you can fill in its logo, voice, showcase entry, and platform connections.

The first brand (internally brand_0001) is created automatically from your existing setup on first launch after upgrade — you don’t need to do anything.

For the step-by-step task guide — including import, export, rename, and delete — see Manage multiple brands.

Progressive disclosure

The multi-brand UI only appears when you actually have multiple brands. With one brand, the app looks exactly as it always has.

When you add a second brand, the following pieces of UI turn on:

• Brand chip — a pill-shaped dropdown showing the active brand’s name appears at the top-right of every screen. Clicking it lists your brands and activates the one you pick.
• Active brand in the sidebar — the active brand’s logo (or initials, if no logo is uploaded) and name appear underneath the app logo in the left sidebar, so you always know where new work is being filed.
• Library brand column + filter — each render card shows the brand it was created under, and a brand filter appears in the toolbar alongside the existing search / sort controls.
• Queue brand chip — each queued/rendering/completed entry on the Queue page shows a small brand chip so you can see which brand a render belongs to across a mixed queue.
• Create page cross-brand warning — if another brand has a render in flight when you switch to a different brand, the Create page shows a banner asking you to finish that render before starting a new one. The render queue serializes across all brands — there’s only ever one render running at a time.
• Create per-render override — the Create page gains a brand dropdown that defaults to the active brand but lets you tag an individual render with a different one.
• Platform banners — Settings → YouTube / TikTok / Instagram each show a “Connecting for brand X” banner so you can’t accidentally wire the wrong account to the wrong brand.

Delete all but one brand and the UI quietly folds back to single-brand mode.

Switching, renaming, deleting

• Switch — use the brand chip at the top of the app to change the active brand. Every subsequent render is tagged with the newly-active brand.
• Rename — edit Artist / Channel name on the Brand settings page; existing renders keep their tag (the brand’s internal ID doesn’t change).
• Delete — the Delete this brand button on the Brand settings page (visible only when you have 2+ brands) removes the currently active brand. The confirm dialog tells you how many renders and songs will be cascade-deleted along with the brand. On confirm the app activates another brand first (the server refuses to delete the active brand), then permanently deletes the brand, its renders (files, thumbnails, upload records), songs, and logo. This can’t be undone.

Per-render brand override

By default, every new render is tagged with the active brand at the moment you hit Render. That’s usually what you want.

When you have two or more brands, the Create page shows a Brand dropdown above the render button. Changing it for a single render tags only that render with the chosen brand — the active brand (chip at the top of the screen) doesn’t change. This is for the occasional “render a song under the other brand without switching the whole UI” case. The render’s platform uploads will go through the chosen brand’s tokens.

Platform connections per brand

Each brand holds its own set of OAuth tokens. The important consequence:

• Uploading a render uses the tokens of whichever brand the render was tagged with, not whichever brand is currently active. This keeps a batch of old renders uploading to the right channel even if you’re in the middle of working on a different brand.
• If the render’s brand isn’t connected to the target platform, the upload refuses with a clear “Brand X is not connected to YouTube/TikTok/Instagram” message. The Library’s upload button pre-disables itself with the same message so you catch the problem before kicking off an upload.
• Reconnecting a platform only affects the brand that was active when you clicked Connect — that’s what the “Connecting for brand X” banner on each platform panel is telling you.

See Uploading a video and Upload troubleshooting for the upload-side behavior.