README.md

Minizo is a sleek web app built with Node.js, Express.js, and Vue.js.
Minizo lets users effortlessly browse and manage their music collection and obtain tracks.

Downloading copyrighted content without proper authorization is illegal in most countries and not endorsed. This project is intended for educational purposes only. Please ensure you have the right to download and use the content.

Features

• Browsing by folder: Dive into folders to view the files stored within them.
• File Management: Easily delete or relocate files within your collection.
• Fast search: YouTube Music fast search.
• Grab video: Capture videos from various sources and effortlessly convert them into audio files.
• Authentication: Enable optional basic authentication for the project.
• MusicBrainz: Retrieve metadata from MusicBrainz (token required).
• and much more.

Project background

This project began as a solution to access and manage my audio files beyond my local network, but it grew into something else over time. And now, Minizo is open for everyone to enjoy.

Requirements

• Node.js
• yt-dlp
• ffmpeg
• beets

How to

• Clone down the project git clone git@github.com:mattiasghodsian/Minizo.git
• Install all dependencies npm install and create a new .env file cp .env.example .env and fill in all fields
• Run the project with npm run serve and visit http://localhost:3000

Docker

Nightly releases come with the latest source but are unstable and not recommended for production use.

version: "3"
services:
  minizo:
    image: rakma/minizo:latest
    ports:
      - 3000:3000
    volumes:
      - .env:/srv/.env
      - /home/user/music:/music:rw
    user: 1000:1000
    restart: always

networks:
  default:
    name: minizo
    external: true

Screenshots

CONTRIBUTING

We welcome contributions from the community! Whether you're fixing a bug, adding a new feature, or improving documentation, your help is greatly appreciated.