MrZaKaRiAGit

Podcats

The purr-fect AI podcast generator

Created: 3/23/2026Last pushed: 3/23/2026
Podcats

Overview

The purr-fect AI podcast generator

Tags & Topics
View Source
Podcats Logo

Podcats ๐ŸŽ™๏ธ

The purr-fect AI podcast generator

Convert any PDF into an engaging multi-speaker podcast using Gemini AI

built with ๐Ÿ’œ by @Hoxygo

README: English | Espaรฑol | Franรงais | Deutsch | ็ฎ€ไฝ“ไธญๆ–‡ | ๆ—ฅๆœฌ่ชž | ํ•œ๊ตญ์–ด | ุงู„ุนุฑุจูŠุฉ


โœจ Features

  • ๐Ÿ“„ PDF โ†’ Podcast โ€” Drop any PDF and get a natural two-speaker conversation
  • ๐ŸŒ 12 Languages โ€” Including Saudi Arabic, Egyptian Arabic, UK/US English, and more
  • ๐ŸŽ™๏ธ 5 AI Voices โ€” Male & Female voices with live preview before generating
  • โœ๏ธ Editable Script โ€” Edit the generated script and regenerate audio instantly
  • ๐Ÿ”„ Regenerate โ€” Regenerate audio from edited script, or regenerate the entire podcast
  • ๐ŸŒ— Light & Dark Mode โ€” Follows macOS system preference automatically
  • ๐Ÿ”’ Private & Local โ€” Your Gemini API key is stored on your device only
  • ๐ŸŽ Native Mac App โ€” Runs as a proper macOS app (Apple Silicon + Intel)

๐Ÿ“ฅ Installation

Step 1 โ€” Download (from Releases)

  • Windows: Podcats Setup 1.0.0.exe
  • macOS Apple Silicon: Podcats-1.0.0-arm64.dmg
  • macOS Intel: Podcats-1.0.0.dmg

Step 2 โ€” Install

  • Windows: run the setup EXE, then launch Podcats from the Start Menu.
  • macOS: open the DMG and drag Podcats to Applications.

Step 3 โ€” First Launch Fix โš ๏ธ (macOS only)

Gatekeeper may block the first launch. Run:

sudo xattr -cr /Applications/Podcats.app && open /Applications/Podcats.app

Or use System Settings โ†’ Privacy & Security โ†’ โ€œOpen Anywayโ€. This is one-time; future launches are normal.


๐Ÿ”‘ API Key Setup

  1. Get a free Gemini API key at ai.google.dev
  2. Open Podcats and click "Set API Key" in the top right
  3. Paste your key โ€” it's saved locally on your device and never leaves it

๐Ÿš€ Getting Started (Developers)

git clone https://github.com/Hoxygo/Podcats.git
cd Podcats
npm install
npm run electron:dev   # development
npm run electron:build # build macOS DMG
npm run electron:build:win # build Windows installer (requires Windows runner or wine)

โš ๏ธ First Launch Fix (Windows)

If SmartScreen shows a warning: click More info โ†’ Run anyway (app is unsigned).

โ˜• Support

If you find Podcats useful, you can support the project: ko-fi.com/hoxigo


๐ŸŽ™๏ธ How It Works

PDF Upload โ†’ Gemini 2.5 Flash reads & writes a dialogue script
           โ†’ Gemini TTS generates audio with two distinct voices
           โ†’ WaveSurfer renders the waveform for playback & download

๐ŸŒ Supported Languages

Language Dialect
๐Ÿ‡บ๐Ÿ‡ธ English US American English
๐Ÿ‡ฌ๐Ÿ‡ง English UK British English
๐Ÿ‡ธ๐Ÿ‡ฆ Arabic โ€” Saudi Gulf/Saudi dialect
๐Ÿ‡ช๐Ÿ‡ฌ Arabic โ€” Egyptian Egyptian dialect
๐Ÿ‡ช๐Ÿ‡ธ Spanish Latin American
๐Ÿ‡ซ๐Ÿ‡ท French Standard French
๐Ÿ‡ฉ๐Ÿ‡ช German Standard German
๐Ÿ‡ฎ๐Ÿ‡น Italian Standard Italian
๐Ÿ‡ฏ๐Ÿ‡ต Japanese Standard Japanese
๐Ÿ‡ฐ๐Ÿ‡ท Korean Standard Korean
๐Ÿ‡ง๐Ÿ‡ท Portuguese Brazilian
๐Ÿ‡ท๐Ÿ‡บ Russian Standard Russian
๐Ÿ‡จ๐Ÿ‡ณ Chinese Mandarin

๐Ÿ› ๏ธ Tech Stack

Layer Technology
UI React 19 + Vite + TypeScript
Desktop Electron 36
AI Model Google Gemini 2.5 Flash
Audio Gemini TTS + WaveSurfer.js

๐Ÿ“„ License

MIT ยฉ Hoxygo

Repository Stats

Stars
1
Forks
0
Watchers
1
Size
10.7 MB
LicenseMIT
Issues0 Open