Operator's Guide · for the Social Media Manager

Volt. — how to use it

Volt is SME South Africa's in-house marketing studio. Write ad copy, design graphics across 14 content families (plus a free-form canvas), build the newsletter, cut webinars into branded shorts, publish straight to social, and now connect an AI tool of your own to it. This guide walks through each, start to finish.

🚀 Getting started ⚡ Campaign ✨ Create (home) ✍️ Copy Lab 🎨 Studio + Brand Kit 🗂️ Studio content families 🖌️ Freeform 📊 Stats ✉️ Email 📅 Schedule 🎬 Video 🎯 SmartClip 🛠️ Admin 🔌 Connect AI Tools (MCP) ⌨️ Shortcuts & export 🛟 Troubleshooting

🚀 Getting started

There are two ways to run — they look identical and share the same engine.

Web app (easiest)

Desktop app (Windows)

  1. Open the app.
  2. Sign in with your @smesouthafrica.co.za work email.
  3. Click ⚙ (top-right) and paste the API keys you were given. These power the AI tools.
ℹ️
The keys live only on your machine. Studio needs no key; the other tools each need their matching one (you'll be told which if it's missing).

The tools

Every page has the same menu down the left side — click a tile to switch (hover it to see the name; the Search tile, or Ctrl K, jumps to any tool):

✨ Create   ✍️ Copy   ⚡ Campaign   🎨 Studio   🖌️ Freeform   📊 Stats   ✉️ Email   📅 Schedule   🎬 Video   🎯 SmartClip   📝 Transcribe   📖 Guide

🛠️
The account owner also has an Admin page (module toggles, social connections, AI-tool keys) — it's off the tab bar since it's a one-time setup, not a daily tool. See Admin below.

⚡ Campaign — one brief, everything made

Describe what you're promoting in plain words and builds the whole campaign in one go: 3 ranked ad-copy angles, 3 finished creatives (rendered by Studio's engine in your brand), a newsletter subject + brief, and a 4-post publishing plan across platforms.

Then hand each piece off

↻ Reroll any single angle or creative without redoing the campaign. 💾 Save keeps it on your account; your last campaign also restores automatically when you come back. The 🧠 panel shows what has learned from your real performance — every campaign is generated with that steering it.

✨ Create — your starting point

The home page. It greets you, offers quick starts (ad copy, a short, a clip, a graphic, a newsletter, stats), and lists your recent work so you can pick up where you left off.

✍️ Copy Lab — ad copy that's ranked for you

