# ytmdl

A simple app to get songs from YouTube in mp3 format with artist name, album name etc from sources like iTunes, Spotify, LastFM, Deezer, Gaana etc.

Repository: https://github.com/deepjyoti30/ytmdl
Canonical: https://ross.abutalabs.com/products/ytmdl
Homepage: https://ytmdl.deepjyoti30.dev
Language: Python
License: MIT
License Family: permissive
Topics: songs, youtube, metadata, itunes, mp3, id3, gaana, youtube-dl, ffmpeg, cli, song-download, free-software, spotify, apple-music-api, apple-music, music-bot, music, freemusic, high-quality-music, no-ads
Last push: 2024-08-15T09:11:15+00:00
Link (homepage): https://ytmdl.deepjyoti30.dev

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3003, "days_push": 748, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3529, forks 177 (observed 2026-08-28T04:08:08.862187+00:00)

## What it is
ytmdl is a Python CLI tool (with an optional web app) that downloads songs from YouTube as MP3s and enriches them with metadata like artist, album, and cover art from sources such as iTunes, Spotify, LastFM, Deezer, and Gaana. It uses youtube-dl for audio extraction and ffmpeg for conversion, writing ID3 tags automatically.

## Use cases
- download songs from youtube as mp3 with proper tags
- add artist and album metadata to downloaded music
- fetch song info from itunes or spotify automatically
- build a tagged offline music library from youtube
- download high quality mp3s without ads
- batch download music with cover art and release date

## When to choose
- you want tagged MP3s from YouTube, not raw audio files
- you prefer a CLI workflow over sketchy download sites
- you need metadata from multiple music sources like iTunes, Spotify, or Gaana

## When to avoid
- you need video downloads, not audio-only
- you want a GUI desktop music manager
- downloading copyrighted music may be illegal in your jurisdiction

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, web-scraping, audio-processing, search-engine
- domain: media, developer-tools
- platform: windows, python, cli
- tags: youtube-downloader, mp3, id3-tags, music-metadata, youtube-dl, ffmpeg, itunes, spotify, lastfm, deezer, gaana, web-app, command-line, linux, macos, web-server

## Member repositories
- deepjyoti30/ytmdl (main) score 23
- deepjyoti30/ytmdl-web-v2 (frontend) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:08.862187+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:35:07.062620+00:00, confidence not recorded.
  - readme: https://github.com/deepjyoti30/ytmdl (fetched 2026-08-28T04:08:08.862187+00:00, sha f416880a78fb)
  - homepage: https://ytmdl.deepjyoti30.dev (fetched 2026-08-29T09:29:26.406152+00:00, sha cf908272214a)
  - registry_pypi: https://pypi.org/pypi/ytmdl/json (fetched 2026-08-29T09:29:26.415169+00:00, sha 59e44cc80646)
- Data as of 2026-08-30T08:39:29.467469+00:00.