MusicFree

中文 | English

Introduction

A plugin-based, customizable, ad-free music player that currently supports Android and Harmony OS only.

Desktop version is here: https://github.com/maotoumao/MusicFreeDesktop

If you need to stay updated on future developments, you can follow the WeChat official account below; if you have questions, you can leave feedback directly in the issue section or the official account.

For software download methods, plugin usage instructions, and plugin development documentation, please visit https://musicfree.catcat.work.

Note

If you see paid/ad-free/cracked versions on other platforms, they are all fake. This is an open source project to begin with. Please report paid versions directly when encountered;
The software is primarily for personal use, shared to hopefully help those in need; it's a hobby project that will be maintained as much as possible, but daily development time is limited (about half an hour), and it's expected to remain in unstable testing versions for a long time with irregular update frequency. Please use with caution;
Third-party plugins and the data they generate are not related to this software. Please use legally and compliantly, and delete any copyright data that may be generated in a timely manner.
Please do not promote with VIP/cracked version as a gimmick. The example repository is based on public internet API wrappers and filters out all VIP, preview, and paid songs. The example repository will not provide plugins with cracking functionality in the future;
Information about this software will only be actively published in Git repositories and the WeChat official account "一只猫头猫". If you wish to write articles introducing this software, feel free to do so, but please describe truthfully, and please blur the plugin sources when involving the example repository. Don't add unreal features to the software (although I wish it had them); in case of conflicting descriptions, this repository shall prevail.

Project Usage Agreement:

This project is open sourced under the AGPL 3.0 license. Please comply with the open source license when using this project. In addition, please ensure you understand the following additional notes when using the code:

For packaging and redistribution, please retain the code source: https://github.com/maotoumao/MusicFree
Please do not use for commercial purposes; use the code legally and compliantly;
If the open source license changes, it will be updated in this GitHub repository without separate notice.

Caution

👎 Hall of Shame

👎 MusicFree apps on Xiaomi/Huawei/Vivo app stores are not related to this software. They are adware that misappropriates this software's name and logo. Please be cautious to avoid being deceived.

👎 速悦音乐 is based on secondary development of this software, with changes only including built-in plugins, UI modifications, and traffic diversion. It has not complied with this project's open source license and refuses to communicate.

Features

Plugin-based: This software is just a player and does not integrate any music sources from any platform. All search, playback, playlist import and other functions are entirely based on plugins. This means that as long as music sources can be searched on the internet, as long as there are corresponding plugins, you can use this software for search, playback and other functions. For detailed plugin information, please see the Plugin section.
Plugin-supported features: Search (music, albums, artists), playback, view albums, view artist details, import singles, import playlists, get lyrics, etc.
Customizable and ad-free: This software provides light and dark modes; supports custom backgrounds; this software is open sourced under the AGPL license and ~~one star for a deal~~ will remain free.
Privacy: All data is stored locally, this software will not collect any of your personal information.
Lyrics association: You can associate the lyrics of two songs, for example, associate song A's lyrics to song B. After association, both songs A and B will display song B's lyrics. You can also associate multiple songs' lyrics, like A->B->C, so that songs A, B, and C will all display C's lyrics.

Plugins

Plugin Introduction

A plugin is essentially a CommonJS module that satisfies the plugin protocol. The plugin defines basic functions such as search (music, albums, artists), playback, view albums, artist details, import playlists, get lyrics, etc. Plugin developers only need to focus on input and output logic, while pagination, caching, etc. are all handled by MusicFree. This software completes all player functions through plugins. This decoupled design also allows this software to focus on being a feature-complete player. I must say, small and beautiful.

Plugin development documentation can be found here

Please note:

If you are using third-party downloaded plugins, please identify the security of the plugins yourself (basically check that there are no strange network requests; self-written ones are the safest, don't install things from unknown sources) to prevent malicious code damage. This software is not responsible for possible losses caused by third-party malicious plugins.
Plugins may generate certain copyright data unrelated to this software during use. Plugins and any data generated by plugins are not related to this software. Please consider carefully and delete data in a timely manner. This software does not advocate nor will it provide any cracking behavior. You can build your own offline music repository for use.

Plugin Usage

After downloading the app, you just need to install plugins in the sidebar Settings - Plugin Settings. Supports installing local plugins and installing plugins from the network (supports parsing .js files and .json description files; several example plugins have been written: link to this repository, though functionality may not be very complete);

You can directly click "Install plugin from network", then enter https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json and click confirm to install.

For detailed usage instructions with images, please refer to the WeChat official account: MusicFree Plugin Usage Guide, or the website: https://musicfree.catcat.work/usage/mobile/install-plugin.html

Download

Please go to the release page: Link (if you can't open it, you can replace github with gitee). You can also reply "Musicfree" on the WeChat official account.

Q&A

For common issues encountered during use, see here: MusicFree Usage Q&A

For technical exchange/building interesting things together/technical chats, welcome to join the QQ group: 683467814~ (Not a Q&A group)

For casual chat, you can go to QQ Channel~

WIP

If you have new requirements that need discussion, you can leave a message on the WeChat official account backend/submit an issue/or start a topic in discussions.

Support This Project

If you like this project, or hope I can continue maintaining it, you can support me through any of the following ways ;)

Star this project and share it with people around you;
Follow the WeChat official account 👇 or Bilibili 不想睡觉猫头猫 for the latest information;
Follow maotoumao's XiaoHongShu or X. Although I might not update software-related information there, it's still support~

Thanks to the following friends for their recommendations, very surprising and delightful ~~~

Recommendation from 果核剥壳~ https://mp.weixin.qq.com/s/F6hMbLv_a-Ty0fPA_0P0Rg

Recommendation from 小棉袄~ https://mp.weixin.qq.com/s/Fqe3o7vcTw0KDKoB-gsQfg

ChangeLog

Click here

This project is for learning and reference only, open sourced under the AGPL3.0 license; please use this project reasonably in compliance with laws and regulations, prohibited for commercial use.

App Screenshots

The following screenshots are UI examples only. The software does not provide any music sources internally and does not represent actual performance as shown below.