https://github.com/justagwas/umd
Universal Media Downloader - Download and convert most media videos from a URL into your desired format, such as MP3, MP4, or others.
https://github.com/justagwas/umd
audio-downloader simple-ui video-downloader youtube-downloader yt-downloader yt-to-mp3 yt-to-mp4
Last synced: 2 days ago
JSON representation
Universal Media Downloader - Download and convert most media videos from a URL into your desired format, such as MP3, MP4, or others.
- Host: GitHub
- URL: https://github.com/justagwas/umd
- Owner: Justagwas
- License: apache-2.0
- Created: 2025-06-16T08:22:11.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2026-01-19T15:30:29.000Z (6 months ago)
- Last Synced: 2026-01-19T21:47:17.764Z (6 months ago)
- Topics: audio-downloader, simple-ui, video-downloader, youtube-downloader, yt-downloader, yt-to-mp3, yt-to-mp4
- Language: Python
- Homepage: https://www.justagwas.com/projects/UMD
- Size: 255 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
⚠️ NO LONGER MAINTAINED ⚠️
Check out MediaCrate for the actively maintained version
Universal Media Downloader
Fast. Simple. Reliable.
Download video and audio from over 1,000+ websites with one click.
Features •
Usage •
Preview •
License
---
**Universal Media Downloader (UMD)** is a lightweight Python application for downloading 4K video and audio from over 1,000 websites.
Provide a URL, select your format (MP3 / MP4), and download instantly! Supports platforms like YouTube, Instagram, TikTok, Facebook, Twitter, and many more.
📃 [List of supported sites ](https://github.com/Justagwas/UMD/blob/master/UMD/supportedsites.md)
🔗 This project is a refined and improved fork of the original [Media-Downloader](https://github.com/Justagwas/Media-Downloader).
## Table of Contents
- 📋 [Features](#-features)
- 🧩 [Installation & Usage](#-how-to-use)
- 📦 [Packaging Instructions](#-packaging-instructions)
- ⚠️ [Warnings](#%EF%B8%8F-warnings)
- 📷 [Preview](#-preview)
- 🔗 [Links & Statistics](#-links--statistics)
- 🛑 [Downloaded My Software and Got a Warning?](#-downloaded-my-software-and-got-a-warning) 🛑
- 🚧 [TODO List](#-todo-list)
- 📜 [License](#-license)
---
## 📋 Features
1. **Video Conversion**
Convert online videos to various video formats.
2. **Audio Extraction**
Extract audio from online veos and download in popular audio formats.
3. **Simple Interface**
Enter the URL, choose the format, and download!
4. **Fast and Reliable**
Quick conversions with the best possible results.
__DOWNLOAD__ - The download button downloads whatever it is you wanted the program to download.
__TERMINATE__ - The terminate button kills the program, stopping the download if there was one.
📷 [Check out the preview](#-preview)
---
## ❓ How to Use
### Method 1: Downloading the Program (Precompiled Executable) via Installer
1. **Download via the Installer (RECOMMENDED)**
Visit the [Latest Release](https://github.com/Justagwas/UMD/releases/latest) and download `Universal_Media_Downloader_Setup.exe`,
or click the button below ↓.
[](https://github.com/Justagwas/UMD/releases/latest/download/Universal_Media_Downloader_Setup.exe)
3. **Run the Installer**
Simply double-click the downloaded file to install the app.
4. **Usage**
3.1. **Launch the Application**
Launch the newly downloaded application.
3.2. **Enter the URL**
Paste the online video URL into the input box.
3.3. **Choose Format**
Select your desired format.
3.4. **Download**
Click on the **Download** button to start the process.
Using the installer is essential as it automatically adds the application to the start menu, making it convenient to access at any time.
---
### Method 2: Run the Python Script
1. **Download**
Clone or download the repository as a ZIP file from the latest release:
[](https://github.com/Justagwas/UMD/archive/refs/tags/v1.3.0.zip)
3. **Install Dependencies**
Ensure Python is installed on your system. Then, install the required libraries using the following command:
```bash
pip install -r requirements.txt
```
4. **Run the Script**
Execute the Python script using:
```bash
python UMD.py
```
---
## 📦 Packaging Instructions
Follow these steps to package/build the Python script into an executable using **PyInstaller**:
1. **Extract ZIP**
Extract the downloaded ZIP file into a directory of your choice.
2. **Install PyInstaller**
Open a terminal/command prompt and install PyInstaller (if not already installed):
```bash
pip install pyinstaller
```
3. **Build Using the `.spec` File**
(skip this if you want to do it manually)
Use the provided `.spec` file to replicate the exact settings used during development, run:
```bash
pyinstaller UMD.spec
```
This will generate the executable in the `dist/` folder, using the configurations from the `.spec` file.
4. **Build Without the `.spec` File** (If you prefer to compile manually), run:
```bash
pyinstaller --onefile UMD.py
```
- `--onefile`: Combines all dependencies into a single executable.
6. **Locate the Executable**
After packaging, the executable (`UMD.exe`) will be located in the `dist/` directory.
- **Why** should I build it by using the provided `.spec` file?
- `.spec` is a file that stores all the settings used during development packaging, meaning this is how the executable in releases was built, however, as the user, you are free to do whatever.
---
## ⚠️ Warnings
NOTE that all downloaded files from the application (Video/Audio files) are downloaded to the newly created Media-Downloader folder in the Downloads folder (Downloads/Media-Downloader).
RELEVANT IF YOU USED THE `Universal_Media_Downloader_Setup.exe` TO INSTALL THE PROGRAM.
- **Uninstalling**
You can uninstall the program by navigating to your Windows Settings.
1. Press Win + I.
2. In the Settings search bar, type Programs.
3. Within the suggested selections in the search bar, select "Add or remove programs".
4. In the new window search Universal Media Downloader.
5. Click the 3-Dots Icon next to the application and uninstall.
6. Follow the on-screen pop-up to uninstall the application completely.
If you are unable to find the program within Windows Settings, follow this guide below.
1. Press Win + R.
2. In the pop-up type `%localappdata%\Programs` and press enter (DEFAULT INSTALLATION IS `%localappdata%\Programs` UNLESS YOU'VE CHANGED THIS).
3. Locate the folder named "Universal Media Downloader".
4. Open the folder.
5. Within the folder find a file named `unins000.exe`.
6. Double click that file and follow on screen instructions to uninstall the application.
NOTE (2) that this application stores NO DATA, upon deletion it is completely removed from your system, it is safe to use and downloads ONLY whatever you want it to.
---
## 📷 Preview
---
## 🔗 Links & Statistics
[](https://github.com/Justagwas/UMD/releases/latest)
[](https://github.com/Justagwas/UMD/issues)
[](https://github.com/Justagwas/UMD/graphs/contributors)
[](https://github.com/Justagwas/UMD/releases)
[](https://github.com/Justagwas/UMD/issues)
[](https://github.com/Justagwas/UMD/commits)
---
## 🛑 **Downloaded My Software and Got a Warning?**
Don’t worry! Windows and other operating systems sometimes flag my software simply because it’s not yet widely recognized. Rest assured, **all my software is open source** and completely transparent. You can review the code yourself and decide if you trust it, although it is safe.
You're welcome to verify it at [Virus Total](https://www.virustotal.com/gui/home/upload), or anywhere you'd like.
### 🛠 **What You Can Do:**
1. Double-check if your download is from the [official repository](https://github.com/Justagwas/UMD), or the [official Sourceforge](https://sourceforge.net/projects/umd).
2. If Windows shows a warning, click **More Info** > **Run Anyway** to bypass it.
3. Refer to the ⚠️ [Warnings](#%EF%B8%8F-warnings) section in this repository for any potential risks. If none are listed, there’s nothing to worry about.
---
## ❓ **Got Any Other Questions?**
Check out my [FAQ Page](https://www.justagwas.com/faq) for more answers and details about my projects, safety, and usage guidelines.
---
## 🚧 TODO List
### Discontinued.
---
## 📜 License
[](LICENSE.txt)