Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/miriswisdom/albumin
Download, extract & curate songs from YouTube album videos in your favourite audio format.
https://github.com/miriswisdom/albumin
audio flac mp3 music ogg opus vorbis youtube youtube-dl
Last synced: about 1 month ago
JSON representation
Download, extract & curate songs from YouTube album videos in your favourite audio format.
- Host: GitHub
- URL: https://github.com/miriswisdom/albumin
- Owner: MirisWisdom
- License: gpl-2.0
- Created: 2021-09-28T07:49:23.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-07-25T14:32:00.000Z (5 months ago)
- Last Synced: 2024-07-25T16:46:43.944Z (5 months ago)
- Topics: audio, flac, mp3, music, ogg, opus, vorbis, youtube, youtube-dl
- Language: PHP
- Homepage:
- Size: 1.23 MB
- Stars: 10
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: COPYING
Awesome Lists containing this project
README
YouTube.Albumin
Split YouTube videos into songs, all tagged and in your favourite audio format.
Albumin Web GUI
•
Download Latest CLI
## Introduction
This project allows you to split long YouTube videos into separate songs! You can tag them with metadata and encode them in your preferred audio format.
At the moment, the project consists of two components:
- The offline CLI (Command Line Interface) program that downloads and splits up the YouTub video for you; and
- The online Web UI which lets you specify the song information and start/end times within a YouTube video.
## Features
- Encodes a long video's audio into separate audio tracks
- Support for FLAC, MP3, Vorbis, Opus and AAC encoding formats
- Tagging abilities (title, album, artist(s), comment, genre, etc.)
- Downloading using YouTube-DL, or using an existing video file
- Embedded cover art, using thumbnails derived from the provided video, or using an existing image
- Batch processing of multiple album videos from YouTube or local videos
- Song information can be read from a file, or from a YouTube video's chapters/timeline
- Optional lossless splitting of the video's original audio, without any re-encoding whatsoever
## Usage
To make things simpler, give the [Web GUI a try here](https://albumin.miris.design/)! It will let you organise your tracks (or use other people's existing records).
Simply double click on Albumin, and specify the ID that the Web GUI will give you.
For advanced instructions, please refer to the [USAGE](./USAGE.md) document. Linux users may have to run `./albumin` through the terminal to see the wizard.
## Installation
Download [the latest release from here](https://github.com/MirisWisdom/Albumin/releases/latest), and also make sure you have the dependencies you need installed. See below for further information!
## Dependencies
Download whichever dependency you need for your use-case:
- [`yt-dlp`](https://github.com/yt-dlp/yt-dlp) for downloading videos (`youtube-dl` can also be used)
- [`ffmpeg`](https://www.ffmpeg.org/) for audio & cover art extraction
- [`lame`](https://lame.sourceforge.net/) for MP3 encoding w/ metadata
- [`flac`](https://xiph.org/flac/) for FLAC encoding w/ metadata
- [`oggenc`](https://www.xiph.org/vorbis/) for Vorbis encoding w/ metadata
- [`opusenc`](https://wiki.xiph.org/Opus-tools) for Opus encoding w/ metadata
- [`ffmpeg`](https://www.ffmpeg.org/) for AAC encoding w/ metadata
If you need to specify a dependency's executable to the program, do it like so:
```shell
./albumin \
# records file
--album '~/album.txt' \
# paths to dependencies
--ffmpeg "c:\\ffmpeg.exe" \
--flac '/bin/flac' \
--youtube-dl ~/yt-dlp \
# mass fill with optional metadata
--genre "OP/ED/IN/IM" \
--artist "Various" --artist "Artists" \
--comment 'Very Important Music'
```