TubeMorph

A desktop YouTube downloader built with Flutter (UI) and Python (backend). Download videos as MP4 or extract audio as MP3/M4A — all from a clean, native Windows app.

---

⬇️ Download (Windows)

→ Download TubeMorphSetup_1.0.0.exe

Just download, run the installer, and you're good. No Python or Flutter required.

Note: Windows may show a SmartScreen warning since the app isn't code-signed. Click "More info" → "Run anyway" to proceed. This is normal for unsigned open-source apps.

---

Features

• Paste a YouTube URL and fetch a video preview before downloading
• Download as MP4 (video) or MP3 / M4A (audio)
• Download queue and history with filters and sorting
• Change your save folder at any time
• Open downloaded files or show them in Explorer directly from the app
• Single .exe installer — installs like any normal Windows app

---

Build It Yourself

Want to modify TubeMorph or build your own version? Here's how the project is structured and how to get it running.

Prerequisites

• Flutter (Windows desktop enabled)
• Python 3.10+
• Inno Setup 6 (optional, for building the installer)

---

Project Structure

YouTubeDownload/
├── tube_morph/          # Flutter app (UI)
├── tubemorph_backend/   # Python backend (pytubefix + FFmpeg)
├── build.ps1            # One-command build script
└── TubeMorph.iss        # Inno Setup installer config

---

Run in Development

1. Start the Python backend:

cd tubemorph_backend
pip install -r requirements.txt
python main.py

2. Run the Flutter app:

cd tube_morph
flutter run -d windows

The Flutter app communicates with the Python backend over a local connection. Both need to be running during development.

---

Build a Release (single .exe installer)

Run the build script from the repo root:

.\build.ps1

This will:

1. Compile the Python backend with PyInstaller
2. Build the Flutter app in release mode
3. Copy the backend into the Flutter output folder
4. Package everything into a single installer using Inno Setup

Your installer will be output to:

installer_output\TubeMorphSetup_1.0.0.exe

If Inno Setup isn't installed, step 4 is skipped. You can still distribute the tube_morph\build\windows\x64\runner\Release\ folder directly.

---

Manually compile the installer

If you want to run just the Inno Setup step:

"C:\Program Files (x86)\Inno Setup 6\ISCC.exe" TubeMorph.iss

Or open TubeMorph.iss in the Inno Setup GUI and click Build → Compile.

---

Requirements

• Windows 10 or 11, 64-bit
• FFmpeg on PATH is optional — required only for MP3 conversion

---

Contributing

Feel free to fork, modify, and build on this. Pull requests are welcome. If you make something cool with it, drop a link in the issues!

---

Created by Roshane Rodney