Skip to main content

Mashdown will download and split a Youtube mashup video into individual audio files, with documented audio tags.

Warning: For Mashdown to work, the video must come with a tracklist listing the start time and track name for each track. The tracklist can either be in the Youtube description or in a local file. Here is a Youtube video that is a perfect candidate.

Installation

To install Mashdown, you can simply use pip:

$ pip install mashdown

Examples

Downloading and splitting the mashup

$ mashdown \
    --audioformat ogg \
    --album "The Lord of the Rings Sountrack" \
    --artist "Howard Shore" \
    https://www.youtube.com/watch\?v\=upzOSSQWSYU

Splitting a local mashup

In this example, the mashup will not be downloaded. The youtube URL is only used to fetch the tracklist information.

$ mashdown \
    --audioformat ogg \
    --mashupfile path/to/mashupfile
    --album "The Lord of the Rings Sountrack" \
    --artist "Howard Shore" \
    https://www.youtube.com/watch\?v\=upzOSSQWSYU

Usage

usage: mashdown [-h] [-m MASHUPFILE] [–input-audioformat INPUT_AUDIOFORMAT]

[-f AUDIOFORMAT] [-o OUTPUT_DIR] [-q] [–artist ARTIST] [–album ALBUM] url

Split a Youtube mashup video into a list of tagged audio tracks

positional arguments:

url The youtube link to the mashup.

optional arguments:
-h, --help

show this help message and exit

-m MASHUPFILE, --mashupfile MASHUPFILE

The local path, relative or absolute, to the mashup file.

--input-audioformat INPUT_AUDIOFORMAT

The prefered audio format for the source mashup file.

-f AUDIOFORMAT, --audioformat AUDIOFORMAT

The export audio format. Examples: ‘mp3’, ‘ogg’, ‘mp4’, ‘flac’, …

-o OUTPUT_DIR, --output-dir OUTPUT_DIR

The directory in which the output directory will be created.By default, the current directory will be used.

-q, --quiet

Remove non important log messages

metadata:
--artist ARTIST

The artist name

--album ALBUM

The album name

Dependencies

Mashdown is depends on the following libraries:

  • pydub (which requires ffmpeg or avconv to be installed on the system), to cut the video file and export the audio segments

  • pafy, to download the Youtube video and get its metadata

  • mutagen, to edit the audiofile metadata

Releases

0.1.1

  • The track name can be located before or after the track start time

  • Added unit tests

0.1.0

initial release

Metadata

Release files for mashdown 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mashdown 0.1.1
File Size Uploaded
mashdown-0.1.1.tar.gz 6.3 kB Details

Release files / mashdown-0.1.1.tar.gz

Download URL mashdown-0.1.1.tar.gz
Size 6.3 kB
Tags Source
SHA-256 checksum
How to use checksums
33f4a171e78f639fdbe71a10a462931a91bf1b44f982a8615073a6952d4ad476
BLAKE2b-256 checksum
How to use checksums
73e862595ee6747e0f95bc268d972ad4a8905a1a35f87bdb70d468113f215d03
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1.1 This release

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page