Support & FAQ

Find answers to common questions or reach out to our support team.

Contact Support

Can't find your answer below? Email our support team and we'll get back to you as soon as possible.

support@b-roll.me

Getting Started

How do I get started with B-Roll Me?
Download the app for your platform, install it, and open it. Go to Settings and add at least one AI API key (Anthropic, OpenAI, Gemini, or OpenRouter). Then create a new project from the Dashboard, paste your video script, and click Analyze.
Where do I get an AI API key?
Sign up at the provider of your choice: console.anthropic.com for Claude, platform.openai.com for GPT, aistudio.google.com for Gemini, or openrouter.ai for OpenRouter. Each provider has a free tier or free credits for new accounts.
Do I need a YouTube API key?
No. B-Roll Me searches YouTube and fetches transcripts without needing a YouTube Data API key. It uses the InnerTube protocol directly.

Using the App

What does "Auto-Analyze" do?
Auto-Analyze runs the full pipeline — Analyze, Search, and Evaluate — with a single click. Paste your script, hit Auto-Analyze, and come back to scored B-Roll results ready for download.
Can I use different AI models for different tasks?
Yes. In Settings > Analysis Preferences, you can set a different model for script analysis and clip evaluation. Use a cheap, fast model for analysis and a more capable model for evaluation.
What video formats can I download?
MP4 and WebM. You can also choose resolution (best available, 1080p, or 720p) and set a default output directory.
How does transcript matching work?
After finding candidate clips on YouTube, B-Roll Me fetches each video's transcript (captions). It then searches the transcript for keywords related to your script context and highlights matching segments with timestamps.
What is local Whisper transcription?
When a YouTube video has no captions, B-Roll Me can use Whisper (an open-source speech recognition model) to transcribe the audio locally on your device. On Apple Silicon Macs, this is Metal-accelerated for faster processing.

Licensing & Trial

How long is the free trial?
5 days. No credit card required. The trial is full-featured — the only requirement is bringing your own AI API key.
What happens when the trial expires?
The app shows a license-required screen and blocks functionality until you purchase a license. Your projects, settings, and data are preserved.
Where do I purchase a license?
Visit b-roll-me.lemonsqueezy.com or click the "Purchase License" button in the app. Payments are processed through Lemon Squeezy.

Troubleshooting

Analysis returns an error about invalid API key
Double-check your API key in Settings. Use the "Test Connection" button to verify it works. Make sure you have billing enabled with the provider if required.
YouTube search returns no results
This can happen if YouTube temporarily blocks requests. Try again after a few minutes. If the issue persists, check your internet connection.
Downloads are failing
Make sure the output directory exists and is writable. Try updating yt-dlp from Settings > Tools. Some videos may have download restrictions that prevent segment extraction.

Looking for detailed guides?

Browse the documentation