ytdebunk 1.0.1

A CLI tool to download audio from a YouTube video, transcribe it, and refine the transcription using AI.

ytdebunk

Overview

ytdebunk is a command-line tool designed to:

• Download audio from YouTube videos.
• Transcribe the audio content.
• Optionally enhance the transcription using the Gemini API.

This tool is particularly useful for analyzing transcriptions to identify logical fallacies and incorrect claims made by YouTubers.

Installation

For avoiding conflicts better create a virtual environment and start working on it:

python3.11 -m venv .venv
source .venv/bin/activate

Now, you can install from PyPI using,

pip install ytdebunk

Alternatively, for latest updated please try installing directly from Github using:

pip install git+https://github.com/hissain/youtuber-debunked.git

Usage

The ytdebunk.py script provides a command-line interface (CLI) with several options.

Arguments

• video_url (str) – URL of the YouTube video to download audio from.

Options

Option	Description
-e, --enhance (bool)	Enhance the transcription using the Gemini API. (Default: False)
-o, --output_file (str)	Path to save the final transcription. (Default: downloads/transcription.txt)
-v, --verbose (bool)	Increase output verbosity.
-t, --token (str)	API token for the Gemini API (Required if --enhance is enabled).

Example Usage

ytdebunk "https://www.youtube.com/watch?v=example" -e -o output.txt -v -t YOUR_GEMINI_API_TOKEN

export GEMINI_API_TOKEN="your_api_key"
ytdebunk "https://www.youtube.com/watch?v=example" #when Gemini API key is in environment

Environment Variables

If preferred, you can set the Gemini API token as an environment variable instead of passing it as a CLI argument:

export GEMINI_API_TOKEN="your_api_key"

Detailed Process

1. Download Audio

   • Uses the download_audio function from ytdebunk.downloader to download audio from the given YouTube URL.

2. Transcribe Audio

   • Uses the transcribe_audio function from ytdebunk.transcriber to generate a text transcription.

3. Enhance Transcription (Optional)

   • If --enhance is enabled, the script uses enhance_transcription from ytdebunk.refiner to refine the transcription using the Gemini API.
   • The API token must be provided via --token or as an environment variable.

4. Save Transcription

   • The final transcription (raw or enhanced) is saved to the specified output file.

Error Handling

• If --enhance is enabled but no Gemini API token is provided, the script prints an error message and exits.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contribution and Contact

You can Contact to the author [e-mail]