# ViralMint

> Open-source desktop app + browser portal that scouts trending videos across YouTube, TikTok, Douyin, Reddit and Google Trends, downloads and analyses competitor clips with Whisper + AI insights, and generates original AI videos (script + voice + word-by-word captions + background music) for creators to download and post manually. A free web-lite version runs at https://viralmint.net/app.

ViralMint is a single-product project. The desktop app does the heavy local lifting (yt-dlp, Whisper, FFmpeg, video pipeline) and the browser portal exposes the lightweight cloud-only features (chat, image generation, text-to-speech, AI music, account & balance). Both share the same account — a registered user gets a small free daily allowance and can top up prepaid USD balance via Stripe one-time payments. There is no BYOK (bring-your-own-API-keys) — all AI provider access is proxied through our cloud backend.

## Technical Performance (Benchmarks)

- **Transcription:** faster-whisper (int8) transcribes 10 minutes of audio in ~45s on mid-range hardware (8GB RAM).
- **Rendering:** FFmpeg-based Smart Video assembly takes ~2-5 mins for a 60s Short.
- **Discovery:** Multi-platform scout queries (YouTube, TikTok, Reddit) return results in <3s via parallelized async workers.
- **MCP Latency:** Local loopback tool calls execute with <5ms overhead.

## Pages

