Quick Start Guide

This guide will walk you through the essential steps to get MeTube running and download your first video in just a few minutes.

Step 1: Run MeTube with Docker

Open your terminal and run the following command. This will download the latest MeTube image and start it as a background service.

Make sure to replace /path/to/your/downloads with an actual directory path on your computer. This is where your downloaded videos will be saved.

docker run -d \
  -p 8081:8081 \
  -v /path/to/your/downloads:/downloads \
  ghcr.io/alexta69/metube

MeTube is now running! The service listens on port 8081.

Step 2: Open the Web Interface

Open your web browser and navigate to:

http://localhost:8081

If you are running Docker on a different machine (like a server or NAS), replace localhost with that machine's IP address.

Step 3: Add a Video URL

Find a video you want to download (e.g., from YouTube) and copy its URL. Paste the URL into the input field at the top of the MeTube page.

Step 4: Start the Download

By default, the quality is set to 'Best' and the format to 'Any'. You can leave these as they are for now. Click the Download button.

Your video will be added to the Downloading queue. You'll see its progress, including download speed and estimated time remaining (ETA).

Step 5: Find Your Completed Download

Once the download is finished, it will move from the 'Downloading' section to the Completed section.

Here you can:

  • Click the video title to view the file directly in your browser (if the format is supported).
  • Click the download icon to save the file to your computer.
  • Find the file on your host machine in the directory you specified in Step 1 (/path/to/your/downloads).

That's it! You've successfully downloaded your first video with MeTube.