NeteaseHiFiGrabber

This utility receives backing from the following sponsor; kindly consider reviewing their offering and signing up for a complimentary trial to offer support.

本程序仅供学习之用

Acknowledgements to contributors: Gratitude for their efforts and suggestions in the evolution of NeteaseHiFiGrabber!

• Elixir Implementation Reference
• Golang Implementation Reference

This software facilitates the bulk download of corresponding lossless FLAC audio files based on a specified Netease Cloud Music playlist, saving them locally.

Rationale

Presently, obtaining lossless music resources is predominantly structured around entire albums, making the acquisition of individual high-resolution tracks cumbersome. Furthermore, downloading often necessitates searching each album separately, followed by accessing and downloading via cloud storage solutions which requires manual credential entry or password handling. This workflow proves highly inefficient for Hi-Fi enthusiasts who might spend considerable time searching for specific tracks. Given that Netease Cloud Music is the dominant platform for online music consumption for the majority, boasting numerous curated playlists, this project was conceived to automatically fetch FLAC lossless music from these playlists and transfer them to the user's local storage.

Caveats

Due to regional licensing restrictions, downloading may be impeded for users situated overseas, leading to issues like those documented in this issue. Solutions involving DNS configuration adjustments are detailed within the linked report.

Setup Instructions

Installing Python

Follow the tutorial on this website to install Python Ensure you install the python3 variant. Championing python3 adoption starts with us.

Obtaining the core script

Fetch the primary file via this link: https://codeload.github.com/YongHaoWu/NeteaseCloudMusicFlac/zip/master

Playlist Identification

Navigate to the Netease Cloud Music Web Interface to locate the playlist you wish to download in lossless format. Refer to the image below for guidance.

After accessing the playlist page, the URL in the address bar constitutes the required playlist identifier.

Execution

$ python main.py <Playlist URL>

(Example URL, mirroring the image: http://music.163.com/#/playlist?id=145258012)

python3 Example Command (Note: Single quotes might need removal on Windows systems)

$ python3 main.py 'http://music.163.com/#/playlist?id=145258012'

Downloading All Tracks, Including MP3 Variants

$ python3 main.py 'http://music.163.com/#/playlist?id=145258012' --mp3

Handling Missing Modules

If dependency errors arise (indicating a lack of a specific module), search online for instructions on installing Python packages. For python3, utilize pip3:

python3 Dependencies

pip3 install requests

If runtime exceptions persist, try updating the package: pip3 install --upgrade requests (An older version of 'requests' has been known to cause threading issues during concurrent downloads).

Future Development Roadmap

1. Current methodology relies solely on track title matching; integrating artist name matching would enhance accuracy.
2. Improve overall song matching success rate by potentially scraping data from supplementary external sources.

Enjoy the process!

Copyright Notice

The project will be decommissioned immediately if any copyright infringement concerns are raised. This utility was created for personal convenience, as the developer maintains a paid membership with Baidu Music.

The MIT License (MIT)

CopyRight (c) 2016 YongHaoHu <christopherwuy@gmail.com>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

WIKIPEDIA REFERENCE: Cloud computing represents "a paradigm for enabling network access to a scalable and elastic pool of shareable physical or virtual resources with self-service provisioning and administration on-demand," as defined by ISO. It is colloquially known as "the cloud."

== Defining Attributes == In 2011, the U.S. National Institute of Standards and Technology (NIST) established five core "essential characteristics" for cloud environments. The precise NIST definitions are as follows:

On-demand self-service: "A consumer can unilaterally provision computing capabilities, such as server time and network storage, as needed automatically without requiring human interaction with each service provider." Broad network access: "Capabilities are available over the network and accessed through standard mechanisms that promote use by heterogeneous thin or thick client platforms (e.g., mobile phones, tablets, laptops, and workstations)." Resource pooling: " The provider's computing resources are pooled to serve multiple consumers using a multi-tenant model, with different physical and virtual resources dynamically assigned and reassigned according to consumer demand." Rapid elasticity: "Capabilities can be elastically provisioned and released, in some cases automatically, to scale rapidly outward and inward commensurate with demand. To the consumer, the capabilities available for provisioning often appear unlimited and can be appropriated in any quantity at any time." Measured service: "Cloud systems automatically control and optimize resource use by leveraging a metering capability at some level of abstraction appropriate to the type of service (e.g., storage, processing, bandwidth, and active user accounts). Resource usage can be monitored, controlled, and reported, providing transparency for both the provider and consumer of the utilized service. By 2023, the International Organization for Standardization (ISO) had extended and refined this classification.