Skip to main content

Professional Knowledge Hub - Capture, organize, and discover knowledge from videos, PDFs, and documents

Project description

Whisper Scribe

YouTube video transcription using OpenAI Whisper with a beautiful web interface.

Features

  • Simple Web Interface - Clean, modern UI with real-time progress tracking
  • YouTube Support - Just paste any YouTube URL to transcribe
  • AI Analysis - Get summaries, key takeaways, and topic extraction
  • Translation - Translate transcriptions to 12+ languages
  • Multiple Export Formats - Download as TXT, SRT, or VTT subtitles
  • Batch Processing - Queue multiple videos for transcription
  • History - Browse and search your past transcriptions
  • Automatic Chunking - Handles long videos by splitting audio automatically

Installation

pip install whisper-scribe

Prerequisites

  • Python 3.9 or higher
  • FFmpeg (required for audio processing)
  • OpenAI API key

Installing FFmpeg

macOS:

brew install ffmpeg

Ubuntu/Debian:

sudo apt update && sudo apt install ffmpeg

Windows: Download from ffmpeg.org or use:

choco install ffmpeg

Quick Start

  1. Start the server:

    whisper-scribe
    
  2. Open your browser: The app will automatically open at http://localhost:8000

  3. Configure your API key: Click the Settings icon and enter your OpenAI API key

  4. Transcribe: Paste a YouTube URL and click Transcribe!

Command Line Options

whisper-scribe --help                 # Show all options
whisper-scribe --port 9000            # Use custom port
whisper-scribe --host 0.0.0.0         # Listen on all interfaces
whisper-scribe --no-browser           # Don't open browser automatically
whisper-scribe --reload               # Enable auto-reload (development)

Configuration

Settings are saved in ~/.whisper-scribe/config.json:

  • OpenAI API Key: Required for transcription and AI analysis
  • Output Directory: Where transcription files are saved (default: ~/.whisper-scribe/transcriptions/)

AI Features

Analysis

After transcription, click "Analyze with AI" to get:

  • Summary - A concise overview of the video content
  • Key Takeaways - The main points and insights
  • Topics - Main themes discussed in the video

Analysis responses are in the same language as the original video.

Translation

Translate your transcriptions to:

  • English, Spanish, French, German, Italian, Portuguese
  • Russian, Japanese, Chinese, Korean, Arabic, Hindi

API

Whisper Scribe exposes a REST API at /api:

  • POST /api/transcribe - Start a transcription job
  • GET /api/status/{job_id} - Check job status
  • GET /api/result/{job_id} - Get transcription result
  • POST /api/analyze/{item_id} - AI analysis
  • POST /api/translate/{item_id} - Translation
  • GET /api/history - List past transcriptions
  • GET /api/export/{item_id} - Export in various formats

License

MIT License - see LICENSE for details.

Author

Created by Issam Alameh

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

whisper_scribe-4.0.0.tar.gz (194.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

whisper_scribe-4.0.0-py3-none-any.whl (211.1 kB view details)

Uploaded Python 3

File details

Details for the file whisper_scribe-4.0.0.tar.gz.

File metadata

  • Download URL: whisper_scribe-4.0.0.tar.gz
  • Upload date:
  • Size: 194.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for whisper_scribe-4.0.0.tar.gz
Algorithm Hash digest
SHA256 cb36b78fe580923c8f0bef902757b8ec5ff912147df2f868a2f6304fe6615830
MD5 1d89b90bb3c0c1c4b39a97652064d39d
BLAKE2b-256 289f884c28e4bbc0e7fe985f0e47629d26a48c8b88da2c4bbe680effb4666f34

See more details on using hashes here.

File details

Details for the file whisper_scribe-4.0.0-py3-none-any.whl.

File metadata

  • Download URL: whisper_scribe-4.0.0-py3-none-any.whl
  • Upload date:
  • Size: 211.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for whisper_scribe-4.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 20d51490e38dbb4cb1f2d5a35e1c54247a48bb4d5fbee8eeb6b0d9ac1aeabc52
MD5 abff7e2e45fe4b16ca0219f75b12deaf
BLAKE2b-256 52cb56fa49bd9c78b37c8e3081a55931474ffcc9e76355084df17228d468a4cc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page