🎬 MediaFetch

A lightweight Python-based command-line tool that helps you fetch and process online media content with ease.
Built using the powerful yt-dlp library, this project demonstrates file handling, external library usage, and media conversion techniques in Python.

---

🚀 Features

• 🎧 Fetch and save media files in high quality
• 🧩 Choose between full media or audio-only format
• 🧠 Automatically checks if FFmpeg is installed before audio conversion
• 📁 Automatically organizes files in a downloads folder
• ⚡ Clean and simple command-line interface

---

🛠️ Requirements

Make sure you have the following installed before running the project:

🐍 Python

Download & install from: https://www.python.org/downloads/

📦 Dependencies

Install the required Python packages using:

pip install yt-dlp ffmpeg-python

🎞️ FFmpeg (for audio conversion)

FFmpeg is required only if you want to fetch audio formats.

If FFmpeg is not installed, the program will automatically show an error message and stop before continuing.

• Windows:
  Download from https://ffmpeg.org/download.html
  After installation, make sure to add FFmpeg to PATH (so it works in Command Prompt).
  You can verify by running:

  ffmpeg -version

• Linux/macOS:

  sudo apt install ffmpeg

  or

  brew install ffmpeg

---

💻 How to Use

1. Clone this repository:

   git clone https://github.com/yourusername/mediafetch.git
   cd mediafetch

2. Run the script:

   python downloader.py

3. Enter the media link when prompted.

4. Choose:

   • (v) → fetch video format
   • (a) → fetch audio format (requires FFmpeg — automatically checked)

5. Wait for the process to complete — your file will appear in the downloads/ folder.

🎉 That’s it! You’ve successfully fetched your media.

---

📂 Folder Structure

MediaFetch/
│
├── downloader.py         # Main Python script
├── downloads/            # Output directory for saved media
└── README.md             # This file

---

🧠 Learning Goals

This project was built to understand:

• Using external libraries (yt-dlp)
• Handling file operations in Python
• Detecting system utilities like FFmpeg
• Command-line interface interaction

---

⚠️ Disclaimer

This tool is developed strictly for educational purposes and personal use only.
It does not promote or encourage unauthorized media downloading or redistribution.

---

❤️ Credits

• yt-dlp for the open-source backend library
• FFmpeg for media processing

---

⭐ If you found this project useful, don’t forget to star the repo and share your feedback!