YouTube to MP3 Downloader

A Flask application to download YouTube videos as MP3 files with real-time progress updates.

Table of Contents

• Introduction
• Features
• Installation
• Usage
• Technologies Used
• Contributing
• License
• Contact

Introduction

This project allows users to download YouTube videos as MP3 files by providing a link. The download progress is displayed in real-time using Server-Sent Events (SSE).

Features

• Download YouTube videos as MP3 files.
• Real-time progress updates.
• Simple and intuitive user interface.
• Uses Flask for the web framework.

Installation

To run this application locally, follow these steps:

1. Clone the repository:

   git clone https://github.com/yourusername/youtube-to-mp3-downloader.git
   cd youtube-to-mp3-downloader

2. Create and activate a virtual environment:

   python -m venv venv
   source venv/bin/activate   # On Windows use `venv\Scripts\activate`

3. Install the required dependencies:

   pip install -r requirements.txt

4. Set the Flask secret key (optional):

   export FLASK_SECRET_KEY='your_secret_key'  # On Windows use `set FLASK_SECRET_KEY=your_secret_key`

5. Run the application:

   flask run

Usage

1. Open your web browser and navigate to http://127.0.0.1:5000.
2. Enter the YouTube video URL in the provided input field and submit.
3. The download will start and you will see real-time progress updates.
4. Once the download is complete, a link to download the MP3 file will be provided.

Technologies Used

• Python
• Flask
• yt-dlp
• HTML
• CSS (Bootstrap)

Contributing

Contributions are welcome! Please follow these steps to contribute:

1. Fork the repository.
2. Create a new branch (git checkout -b feature-branch).
3. Make your changes.
4. Commit your changes (git commit -m 'Add some feature').
5. Push to the branch (git push origin feature-branch).
6. Open a pull request.

License

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

Contact

If you have any questions or suggestions, feel free to reach out:

• GitHub: bennie-benjah
• Email: [email protected]