Instant-Music-Downloader

Instant‑Music‑Downloader is a command‑line tool that retrieves songs based on a user‑provided query such as a title, lyric snippet, or artist name. It searches online sources, downloads the audio as an MP3 file, and can embed basic ID3 metadata including track title, artist, album name, album art, and lyrics. The program relies on youtube‑dl and BeautifulSoup for fetching media and information, and requires libav (or equivalent) to encode the MP3 output.

The utility offers several options: silent mode, prompt suppression, single‑song download, batch download from a comma‑separated list, or processing a file containing one song per line. It is installable via pip for both Python 2.7 and 3.x, with additional system packages needed for libav on macOS, Ubuntu, or Windows. A companion script can repair or add album art after download.

Target users are individuals who want a quick, scriptable way to obtain MP3 copies of songs from the command line, especially when they have only partial information such as lyrics. The project is released under the MIT license and is marked as stable.