Skip to main content

A command line utility to download songs from youtube with metadata from different APIs without the need for API-tokens or login.

Project description

SomeDL - Song+Metadata Downloader

This is a simple commandline program to download music with the correct metadata.

This project is under heavy developement, this README will be updated soon.

Usage

Simply type somedl followed by your search query in quotes. You typically find

somedl "Nirvana - Smells like teen spirit"

You can also search by YouTube or YouTube music URL and even by YouTube playlist URL.

Installation

This utility can be installed using pip.

Windows

pip install somedl

or

py -m pip install somedl

This expects you to have ffmpeg already installed as it is a requirement for yt-dlp to convert the audio files to .mp3. You can verify that you have ffmpeg installed by typing ffmpeg in the commandline. You can install ffmpeg either via winget (more info here) or manually by following a tutorial like this one.

Linux

This software is currently not packaged in any packagemanager or third party repo. Use your prefered way to install pythograms, like for example pipx:

pipx install somedl

FAQ

Why does it download the wrong version of the song?

Rarely a "radio version" or similar has more views than the original version, meaning it is the first result that comes up and therefore the song that gets downloaded by SomeDL. Possible ways to get the correct song:

  • Add e.g. "Original" to your search query, for example "Nirvana - Smells like teen spirit original". This might result in the correct song getting downloaded
  • Search for the song on youtube music and download by URL. (IMPORTANT: Always use the link of the original soundtrack! Do not use the music video version, this does not have the correct metadata and audio track, so SomeDL has to search youtube again by artist name and song title, resulting in the same issue)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

somedl-0.1.2.tar.gz (32.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

somedl-0.1.2-py3-none-any.whl (32.1 kB view details)

Uploaded Python 3

File details

Details for the file somedl-0.1.2.tar.gz.

File metadata

  • Download URL: somedl-0.1.2.tar.gz
  • Upload date:
  • Size: 32.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for somedl-0.1.2.tar.gz
Algorithm Hash digest
SHA256 509af651e1124e3d65db241a816e049749060f8ebf5cc8f95403934552c9d880
MD5 116332a2c902cfba6919e59af9eaad97
BLAKE2b-256 27db45f0879c219943276a6566ec7515ee64af1188b7ddd21fe849c3a345019c

See more details on using hashes here.

File details

Details for the file somedl-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: somedl-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 32.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for somedl-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e0696800d9f88a731594935cfa206596091b4a3b7bb152ea49251bb44f917029
MD5 bebe4d2419196ef308043cacf82eab1e
BLAKE2b-256 6bfeb3a274e175cbacf3436aa5d94c20e18ff30416061007aea5b1b5f3733f60

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page