- [Home](https://viralmint.net/): What ViralMint does, free tier, download links for macOS / Windows / Linux, and link to the browser-based lite version.
- [About](https://viralmint.net/about): Project background, who built it, design principles, open-source stance.
- [Privacy](https://viralmint.net/privacy): Privacy policy — what data is collected, where it lives (locally on the user's machine for desktop; on AWS for the cloud backend).
- [Terms](https://viralmint.net/terms): Terms of service.
- [Browser app](https://viralmint.net/app): Logged-in lite version of ViralMint — chat, AI image, AI voice (TTS), AI music, history, account top-up. Same account as the desktop.

## Flagship money pages

Top-level commercial landing pages targeting specific keyword clusters. Same `/tools/*` + `/alternatives/*` sitemap priority weight.

- [AI Clipper](https://viralmint.net/ai-clipper/): Free AI clipper / auto clipper / clip app — turn long videos into viral 30-60s shorts with captions. Local Whisper, no subscription, no watermark, 1,800+ source sites via yt-dlp.
- [YouTube Clip Extractor](https://viralmint.net/youtube-clip-extractor/): YouTube-specific deep dive on the same AI clipper — paste URL → captioned 9:16 mp4s.
- [AI Shorts Maker](https://viralmint.net/ai-shorts-maker/): Generate Shorts from a niche prompt instead of clipping an existing video.
- [Faceless Video Generator](https://viralmint.net/faceless-video-generator/): Topic → AI script + AI voice + Pexels b-roll + AI music + word-by-word captions.
- [Trending Finder](https://viralmint.net/trending-finder/): Multi-platform trend scout (YouTube · TikTok · Douyin · Reddit · Google Trends) with outlier detection.
- [AI Script Writer for YouTube](https://viralmint.net/ai-script-writer-youtube/): Transcript-aware, search-demand-injected script generation.

## Tools

Single-purpose creator tools — each has its own landing page with a HowTo + FAQPage schema. The video downloader has 25 platform-specific sub-pages covering the quirks of each platform's CDN, quality variants and auth requirements.

- [Video Downloader hub](https://viralmint.net/tools/video-downloader/): yt-dlp powered, 1,000+ sites, no watermark, no ads, no cap.
  - [YouTube downloader](https://viralmint.net/tools/video-downloader/youtube/): HD mp4, age-gate + 4K via cookies.
  - [TikTok downloader](https://viralmint.net/tools/video-downloader/tiktok/): platform-quality mp4, no-watermark transparency.
  - [Bilibili downloader](https://viralmint.net/tools/video-downloader/bilibili/): B站 HD with .ass subtitles + danmaku, geo-fence workaround.
  - [Douyin downloader](https://viralmint.net/tools/video-downloader/douyin/): 抖音 mp4 via TikHub fallback.
  - [Instagram downloader](https://viralmint.net/tools/video-downloader/instagram/): Reels + Stories + feed, cookie auth for private.
  - [Twitter / X downloader](https://viralmint.net/tools/video-downloader/twitter/): 1080p variant, no Premium.
  - [Reddit downloader](https://viralmint.net/tools/video-downloader/reddit/): video + audio remuxed (browser saves silent mp4).
  - [Twitch downloader](https://viralmint.net/tools/video-downloader/twitch/): clips + full VODs, sub-only via cookie.
  - [Vimeo downloader](https://viralmint.net/tools/video-downloader/vimeo/): public + password-protected.
  - [Dailymotion downloader](https://viralmint.net/tools/video-downloader/dailymotion/): HD mp4, francophone catalog.
  - [Facebook downloader](https://viralmint.net/tools/video-downloader/facebook/): feed + Reels + Watch + closed groups (via cookie).
  - [Pinterest downloader](https://viralmint.net/tools/video-downloader/pinterest/): video pins + Idea Pin slides.
  - [LinkedIn downloader](https://viralmint.net/tools/video-downloader/linkedin/): feed + creator-page videos for B2B research.
  - [SoundCloud downloader](https://viralmint.net/tools/video-downloader/soundcloud/): mp3 at uploader-bitrate.
  - [Kuaishou downloader](https://viralmint.net/tools/video-downloader/kuaishou/): 快手, the leading-indicator platform for TikTok trends.
  - [Xiaohongshu downloader](https://viralmint.net/tools/video-downloader/xiaohongshu/): RED / 小红书 native-quality mp4.
  - [Lemon8 downloader](https://viralmint.net/tools/video-downloader/lemon8/): ByteDance aesthetic lifestyle content.
  - [Rumble downloader](https://viralmint.net/tools/video-downloader/rumble/): Independent news and alternative voices.
  - [BitChute downloader](https://viralmint.net/tools/video-downloader/bitchute/): Decentralized video platform research.
  - [Odysee downloader](https://viralmint.net/tools/video-downloader/odysee/): LBRY network decentralized content.
  - [Threads downloader](https://viralmint.net/tools/video-downloader/threads/): Meta's emerging text-video platform.
  - [Bluesky downloader](https://viralmint.net/tools/video-downloader/bluesky/): AT Protocol video blobs.
  - [Mastodon downloader](https://viralmint.net/tools/video-downloader/mastodon/): Fediverse instance videos.
  - [Snapchat downloader](https://viralmint.net/tools/video-downloader/snapchat/): Spotlight clips and stories.
  - [Kick downloader](https://viralmint.net/tools/video-downloader/kick/): HD stream replays and clips.
- [AI Caption Generator](https://viralmint.net/tools/ai-caption-generator/): word-by-word ASS captions.
- [AI Voice Generator](https://viralmint.net/tools/ai-voice-generator/): gpt-4o-mini-tts via cloud.
- [AI Music Generator](https://viralmint.net/tools/ai-music-generator/): Lyria 3 Pro via cloud.
- [AI Thumbnail Generator](https://viralmint.net/tools/ai-thumbnail-generator/): Nano Banana 16:9 YouTube thumbnails.
- [YouTube Title Generator](https://viralmint.net/tools/youtube-title-generator/): 10 high-CTR titles per run.
- [Vertical Video Converter](https://viralmint.net/tools/vertical-video-converter/): 16:9 → 9:16 with face-tracking.
- [Silence Remover](https://viralmint.net/tools/silence-remover/): Whisper-detected, FFmpeg-cut.
- [Audio Enhancer](https://viralmint.net/tools/audio-enhancer/): denoise + EBU R128 normalize.
- [AI Script Writer](https://viralmint.net/tools/ai-script-writer/): high-retention video scripts.
- [Video to GIF](https://viralmint.net/tools/video-to-gif/): high-quality social GIFs.
- [Video Speed](https://viralmint.net/tools/video-speed/): change speed with pitch correction.
- [YouTube Keyword Tool](https://viralmint.net/tools/youtube-keyword-tool/): Search Suggest analysis.
- [Video Watermark](https://viralmint.net/tools/video-watermark/): logo/text overlay.
- [AI Video Generator](https://viralmint.net/tools/ai-video-generator/): full text-to-video pipeline.
- [Extract Viral Clips](https://viralmint.net/tools/extract-viral-clips/): one long video → 5-30 ranked shorts.
- [Multi-Platform Export](https://viralmint.net/tools/multi-platform-export/): 9:16 + 1:1 + 16:9 zip bundle.

## Blog

Long-form guides covering AI video creation, YouTube/TikTok growth, video downloading workflows, faceless-channel automation, and Whisper / AI tooling.

- [How to find viral video ideas for YouTube and TikTok](https://viralmint.net/blog/how-to-find-viral-video-ideas-youtube-tiktok/)
- [How to go viral on TikTok in 2026](https://viralmint.net/blog/how-to-go-viral-tiktok-2026/)
- [Free AI video generator guide](https://viralmint.net/blog/free-ai-video-generator-guide/)
- [AI video creation: text-to-video](https://viralmint.net/blog/ai-video-creation-text-to-video/)
- [Free InVideo alternative — open source](https://viralmint.net/blog/free-invideo-alternative-open-source/)
- [vidIQ / TubeBuddy alternative — free](https://viralmint.net/blog/vidiq-tubebuddy-alternative-free/)
- [Faceless YouTube channel automation](https://viralmint.net/blog/faceless-youtube-channel-automation/)
- [Monetize a faceless YouTube channel](https://viralmint.net/blog/monetize-faceless-youtube-channel/)
- [YouTube SEO tips for 2026](https://viralmint.net/blog/youtube-seo-tips-2026/)
- [Video clipping and AI highlights](https://viralmint.net/blog/video-clipping-ai-highlights/)
- [How to run Whisper AI locally](https://viralmint.net/blog/how-to-run-whisper-ai-locally/)
- [Download YouTube videos free](https://viralmint.net/blog/download-youtube-videos-free/)
- [Download TikTok videos with no watermark](https://viralmint.net/blog/download-tiktok-videos-no-watermark/)
- [Download Bilibili videos](https://viralmint.net/blog/download-bilibili-videos/)
- [Download videos from any platform](https://viralmint.net/blog/download-video-any-platform/)
- [Why we built ViralMint](https://viralmint.net/blog/why-we-built-viralmint/)

### German-language guides (de)

- [YouTube Video herunterladen — kostenlos in HD und 4K](https://viralmint.net/blog/youtube-video-herunterladen-kostenlos/)
- [YouTube Musik kostenlos herunterladen — MP3 in voller Qualität](https://viralmint.net/blog/youtube-musik-kostenlos-herunterladen/)
- [TikTok Video herunterladen ohne Wasserzeichen](https://viralmint.net/blog/tiktok-video-herunterladen-ohne-wasserzeichen/)
- [KI Video Generator — KI Video erstellen kostenlos](https://viralmint.net/blog/ki-video-erstellen-kostenlos/)
- [Video schneiden kostenlos — Videobearbeitungsprogramm mit KI](https://viralmint.net/blog/video-schneiden-kostenlos-ki/)

### Simplified Chinese guides (zh-CN)

- [哔哩哔哩下载 / B站视频下载 — 免费高清教程](https://viralmint.net/blog/bilibili-shipin-xiazai/)
- [抖音视频下载 — 去水印高清解析教程](https://viralmint.net/blog/douyin-shipin-xiazai/)
- [YouTube 视频下载 / 油管下载 — 免费高清 4K 教程](https://viralmint.net/blog/youtube-shipin-xiazai/)
- [AI 视频生成 — 免费工具与教程（Sora 2 / Veo 3.1）](https://viralmint.net/blog/ai-shipin-shengcheng/)
- [视频剪辑软件 — 免费桌面应用 + AI 自动剪辑](https://viralmint.net/blog/shipin-jianji-mianfei/)

### Spanish guides (es)

- [Descargar videos de YouTube — Gratis en HD y 4K](https://viralmint.net/blog/descargar-videos-de-youtube/)
- [Descargar música de YouTube — MP3 gratis en alta calidad](https://viralmint.net/blog/descargar-musica-de-youtube/)
- [Convertidor de YouTube a MP4 — Alternativa a Y2mate](https://viralmint.net/blog/convertidor-de-youtube-a-mp4/)
- [Descargar videos de TikTok sin marca de agua](https://viralmint.net/blog/descargar-videos-de-tiktok-sin-marca-de-agua/)
- [Descargar videos de Instagram — Reels y videos](https://viralmint.net/blog/descargar-videos-de-instagram/)
- [Descargar historias de Instagram — Stories y Highlights](https://viralmint.net/blog/descargar-historias-de-instagram/)
- [Editor de video gratis — App de escritorio con IA](https://viralmint.net/blog/editor-de-video-gratis/)
- [Editor de video online gratis vs Desktop — Comparativa](https://viralmint.net/blog/editor-de-video-online-gratis/)

## Capabilities

ViralMint covers the full creator pipeline. The capabilities below are accurate as of 2026-04-27. Auto-upload to YouTube / TikTok is *not* a feature — users download the generated `.mp4` and post manually with the AI-drafted titles, descriptions and tags that ViralMint also produces.

### Trend scouting and competitor analysis (desktop)

- Multi-platform scout: parallel queries to YouTube, TikTok, Douyin, Reddit and Google Trends.
- Virality scoring (0–100) blends engagement rate, recency, views and likes.
- Outlier detection compares each video against its channel's median views — surfacing 3×, 5×, 10× and 20× breakouts.
- Channel analysis: pull a creator's top-N videos, transcribe with Whisper, extract hook / structure / tone with AI.

### Video downloading (desktop)

- yt-dlp under the hood — works for YouTube, TikTok, Bilibili, Twitter/X, Reddit and 1000+ other sites.
- Subtitle fallback when servers rate-limit the subtitle endpoint (Whisper handles transcription regardless).

### Smart Video assembly (desktop)

- Pipeline: AI script → AI voice (gpt-4o-mini-tts or Edge TTS) → Whisper transcription → keyword-matched Pexels stock footage blended with AI-generated b-roll images (Nano Banana / Google Gemini 2.5 Flash Image) → AI music (Lyria 3 Pro) → word-by-word captions → mp4.
- No frame-by-frame AI video generation in v1. Models like Sora 2 Pro, Veo 3.1, Seedance, Hailuo and Wan are NOT used today; they're a roadmap item, not a shipping feature.
- Free at the per-clip stock-footage level (Pexels). Cloud calls for AI script + AI voice + AI music + AI imagery typically run $0.05–$0.10 for a 60-second video.
- Output is unwatermarked mp4 ready to upload to TikTok / YouTube / Reels.

### AI image generation (desktop and web)

- Nano Banana (Gemini 2.5 Flash Image) — single-shot, ~3–10 s, 4 aspect ratios, $0.01 per image.

### AI voice / text-to-speech (desktop and web)

- gpt-4o-mini-tts via OpenRouter — 13 voices including Marin and Cedar — $0.02 per 1,000 characters.
- Edge TTS (free underlying engine, 400+ voices, 100+ languages) on desktop — minimal $0.005 platform fee per generation.

### AI music (desktop and web)

- Lyria 3 Pro via OpenRouter — 12 genres (lo-fi, cinematic, ambient, jazz, EDM, etc.) — $0.12 per song.

### Captions, audio and editing tools (desktop)

- Word-by-word animated ASS captions in three preset styles (viral / classic / bold).
- Background music mixing (FFmpeg amix, –20 dB, fade in/out).
- Modular tools: captions, 16:9 → 9:16 reframe with face-tracking, audio enhance (denoise + EBU R128), watermark, remove silence, voice-over.
- Multi-aspect bundle export (9:16 + 16:9 + 1:1) for cross-posting.

### Cloud backend and account

- AWS serverless backend (Lambda + DynamoDB + Stripe), us-east-1.
- Single account works for both desktop and the web portal; balance and free daily allowance are shared.
- All AI provider keys stay server-side in AWS Secrets Manager. The desktop and the web portal hold no provider keys.
- Per-user daily spend cap (default $30) prevents a compromised token from draining a top-up.

### Model Context Protocol (MCP) integration (desktop)

- Claude Code, Claude Desktop, Cursor and any MCP-aware client can drive the full ViralMint pipeline. Implements all three MCP capability surfaces: **58 callable tools** (macros / scout / acquire / generate / output / single-purpose tools / job orchestration), **9 built-in workflow prompts** plus user-defined CRUD (slash-commands like `/viralmint:create_viral_short`), and **4 read-only resources** (`viralmint://balance` / `recent_videos` / `connected_channels` / `niches`) for grounded session context.
- HTTP Streamable transport mounted at `http://127.0.0.1:16888/mcp/` on the desktop backend. Bearer-token auth; token shown on the dedicated **/mcp page → Setup tab** with copy-paste config snippet for either the Claude Code CLI one-liner or the JSON form (works with Claude Desktop via the `mcp-remote` proxy).
- LLM-friendly tool descriptions, a `wait_for_job(job_id)` helper for multi-step workflows, a `tool_cost_estimate(tool, args)` preview tool so Claude can warn before spending, and a `create_clip_sequence(prompts, model)` macro that generates N AI video clips and stitches them in one call.
- Dedicated /mcp page in the desktop UI with five tabs: Setup, Tools (card grid with search), Prompts (CRUD for user-defined slash-commands), Playground (try any tool from the UI), and Activity (real-time WebSocket-pushed feed of every MCP call with latency + status).

## Pricing

- **Free daily allowance**: refills below a cap each day (no card required, no accumulation beyond the cap).
- **Top-up packs**: $5 Starter (1:1), $30 Pro (+$5 bonus = $35 balance), $100 Max (+$25 bonus = $125 balance) — one-time Stripe payments, no subscription.
- Per-action prices stored in cents on the cloud backend; representative examples (cut on 2026-04-27 to keep margins reasonable while staying creator-friendly): Gemini 2.5 Flash chat $0.005/message, GPT-5.4 Mini chat $0.01/message, Claude Sonnet 4.6 chat $0.03/message, AI image $0.01, OpenAI TTS $0.02 / 1K chars, Edge TTS $0.005/generation, AI music $0.12 / song, budget video clip $0.40, flagship video clip $3.10.

## Technology

- Desktop: Python 3.11 + FastAPI + SQLite (WAL) + faster-whisper + yt-dlp + FFmpeg, packaged with PyInstaller and a pystray tray-icon launcher (system browser is the UI; this is *not* an Electron app).
- Browser portal: Astro + React 18 + MUI 7 islands at `/app/*`, hosted from the same S3 + CloudFront distribution as the marketing pages.
- Cloud: TypeScript Lambdas via Serverless Framework v3, DynamoDB, Stripe one-time payments, OpenRouter as the single AI vendor for chat / image / video / TTS / music.

## Source code

- Desktop + cloud: [github.com/openclaw-easy/ViralMint](https://github.com/openclaw-easy/ViralMint)
- Latest release: [github.com/openclaw-easy/ViralMint/releases](https://github.com/openclaw-easy/ViralMint/releases)
- License: AGPL-3.0 — see [LICENSE](https://github.com/openclaw-easy/ViralMint/blob/main/LICENSE)
- Maintainer: [github.com/openclaw-easy](https://github.com/openclaw-easy)