# 0xhjk/music-dl **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/0xhjk-music-dl).** 4,368 stars · 588 forks · Python · mit ## Links - GitHub: https://github.com/0xHJK/music-dl - awesome-repositories: https://awesome-repositories.com/repository/0xhjk-music-dl.md ## Description Music-dl is a multi-platform music downloader that searches and downloads audio tracks and playlists from Chinese streaming services to local storage. It aggregates results from multiple streaming APIs into a unified list, automatically selecting the highest available bitrate format, including lossless when available, and falling back to 320K or 128K as needed. The tool distinguishes itself by fetching accompanying lyrics and album cover art alongside audio files, and includes a terminal-based interactive player with keyboard shortcuts for pause, skip, and deletion. It supports filtering search results by file size and playback duration, and can route all traffic through HTTP or SOCKS proxies to bypass regional restrictions. Users can search by keyword, download individual songs or entire playlists from URLs, and manage saved files with an integrated player for listening and disk space management. The documentation covers installation and usage through standard Python package management. ## Tags ### Graphics & Multimedia - [Music Downloaders](https://awesome-repositories.com/f/graphics-multimedia/audio-music/music-utilities/music-downloaders.md) — Downloading audio tracks and playlists from streaming services to local storage with metadata and lyrics. - [Lossless Audio Streaming](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-streaming-engines/lossless-audio-streaming.md) — Analyzes available stream formats to automatically select and save the highest bitrate audio file. - [Downloaders](https://awesome-repositories.com/f/graphics-multimedia/audio-music/audio-streaming-engines/lossless-audio-streaming/downloaders.md) — Automatically selecting and saving audio files with the highest available bitrate from stream formats. - [Chinese Streaming Service Downloads](https://awesome-repositories.com/f/graphics-multimedia/audio-music/music-utilities/music-downloaders/chinese-streaming-service-downloads.md) — Downloads matched songs from Chinese streaming platforms to the local filesystem. ([source](https://github.com/0xHJK/music-dl/blob/master/.coveragerc)) - [High-Fidelity Downloads](https://awesome-repositories.com/f/graphics-multimedia/audio-music/music-utilities/music-downloaders/high-fidelity-downloads.md) — Prefers lossless or high-bitrate formats when available, falling back to lower bitrates if the source does not offer them. ([source](https://github.com/0xHJK/music-dl#readme)) - [Multi-Source Music Searches](https://awesome-repositories.com/f/graphics-multimedia/audio-music/music-utilities/music-downloaders/multi-source-music-searches.md) — Searches and downloads music by querying several Chinese streaming platforms simultaneously, aggregating results into one list. ([source](https://github.com/0xHJK/music-dl#readme)) - [Quality-Prioritized Downloads](https://awesome-repositories.com/f/graphics-multimedia/audio-music/music-utilities/music-downloaders/quality-prioritized-downloads.md) — Downloads songs preferring lossless format then falling back to 320K or 128K when higher quality is unavailable. ([source](https://github.com/0xHJK/music-dl/blob/master/README.en.md)) - [Music Content Search](https://awesome-repositories.com/f/graphics-multimedia/music-content-search.md) — Searches for songs across multiple Chinese streaming platforms and returns matching results. ([source](https://github.com/0xHJK/music-dl/blob/master/.coveragerc)) - [Multi-Platform Aggregation](https://awesome-repositories.com/f/graphics-multimedia/music-content-search/multi-platform-aggregation.md) — Aggregates search results from multiple Chinese streaming APIs into a unified list for user selection. - [Multi-Platform Music Keyword Searches](https://awesome-repositories.com/f/graphics-multimedia/music-content-search/multi-platform-music-keyword-searches.md) — Searches multiple Chinese streaming services simultaneously using a song name or artist keyword and returns aggregated results. ([source](https://github.com/0xHJK/music-dl#readme)) - [Playlist Downloaders](https://awesome-repositories.com/f/graphics-multimedia/streaming-distribution/streaming-broadcasting/media-streaming/playlist-aggregators/personal-playlist-managers/audio-playlist-managers/video-playlist-managers/playlist-downloaders.md) — Accepts a direct song link or a playlist URL to fetch all tracks from that source. ([source](https://github.com/0xHJK/music-dl/blob/master/README.md)) - [Built-in Audio Players](https://awesome-repositories.com/f/graphics-multimedia/audio-music/music-utilities/music-downloaders/built-in-audio-players.md) — Starts a built-in player after download completes, supporting pause, skip, and delete controls. ([source](https://github.com/0xHJK/music-dl/blob/master/README.md)) - [Terminal Audio Players](https://awesome-repositories.com/f/graphics-multimedia/audio-music/music-utilities/music-downloaders/terminal-audio-players.md) — Plays downloaded audio files directly from the terminal with keyboard shortcuts for pause, skip, and deletion. ([source](https://github.com/0xHJK/music-dl/blob/master/README.en.md)) - [URL-Based Music Downloads](https://awesome-repositories.com/f/graphics-multimedia/audio-music/music-utilities/music-downloaders/url-based-music-downloads.md) — Downloads a specific song by providing its direct URL from a supported music platform. ([source](https://github.com/0xHJK/music-dl#readme)) - [Terminal Players](https://awesome-repositories.com/f/graphics-multimedia/audio-music/music-utilities/terminal-players.md) — Plays downloaded audio directly in the terminal with keyboard shortcuts for pause, skip, and deletion. ### Web Development - [Metadata Aggregation](https://awesome-repositories.com/f/web-development/api-metadata-generators/metadata-integration-apis/music-metadata-integration/metadata-aggregation.md) — Retrieves synchronized lyrics and cover art from streaming sources alongside the audio download. ### Business & Productivity Software - [Terminal Music Players](https://awesome-repositories.com/f/business-productivity-software/media-downloaders/terminal-music-players.md) — Starts a built-in player after download with keyboard controls for pause, skip, seek, and deletion. ([source](https://github.com/0xHJK/music-dl#readme)) ### Content Management & Publishing - [Music Library Managers](https://awesome-repositories.com/f/content-management-publishing/media-management/audiobook-servers/e-book-servers/comic-book-libraries/personal-library-managers/music-library-managers.md) — Manages saved files with an integrated player for listening, playback controls, and disk space management. ### Data & Databases - [Music Search Filters](https://awesome-repositories.com/f/data-databases/search-result-filtering/music-search-filters.md) — Searching multiple streaming platforms simultaneously and filtering results by file size or duration. ### Mobile Development - [Lyrics and Album Art Downloaders](https://awesome-repositories.com/f/mobile-development/cross-platform-frameworks/flutter/artwork-browsers/artwork-downloaders/lyrics-and-album-art-downloaders.md) — Fetches accompanying lyrics and album cover images alongside the audio file when available. ([source](https://github.com/0xHJK/music-dl/blob/master/README.md)) ### Networking & Communication - [Proxy-Enabled Media Fetchers](https://awesome-repositories.com/f/networking-communication/socks-proxies/proxy-enabled-media-fetchers.md) — Routes all search and download traffic through HTTP or SOCKS proxies to bypass regional restrictions. ### Security & Cryptography - [Media Size and Duration Limits](https://awesome-repositories.com/f/security-cryptography/request-size-limiters/media-size-and-duration-limits.md) — Restricts displayed songs to those meeting user-specified file size or playback length criteria. ([source](https://github.com/0xHJK/music-dl#readme)) - [Search Result Filters](https://awesome-repositories.com/f/security-cryptography/request-size-limiters/media-size-and-duration-limits/search-result-filters.md) — Restricts search results and downloads based on user-specified file size and playback length criteria.