Generates multiple ad-copy angles for one offer, each scored so you can pick the strongest.

  1. Type the offer / product you're promoting.
  2. Describe the audience (who it's for).
  3. Pick the platform and tone, and how many variations you want.
  4. Hit Generate.
  5. Read the results — each angle shows hook / clarity / urgency scores, a headline, body, CTA and hashtags. Copy the one you like.
💡
Tip: the scores are a tough media-buyer's grade — use them to compare angles, not as a pass/fail. Mix a high-hook angle with a high-clarity one when testing.

🎨 Studio — graphics & the Brand Kit

A built-in canvas for social graphics. It also holds the Brand Kit — the single source of truth for your colours, logo and name that the Video tool now reads automatically.

Set up your brand once

  1. Open 🎨 Studio → find the Brand Kit.
  2. SME South Africa is the default (red #9c1c1f, navy #0a2c3d). To add another brand, choose ➕ New brand…, set its colours, logo, name and website, and save.
  3. The active brand is what other tools use.
🔗
Why it matters: whatever brand is active in Studio is the brand the Video tool uses for intro/outro colours, the logo and the wordmark — so everything stays on-brand without re-typing.

🗂️ Studio content families — pick a type, not a blank canvas

Past the free-form 🎨 Creative canvas, Studio has 14 purpose-built content families — each with 3 (some 4) pre-designed directions that share one field shape, so switching direction never loses what you typed. Five of them can auto-fill themselves from a pasted article link, saving the retyping entirely.

The general workflow

  1. Open 🎨 Studio → Post type → pick a family from the grid (or Change ▾ once you already have one selected).
  2. If it supports auto-fill (see table below), paste the article link into the box that appears and hit ✨ Fill — it reads the page and fills every direction at once. Otherwise, fill the fields by hand under Content.
  3. Pick a Design direction — the visual treatment. All directions share your typed content, so trying each is free.
  4. Pick Dimensions: Square (1080×1080, IG grid), Portrait (1080×1350, IG feed), Landscape (1200×628, LinkedIn), Story (1080×1920, Reels/Stories).
  5. ⬇ Download HD PNG, or hand it straight to 📅 Schedule from the Export step.
💡
Load a photo (where a family uses one — Founder Focus, Feature, Podcast, Merch…) under its own image field; Studio crops and positions it for you per direction. A design with no photo loaded falls back to a clean typographic layout automatically.

All 14 families

FamilyWhat it's forAuto-fill?
💰 FundingFunding opportunities/grants for SMEs—
◆ SolutionsTool/software reviews and comparisons—
✉ Newsletter"This Week Inside" style — 3 linked stories in one post—
▤ ResourcesDownloadable guides, templates, checklists—
🤝 Get ProvidersSME asking for service providers—
🔎 Find ProvidersMarketplace listing of providers by category—
🎙️ PodcastEpisode card, guest pull-quote, "now playing"—
📰 Latest InsightAny regular article — quote, figure, 3 takeaways✓ paste the link
🧑‍💼 Founder FocusForbes-style founder profile/interview piece✓ paste the link
📚 RoundupBundle 2–5 separate articles into one post instead of posting each on its own✓ paste up to 5 links
🛍️ MerchShop/store product drops and the collection—
🏛️ SME HubCommunity membership — the free-join card, and the "members only" lock—
📖 GlossaryOne term, defined — for the Glossary section of the site✓ paste the term link
🎟️ WebinarsUpcoming/replay webinar promotion—
📚
Roundup, specifically: when your social feed would otherwise get 3 separate posts for 3 articles published the same week, use Roundup instead — paste all the links into its multi-line box (not the single-link box every other family uses), hit Fill, and it writes a fresh headline + one-line "why read it" for each, bundled into one post.

🖌️ Freeform — edit a design by hand

A blank canvas for when a Studio design is close but you want to move things around. Any finished Studio design can be sent here as editable objects (text, shapes, images) instead of a flat picture.

📊 Stats — read your numbers

Turn raw metrics into a decision-ready read. Two ways to use it.

Manual

Live (Postiz)

Newsletter stats + subject audit

✉️ Email — build the newsletter

Describe the week's content, and builds a Kit-ready newsletter in the fixed SME house style. You can then edit it right in the preview and push it to Kit.

Build it

  1. In the big box, describe this week's content — the theme and the sections you want.
  2. Add the exact links may use (text + URL). It only uses these and never invents a URL.
  3. Fill the Email subject and Preview text (used when you send to Kit).
  4. Toggle any promo blocks you need — webinar banner, free resource, sponsored mention, weekly action — and fill their details.
  5. Hit Build email. The live preview appears on the right.

Edit it — right in the preview

Send it

🛫 Pre-flight — one click checks the email the way a deliverability pro would: broken or placeholder links, Gmail's ~102KB clipping limit, spam-trigger phrases, subject/preview length, missing image alt text, and whether your site links carry UTM tags (one click auto-tags them so Stats can attribute the send). Blockers also stop Send to Kit on the first click — fix them or click again to override.

Pre-flight also enforces editorial standards: it flags a salutation you've opened with 3+ sends in a row, warns when promotional blocks are stacked at the bottom instead of woven through the read (✦ Blend promos interleaves them for you — first one lands within two sections of the greeting), catches typos instantly, and 🔤 Deep grammar check runs a full grammar/spelling pass.

📨 Send test — before anything touches Kit, send a real copy to your own inbox. Click Send test above the preview, enter up to 3 addresses (comma-separated) and hit Send it. The subject arrives prefixed with [⚡ Volt Test] so it can never be confused with the real send. Use it to check how the design actually lands in Outlook and Gmail, fix anything, then send the finalised draft to Kit.

⚠️
Images in sent emails: always use a hosted image URL. A file you "upload" only shows in preview unless image hosting is switched on — Gmail/Outlook strip embedded images otherwise.

📅 Schedule — publish, direct

Compose once, then choose where it goes. Instagram, Facebook and TikTok publish directly from — no third-party scheduler in between, so if something fails you see that platform's own error, not someone else's paraphrase of it. Everything else still runs through your connected Postiz instance.

Compose a post

  1. Pick the post type: Feed, ✨ Story or 🎬 Reel — the composer's preview shape changes to match (a Story/Reel previews as a real vertical phone frame).
  2. Load an image — from a Studio export, a file, or Campaign's hand-off.
  3. Write the caption. A Story carries no caption on the real platform — already knows this and won't try to attach one.
  4. Tick which connected channels this goes to (Instagram/Facebook direct, or any Postiz channel).
  5. Choose ⚡ Post now, 🗓️ Schedule for later, or 📝 Save draft (Postiz channels only — Instagram/Facebook/TikTok have no drafts over their own APIs, only "now" or "later").

The calendar

One merged view, bucketed by day — pulls from three sources at once (your Postiz queue, and 's own Instagram and Facebook queues) instead of three separate lists.

⚠️
A "⚠ CRON_SECRET not set" note means scheduling-for-later is off on the server — only Post now will actually publish. That's a one-time setup thing for Tshepho to fix, not something to work around.

Instagram, Facebook & TikTok — one-time connection

🎬 Video — webinar → branded short

The deepest tool. Upload a recording, cut the moment, brand it, caption it, and export. Controls sit right under the video — no scrolling.

The full workflow

  1. Upload your webinar clip (step 1 on the left).
  2. Trim to the moment with the Start / End sliders (step 2).
  3. Format & framing (step 3): pick 📱 9:16, 1:1 or 16:9. Use Crop + a focus side to keep an off-centre speaker, or Blur fill to show the whole frame.
  4. Look (step 4): SME / Clean / Bold colour grade.
  5. Music (step 5, optional): add a track; the speaker's voice always stays on top.
  6. Branding (step 6): pick the Brand kit (pulls colours, logo & name from Studio), then toggle Intro card, Outro card, Hook overlay (first 2.5s), Progress bar and Speaker name. Upload a logo if you want to override the brand one.
  7. Auto-captions (step 7): click ✨ Generate captions. It plays the clip once to read the audio, then writes karaoke captions. Then style them — Highlight colour (incl. the custom picker), Position, Size, Background, ALL CAPS.
  8. Export (under the video): choose 🎞 MP4 (desktop) or WebM (web), then hit Export short.

More clips & transitions

Under Trim, ➕ Add clip appends more footage — b-roll, an outro shot, a second take. Each clip gets its own start/end, can be reordered (↑) or removed (✕), and they play in order after your main clip. Pick the Transition between them: Cut (instant), Fade (dip through black) or Dissolve (cross-fade). Captions and pause-tightening apply to the main clip.

Playback controls (under the video)

✂️ Best moments (auto-highlights)

After captions are generated, a Best moments section appears.

  1. Click ✨ Find highlights — the AI reads the transcript and ranks the most clip-worthy moments.
  2. Each result shows a score, a time range, a one-line reason and a suggested hook.
  3. Tap a card → trims straight to that moment and pre-fills its hook. Regenerate captions on the tight clip, then export.

📝 Post copy & hooks

⚡ Chop all into shorts — one click exports every highlight as its own branded, captioned short, one after the other, hands-off. Captions are carried over per clip automatically (no re-transcribing). Keep the tab focused until it finishes.

⏩ Tighten pauses — after captions are generated, one click removes long silences from the clip. Preview and export both skip the dead air, captions and .SRT stay in sync, and the same button undoes it.

🎞️
MP4 vs WebM: the desktop app exports true .mp4. The web app exports .webm (still plays everywhere, but if a platform refuses it, use the desktop app). Export records in real time — a 40-second short takes about 40 seconds.
💡
Recommended recipe: 9:16 · 20–45s · Crop with focus on the speaker · SME look · Intro + Outro on · Hook overlay on · captions on (bottom, Bar background). That's the SME shorts house style.

🎯 SmartClip — find the moment for you

Video makes you pick the clip. SmartClip finds it. Drop in a full podcast, webinar or Q&A recording — it reads the whole thing, scores every possible cut, and returns only the moments that stand on their own.

  1. Upload the full recording.
  2. Hit ✨ Scan — this transcribes the whole recording once (a real cost/time hit on a long episode), so it's worth doing once and reusing, not re-scanning the same file.
  3. Review the ranked results — each shows a score, a time range and why it was picked.
  4. Pick the ones worth using and hit Send to editor — the clip arrives in Video with its trim, captions and auto-frame path already set. It follows the speaker automatically, so a portrait crop keeps them in shot even if they move.
💡
Use SmartClip for anything long (a 20–60 minute recording) where you don't already know the exact moment. For a clip you've already identified, jump straight into Video instead.

🛠️ Admin — owner-only setup

One-time setup and account-wide switches, kept off the daily tab bar on purpose. Restricted to the account owner; changes apply to everyone in the org.

🔌 Connect AI Tools (MCP)

speaks MCP (Model Context Protocol) — the open standard most AI tools now support for connecting to outside apps. Once connected, Claude Desktop, Claude Code, or any other MCP-compatible tool can generate on-brand copy and read your Brand Kit without leaving that tool.

🔒
Generate-only, by design. A connected AI tool can draft ad copy, newsletter copy and read the Brand Kit. It cannot publish a post, change a setting, or touch anything else in the account — connecting a tool never hands it the ability to act live on your behalf.

1. Generate a key

  1. Open Admin → 🔌 AI Tools (MCP).
  2. Click Generate key.
  3. Copy the key (sk_volt_…) immediately — it's shown exactly once and can't be retrieved again. Losing it just means generating a new one (which retires the old one automatically).

2. Point your AI tool at it

Every MCP client asks for the same three things, just in a different-shaped form:

What it asks forWhat to enter
Server URL / endpoint/api/mcp
Auth headerAuthorization: Bearer sk_volt_… (your key)
TransportStreamable HTTP (the standard remote-MCP transport — no local install, nothing to keep running)

Claude Code

claude mcp add --transport http volt /api/mcp --header "Authorization: Bearer sk_volt_..."

Claude Desktop

Settings → Connectors → Add custom connector — paste the URL above, add the Authorization header with your key.

3. What it can do

🎨
Not included yet: generating an actual Studio design image through MCP. Studio's canvas renderer runs in the browser, not on the server, so there's currently no way for an outside AI tool to produce a finished graphic — only the copy that goes into one.

Rotating or revoking

Same Admin card. Rotate key replaces the active key immediately (the old one stops working — update every connected tool). Revoke disables access entirely until you generate a new one. Only one key is active per account at a time.

⌨️ Shortcuts & export reference

Video keyboard

KeyDoes
SpacePlay / pause the preview
← / →Rewind / fast-forward 2 seconds
Drag the barScrub anywhere in the timeline

What each tool gives you

ToolOutput
Copy LabRanked ad angles (headline, body, CTA, hashtags)
CampaignAd angles + creatives + newsletter brief + publishing plan, in one go
StudioSocial graphics across 14 content families (downloaded image)
StatsBenchmarked read + action list, plus real Kit/Postiz numbers
EmailKit-ready HTML (copy, download, or push to Kit)
SchedulePublished or queued post — direct to Instagram/Facebook/TikTok, or via Postiz
VideoBranded short (.mp4 desktop / .webm web) + .SRT
SmartClipRanked clip-worthy moments from a full recording, sent straight to Video
MCPOn-brand copy and Brand Kit data, generated from an outside AI tool

🛟 Troubleshooting

You see…Do this
"… API key required" (desktop)Click ⚙ → paste the matching key. Copy/Stats/Email need Gemini; captions need Groq.
Captions won't generateThe clip needs sound, and a Groq key must be connected. It plays the clip once to read audio — let it finish.
Can't export MP4MP4 is desktop only. On the web app, export is WebM. (If desktop MP4 errors, it saves WebM as a fallback.)
Email image missing when sentUse a hosted image URL — uploaded files only show in preview unless image hosting is set up.
"Send to Kit" says not connectedA Kit API key is needed (web: in Vercel; desktop: ⚙ Settings).
Schedule says "⚠ CRON_SECRET not set"Scheduling-for-later is off on the server — only Post now works until it's set. One-time fix, not something to work around.
TikTok posts are all privateExpected until TikTok finishes reviewing the app for public posting — not a bug, see Schedule.
MCP tool "Missing or invalid API key"Generate/rotate a key in Admin → AI Tools (MCP) and make sure the connected tool has the exact sk_volt_… value in its Authorization header.
New change not showing (web)Hard-refresh the page (Ctrl+F5).
🆘
Anything stuck or confusing? Note exactly what you clicked and the message you saw, and send it to Tshepho — that's all that's needed to fix it fast.

↑ back to top