Media Downloader

A powerful, user-friendly application for downloading media content from popular social platforms.

Table of Contents

• Overview
• Key Features
• Supported Platforms
• Installation
  • Windows Installation
  • Linux Installation
• Usage Guide
• Advanced Features
• Troubleshooting
• Contributing
• License
• Disclaimer

Overview

The Media Downloader is a sophisticated, cross-platform application designed to streamline the process of downloading media content from various Media Downloader platforms. Built with Python and featuring a modern, intuitive GUI, this toolkit empowers users to easily archive and manage their favorite online content.

Key Features

• Multi-Platform Support: Seamlessly download content from major Media Downloader sites.
• Customizable Downloads: Choose video quality, audio-only options, and more.
• Bulk Processing: Queue multiple downloads for efficient batch processing.
• User Authentication: Securely log in to platforms like Instagram for expanded access.
• Flexible Save Options: Customize where and how your media is saved.
• Progress Tracking: Real-time updates on download status and progress.
• Error Handling: Robust error management with clear user feedback.

Supported Platforms

• 
• 
• 
• 

Installation

Windows Installation

1. Verify Python installation Open Command Prompt and run:

   python --version

Ensure you have Python 3.6 or higher installed.

2. Install Git (if not already installed)

Download Git from git-scm.com Follow the installation wizard

3. Clone the repository

   git clone https://github.com/MSC72m/media_downloader.git
   cd media_downloader

4. Set up a virtual environment (recommended)

   python -m venv venv
   venv\Scripts\activate

5. Install dependencies

   pip install -r requirements.txt

6. Launch the application

   python -m src.main

7. Quick Launch Setup (Windows)

Create a batch file Create a new file named media_downloader.bat with the following content:

   @echo off
   cd "C:\path\to\media_downloader"
   call venv\Scripts\activate
   python -m src.main

Replace C:\path\to\media_downloader with your actual installation path.

8. Create a shortcut

   Right-click the batch file and select "Create shortcut"
   Move the shortcut to your desired location (Desktop, Start Menu, etc.)
   Optional: Right-click the shortcut, select "Properties", and set an icon

Linux Installation

Follow these steps to install the Media Downloader Toolkit on Linux:

1. Verify Python installation Open a terminal and run:

   python3 --version

Ensure you have Python 3.6 or higher installed.

2. Install Git (if not already installed) For Ubuntu/Debian:

      sudo apt-get update
      sudo apt-get install git

   For Fedora:

     sudo dnf install git

3. Clone the repository

      git clone https://github.com/MSC72m/media_downloader.git
      cd media_downloader

4. Set up a virtual environment (recommended)

      python3 -m venv venv
      source venv/bin/activate

5. Install dependencies

   pip install -r requirements.txt

6. Launch the application

   cd /src
   python main.py

7. Create a desktop shortcut (optional) Create a .desktop file in ~/.local/share/applications/:

   vim ~/.local/share/applications/media_downloader.desktop

   Add the following content (adjust paths as needed): (change /path/to/venv and /path/to/media_downloader/src/main.py /path/to/media_downloader/icon.png to your actual paths to make this work)

   [Desktop Entry]
   Name= media_downloader
   Exec=/path/to/venv/bin/python /path/to/downloader/main.py
   Icon=/path/to/media_downloader/icon.png
   Type=Application
   Categories=Utility;

Usage Guide

Adding Content:

• Paste the media URL into the input field.
• Click "Add" and provide a custom name if desired.
• (Downloading instagram media requires being logged in with the Instagram Login button)

Configuring Options:

• YouTube: Select quality, enable playlist download, or choose audio-only.
• Instagram: Use the "Instagram Login" for authenticated access.
• Set download path

Managing Queue:

• Remove items with "Remove Selected" (you need to select all the string of each link manually with our mouse) or clear all with "Clear All".
• Initiate downloads with "Download All".

Customizing Save Location:

• Access the file browser via "Manage Files".
• Navigate and set your preferred download directory.

Monitoring Downloads:

• Track overall progress via the status label and progress bar.
• Check individual download statuses in the download list.

Advanced Features

YouTube Enhancements

• Quality selection (360p to 1080p)
• Playlist support
• Audio extraction capability

Instagram Capabilities

• Support for posts, reels, and carousels
• Caption preservation

Twitter Integration

• Download images and videos from tweets

Pinterest Functionality

• High-quality image retrieval from pins and boards
• Automated file naming based on pin content

Troubleshooting

Issue	Solution
Network Errors	Check internet connection and retry
Unsupported URL	Verify the URL is from a supported platform
Authentication Failures	Ensure correct login credentials for Instagram
Download Errors	Consult application logs for detailed error messages

Contributing

We welcome contributions! To contribute:

1. Fork the repository.
2. Create a feature branch: git checkout -b feature/NewFeature
3. Commit changes: git commit -m 'Add NewFeature'
4. Push to the branch: git push origin feature/NewFeature
5. Submit a pull request.

License

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

Disclaimer

    The Media Downloader Toolkit is intended for personal use only. 
    Users are responsible for adhering to the terms of service of the respective platforms and all applicable copyright laws. 
    The developers assume no liability for misuse of this software.
    Your Instagram account may be banned if you use this tool for unauthorized purposes or too much usage it is always recommended to use it with caution and create a new account for testing purposes.'