M4.Manager#

A music library manager with a web UI for downloading tracks and albums via yt-dlp. Organise music by artist and album, download from YouTube and many other sites, and keep everything in a simple folder structure (artist → album → MP3s).

Forked from MeTube.

Warning

If you plan to expose m4.manager publically, ensure you have a proper authentication & security methods in place. m4.manager does NOT have built in auth and was originally designed to be local and only public with a proxy authentication method (like Authentik, Authelia, or Keycloak).

Run with Docker#

Image tags: 3rm4zy/m4.manager:latest and 3rm4zy/m4.manager:0.1.0.

docker run -d -p 8081:8081 -v /path/to/music:/downloads 3rm4zy/m4.manager:latest

Replace /path/to/music with your music directory.

Run with Docker Compose#

services:
  m4.manager:
    image: 3rm4zy/m4.manager:latest
    container_name: m4.manager
    restart: unless-stopped
    ports:
      - "8081:8081"
    volumes:
      - /path/to/music:/downloads

Then open http://localhost:8081.

Configuration (environment variables)#

Set these with -e when using docker run, or under environment: in docker-compose.

Storage and directories#

DOWNLOAD_DIR – Music root (artists/albums live here). Default: /downloads
AUDIO_DOWNLOAD_DIR – Audio-only downloads (if different). Default: same as DOWNLOAD_DIR
STATE_DIR – Queue/state files (e.g. .metube). Default: /downloads/.metube
TEMP_DIR – Temp files during download. Default: /downloads

Web server#

HOST – Bind address. Default: 0.0.0.0
PORT – Listen port. Default: 8081
URL_PREFIX – Base path (e.g. when behind a reverse proxy). Default: /

Downloads (yt-dlp)#

MAX_CONCURRENT_DOWNLOADS – Max simultaneous downloads. Default: 3
YTDL_OPTIONS – Extra yt-dlp options (JSON). Default: {}
YTDL_OPTIONS_FILE – Path to JSON file for options. Default: (none)

User and permissions (Docker)#

PUID – Run as this user ID. Default: 1000
PGID – Run as this group ID. Default: 1000
UMASK – Umask for new files. Default: 022
CHOWN_DIRS – Chown download/state dirs to PUID:PGID on start. Default: true

Other#

LOGLEVEL – Log level: DEBUG, INFO, WARNING, ERROR, CRITICAL. Default: INFO
DEFAULT_THEME – UI theme: light, dark, auto. Default: auto

For more options (output templates, HTTPS, public URLs, etc.) the behaviour matches MeTube; see the MeTube wiki and docs for advanced configuration.

Reverse proxy (HTTPS / subpath)#

Run behind NGINX, Caddy, or Apache and set URL_PREFIX if the app is served under a subpath (e.g. /m4-manager/).

Example (NGINX):

location /m4-manager/ {
    proxy_pass http://m4-manager:8081/;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
}

Set in the container: URL_PREFIX=/m4-manager/ (with trailing slash).

License and attribution#

Forked from MeTube (by alexta69). Downloads powered by yt-dlp.

Clone this repository