From download to first video in 15 minutes.
Six steps, all in plain English. If anything blocks you, open a GitHub issue and we'll patch the guide.
Current desktop release: v1.3.4 · Windows x64 · macOS Apple Silicon and Intel · unsigned beta
System requirements
Windows 10 (build 1809+) or Windows 11
macOS 11+ (Apple Silicon or Intel) also supported. Linux is on the roadmap.
~5 GB free disk space for the install
Plus space for renders — budget another 1-2 GB per finished video.
8 GB RAM minimum, 16 GB recommended
Layered scenes + PSD imports + multi-channel projects benefit from 16+.
Discrete GPU strongly recommended
NVIDIA / AMD with NVENC or AMF support cuts render time ~10x vs CPU-only.
Install + first run
- 01
Download the Windows installer
Click 'Download for Windows' below to get TaleCut-Setup-1.3.4.exe. On Windows, TaleCut checks the published release feed, downloads an available update in the background, verifies it against the release manifest, and asks before relaunching to install it.
- 02
Click past the SmartScreen warning
Windows will show 'Microsoft Defender SmartScreen prevented an unrecognized app from starting'. That is expected — it appears for any installer without a paid code-signing certificate, not because anything is wrong with the file. Click 'More info' → 'Run anyway'.
- 03
Run the app
Installs to C:\Program Files\TaleCut\ in about 60 seconds and creates a Start-menu entry plus a desktop shortcut.
- 04
Sign in + unlock your free credits
The app is free to install; using it needs a TaleCut account. A $0 card unlocks the Free plan: 150 credits/month with a 60-credit weekly cap. Paid plans include exactly 10% more monthly credits than their cash face value. Plan credits reset monthly and are weekly-capped; purchased top-ups never expire and are uncapped. 1 credit = $0.01 face value. Local rendering never uses credits.
- 05
Connect a YouTube channel
Channels → Add Channel opens the browser OAuth flow. Sign in to the Google account that owns the channel and grant the requested scopes. The token is stored in your OS keychain.
- 06
Run Channel Assistant, then the guided director
Channel → Setup → describe your niche in one sentence. TaleCut generates a brand bible + 50 video ideas. New here? The guided "make a video" director walks you end-to-end with a cost gate at each step.
macOS 11+, Apple Silicon & Intel
TaleCut runs on macOS 11+ (Apple Silicon and Intel). It’s an unsigned beta, so the first launch needs one extra click.
- 01
Download the right .dmg for your Mac
Apple Silicon (M1–M4) Macs use the arm64 build; older Intel Macs use the x64 build. Not sure? Apple menu → About This Mac → look for 'Apple M…' (arm64) vs 'Intel' (x64).
- 02
Open it past Gatekeeper
The app is an unsigned beta, so a double-click shows 'cannot be opened because Apple cannot check it for malicious software.' Right-click (or Control-click) the app → Open → Open. You only do this once.
- 03
First run — same as Windows
Sign in, connect a YouTube channel, and run Channel Assistant — no API keys to paste. FFmpeg is bundled. Unsigned macOS builds check for updates but do not replace the app silently: TaleCut notifies you and opens this page for the correct Apple Silicon or Intel download.
TaleCut bundles FFmpeg (ffmpeg + ffprobe), licensed under the GPL. Source and license: ffmpeg.org.
Common problems
SmartScreen blocks the installer entirely
Right-click the .exe → Properties → check 'Unblock' → Apply, then re-run. This happens when the browser strips the mark-of-the-web on download.
AI generation says "sign in" or "out of credits"
AI runs on your TaleCut credits — there are no keys to set up. Open the app's Cloud AI panel to confirm you're signed in and check your balance; new accounts start on the free tier or a plan from $9/mo; top up anytime from $5.
YouTube OAuth keeps redirecting / fails
OAuth opens your default browser. With multiple Google accounts, make sure the picker lets you choose the one that owns the channel. Brand-account channels need the Brand Account switcher.
First render is slow / GPU not detected
The bundled FFmpeg autodetects NVENC (NVIDIA) and AMF (AMD). If autodetection fails, Settings → Render → Encoder lets you force a backend or fall back to CPU. NVIDIA users on drivers <531 should update first.
Still stuck?
Open a GitHub issue at our repo with the Help → Support Bundle attached (auto-zipped logs + system info, redacted of API keys). We respond within ~48 hours.