sitanhuang / universalmedialibrary

personal media downloader/manager

Universal Media Library

中文

Dependencies

• yt-dlp
• ffmpeg

Terminology

UMD (Universal Media Descriptor): This term refers to the metadata associated with each media file, including title, author, duration, and a number of online sources for the media. The UMD also indicates whether it should be excluded from library-wide syncing. The library maintains a list of all UMDs, while individual playlists reference UMDs from this library.

Media: Media refers to the source file which is materialized onto the disk through an adapter (e.g., YouTube/YouTube Music/Spotify). A media file can be converted into desired formats, such as audio-only files.

Pipeline

# Installation
npm install
ln -s abs_path_to/index.js /usr/bin/uml

# Create a library at current directory
uml

# Edit uml.ini to verify settings

# Create Playlist
uml playlist --add "name"
# Populate library and playlist with UMDs
# (use --help for advanced options)
uml playlist --populate "name" --query "youtube playlist url" --method "youtube"

# Materialize all UMDs in the library onto disk
uml sync

# Convert media
# (use --help for advanced options)
uml convert --video=false --ext "mp3"