Skip to content

CoderRony955/MMExD

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

82 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MMExD - MultiMedia Extractor & Downloader

Banner

MMExD is a powerful and versatile command-line tool for Windows, designed to streamline a wide range of multimedia and document-related tasks. Whether you're a content creator, a data archivist, or just someone who needs to manage digital media efficiently, MMExD provides the tools you need to get the job done.

This project is built with Python and leverages powerful open-source libraries like yt-dlp, ffmpeg, and pandoc to provide a seamless and feature-rich experience.

The main motive behind building this tool is to make it easy to perform media and document operations, and other specific operations that are frequently used by office personnel or individuals with similar needs.

Features

  • Media Downloading: Download audio and video from a vast array of websites. Download multiple files concurrently for improved speed.
  • Content Extraction: Extract images from webpages, frames from videos, and metadata from media files.
  • Document Handling: Merge and convert text documents, merge PDFs, and extract text from PDFs.
  • Media Manipulation: Convert between different media formats, enhance media quality, compress files, and even merge audio and video tracks.
  • Security: Encrypt your PDF files with a password for added security.

Installation

MMExD is specifically designed for Windows.

1. Install for Windows (Pre-built Executable)

For the simplest way to use MMExD, download the pre-built ZIP folder by justing clicking here.

  1. Download & Unzip: Download the latest mmexd.zip file. Unzip its contents to a fixed location on your system (e.g., C:\Program Files\MMExD).

  2. Add to Environment Variables:

    • Search for "Environment Variables" in Windows Start Menu and select "Edit the system environment variables".
    • Click "Environment Variables..." button.
    • Under "System variables", find and select the Path variable, then click "Edit...".
    • Click "New" and add the full path to the unzipped mmexd executable folder (e.g., C:\Program Files\MMExD).
    • Click "OK" on all windows to apply the changes.
  3. Verify Installation: Open a new Command Prompt or PowerShell window and type:

    mmexd -h

    You should see the help message for MMExD, indicating a successful installation.

2. Prerequisites: Essential Toolkits (for Local Setup)

Before you can use all of MMExD's features, you need to install some essential third-party tools. We've made this easy with a batch script. This step is required for both pre-built executable and local development setups.

  1. Open a Command Prompt or PowerShell.

  2. Navigate to the root directory of the MMExD project (or where you unzipped the pre-built executable if you're not doing local development).

  3. Run the following command:

    install_toolkits.bat

This script will use the winget package manager to install:

  • FFmpeg: For all media processing tasks (conversion, extraction, etc.).
  • Pandoc & MiKTeX: For document conversion and processing.

The script will check if each tool is already installed before attempting to install it.

3. Project Setup (Local Development)

If you've cloned the repository and want to set up the project locally for development, we use uv for environment and package management.

  1. Make sure you have uv installed. If not, the script will attempt to install it using winget.

  2. In the project's root directory, run:

    setup_uv.bat

This script will:

  • Create a virtual environment in the project folder.
  • Install all the required Python dependencies listed in pyproject.toml.

4. Project Setup (Local Development using pip)

If you prefer to use pip as your Python package manager and want to set up the project locally for development instead of uv, follow these steps:

  1. Clone the repository:
    git clone https://github.com/CoderRony955/MMExD.git

Navigate to project directory.

  1. Create a virtual environment:

    python -m venv .venv
  2. Activate the virtual environment:

    .venv\Scripts\activate.bat
  3. Install dependencies:

    pip install -r requirements.txt
  4. Run MMExD:

    python mmexd.py -h

After these steps, you can run mmexd commands from within your activated virtual environment.

Basic Usage

Once installed, you can use the mmexd command followed by one of the many subcommands. For a full list of commands and their options, please see the USAGE.md file.

Here's a quick example of how to download an audio file:

mmexd getaudio --url "YOUR_VIDEO_URL_HERE"

About

A tool for Multi Media & Document operations that built for specific needs.

Topics

Resources

License

Contributing

Stars

Watchers

Forks