rk-youtube-downloader 1.0.0
A Python package for downloading YouTube videos and audio.
Requires Python: >=3.6

# YouTube Downloader Desktop App

A user-friendly Python-based desktop application for downloading videos and audio from YouTube. The app offers a simple interface to save YouTube content in various formats, including video and MP3 audio.

## Features

- **Video Download**: Save YouTube videos in their original format.
- **Audio Download**: Extract audio from YouTube videos and save as MP3 files.
- **Custom Output Path**: Choose the directory to save the downloaded files.
- **Progress Tracking**: Real-time updates on download progress.
- **Open Folder**: Easily navigate to the folder containing the downloaded file.

## System Requirements

- **Operating System**: Windows, macOS, Linux
- **Python Version**: Python 3.6 or higher
- **Dependencies**: 
  - `yt-dlp`
  - `tkinter`
  - `ttkthemes`
  - `ffmpeg` (required for audio conversion)

## Installation

1. **Install Python & Dependencies**:
   - Ensure Python is installed on your system. [Download Python](https://www.python.org/downloads/).
   - Install the required Python packages using pip:
     ```bash
     pip install yt-dlp tk ttkthemes
     ```
   - Ensure `ffmpeg` is installed and accessible from the command line. [Download FFmpeg](https://ffmpeg.org/download.html).

2. **Running the Application**:
   - Save the application script (e.g., `youtube_downloader.py`).
   - Run the script using Python:
     ```bash
     python youtube_downloader.py
     ```

## Usage

1. **Enter Video URL**: 
   - Paste the YouTube video URL into the provided field.

2. **Select Output Path**:
   - Click the "Browse" button to choose a directory, or manually enter the path.

3. **Choose Format**:
   - Select either "Video" or "Audio (MP3)" as the desired format.

4. **Start Download**:
   - Click the "Download" button to begin the download process.

5. **Open Folder**:
   - Once the download is complete, use the "Show in Folder" button to open the directory containing the downloaded file.

## Troubleshooting

- **Invalid URL Error**: Ensure the URL is a valid YouTube link.
- **Download Error**: Check your internet connection and confirm `ffmpeg` is installed.
- **No Audio File Created**: Verify `ffmpeg` is installed and accessible.

## FAQ

- **Can I download playlists?**
  - Currently, the app supports downloading single videos. Playlist support may be added in the future.

- **What audio quality is used for MP3 downloads?**
  - The app extracts audio at the best available quality and converts it to MP3 with a bitrate of 192 kbps.

- **How do I update the app?**
  - Update `yt-dlp` using pip:
    ```bash
    pip install --upgrade yt-dlp
    ```

## License

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

## Acknowledgments

- [yt-dlp](https://github.com/yt-dlp/yt-dlp): A YouTube downloader library.
- [tkinter](https://docs.python.org/3/library/tkinter.html): Standard GUI library for Python.
- [ttkthemes](https://github.com/RedFantom/ttkthemes): Theming library for `tkinter`.

## Developer Information

**Developer**: Rohan Kumar Bhoi  
**Email**: [me.rohanbhoi@gmail.com](mailto:me.rohanbhoi@gmail.com)

**Social Media**:
- **Instagram**: [@ceorohan](https://instagram.com/ceorohan)
- **Twitter**: [@ceorohan1](https://twitter.com/ceorohan1)
- **LinkedIn**: [ceorohan](https://linkedin.com/in/ceorohan)

For further assistance or bug reporting, please contact the developer.