MusicFree音樂播放器用起來更加的個性化，您可以自由的添加各種js插件，使得您的播放器變得更加強大，作者默認就制作了很多插件，您可以參考下方的教程進行安裝！

MusicFree官方簡介

一個插件化、定制化、無廣告的免費音樂播放器，目前只支持Android和Harmony OS。

MusicFree安卓客戶端特色

插件化：本軟件僅僅是一個播放器，本身并不集成任何平臺的任何音源，所有的搜索、播放、歌單導入等功能全部基于插件。這也就意味著，只要可以在互聯網上搜索到的音源，只要有對應的插件，你都可以使用本軟件進行搜索、播放等功能。關于插件的詳細說明請看插件一節。

歌詞關聯：你可以把兩首歌的歌詞關聯起來，比如將歌曲A的歌詞關聯到歌曲B，關聯后A、B兩首歌都將顯示歌曲B的歌詞。你也可以關聯多首歌的歌詞，如A->B->C，這樣A、B、C三首歌都將顯示C的歌詞。

定制化、無廣告：本軟件提供了淺色、深色模式；支持自定義背景；本軟件基于GPL協議開源，一個star做交易 將會保持免費。

插件支持的功能：搜索（音樂、專輯、作者）、播放、查看專輯、查看作者詳細信息、導入單曲、導入歌單、獲取歌詞等。

隱私：所有的數據都存儲在本地，本軟件不會收集你的任何個人信息。

插件使用教程

下載app之后，只需要在側邊欄設置-插件設置中安裝插件即可。支持安裝本地插件和從網絡安裝插件（支持解析。js文件和。json描述文件；已經寫了幾個示意的插件：指路這個倉庫，不過可能功能不是很完善）； 你可以直接點擊從網絡安裝插件，然后輸入MusicFree音樂源https://gitee.com/maotoumao/MusicFreePlugins/raw/master/plugins.json ，點擊確認即可安裝。

常見問題

遇到“播放一首歌就停止”的情況？

檢查一下系統設置中 “后臺運行” 權限是否打開；如果是未授予權限，打開權限后重啟app應該就好了

音樂下載路徑在哪里？

Android/data/fun.upup.musicfree/files/download/music

本地音樂導入之后為空？

1. 可能沒有給讀取存儲的權限

2. 目前導入本地音樂只支持mp3格式

歌曲id是什么？

點擊歌曲詳情按鈕，拉起歌曲詳情浮層，第一行就是歌曲id，點擊即可復制。

插件怎么找？

目前已有的插件都是自己寫的，可以參考這個倉庫：

https://github.com/maotoumao/MusicFreePlugins；你也可以按照插件開發文檔（待補充）自行開發任意源的插件。

插件能不能搜索VIP音樂 / 支持xxx軟件？

上述倉庫下的插件為示例插件，本質上只是基于網絡公開的接口做的封裝；沒有任何VIP破解/收費音樂破解/軟件解包的功能，并且會過濾掉VIP/僅供試聽的音樂。以后也不會提供破解相關功能。

為什么插件只有部分源有導入功能？

插件沒寫完整，后續補充完整之后直接在側邊欄更新即可。

為什么導入某源的歌單后，提示“目標歌單為空”？

1. 部分源的默認歌單不支持導入，可以先復制到新歌單，再導入新歌單即可；

2. 導入時有一些隱含規則，歌單URL滿足特定正則時可以正常導入（后續完善插件規則就好了）；如果遇到這種情況，可以升級對應軟件的客戶端版本嘗試一下

選擇音質、導入無損音樂？

導入無損音樂暫時有點問題，在改了在改了。音質相關，會盡快完善插件協議。

是否收費/有收費計劃？

開源項目，僅供學習參考使用，始終會保持免費。請不要用于任何商業用途，使用過程中可能產生的版權數據與app無關，請及時自行刪除。

更新日志

v0.2.1

【功能】支持webdav備份&播放

【功能】插件榜單詳情支持分頁

【功能】插件支持顯示作者

【功能】側邊欄新增“權限管理”設置

【功能】首頁&歌詞頁樣式改版：新增歌詞進度調整、歌詞大小調整、歌詞翻譯、自動搜索歌詞

【功能】新增收藏歌單功能

【功能】音樂播放欄支持左右滑動切歌（可能會閃一下，后續修掉）

【功能】新增“通知欄顯示關閉按鈕”設置

【優化】統一浮層、toast樣式

【優化】重構播放、數據存儲邏輯

【優化】去除插件url必須以.js結尾的限制

【修復】修改無限列表到底不觸發onendreached的問題(感謝@282931)

【修復】修復播放記錄退出后被清空的問題

【修復】修復標題欄背景色透明度不生效的問題

【修復】修復部分情況下深色模式異常的問題

v0.1.2

【功能】新增桌面歌詞功能，可在設置頁開啟（開啟之前需要去手機設置授予懸浮窗權限）

【功能】新增插件設置：打開軟件時自動更新插件、安裝插件時不校驗版本

【功能】新增播放設置：打開軟件時自動播放歌曲

【功能】可以使用musicfree打開本地.js或.mp3文件；其中.js文件會被當作插件安裝；.mp3文件會直接播放

【功能】插件頁新增開關，可以控制是否在榜單、熱門歌單、搜索結果中展示對應插件的結果

【功能】插件協議新增“用戶變量”，可以在插件中獲取app輸入的配置（可以由此實現自建音樂源的插件/webdav源插件，但是還沒寫）

【優化】下載單曲支持選擇音質

【優化】側邊欄新增“返回桌面”按鈕

【優化】新增“關聯歌詞方式”設置，如果設置為“輸入歌曲id”，則會恢復老版本關聯歌詞，即輸入id關聯歌詞

【修復】修復榜單、推薦歌單、搜索歌詞頁白屏閃退的問題(感謝@282931)

【修復】修復自定義背景模糊度和透明度無法設置為0的問題(感謝@282931)

【修復】修復無法恢復桌面版導出的歌單的問題

【修復】修復淺色主題狀態欄表現錯誤的問題

【修復】修復歌單批量編輯無法刪除的問題

v0.1.0-alpha.1

【功能】插件更新，升級到新版本之后原有插件完全不兼容；更新后卸載原有插件，然后更新訂閱即可（具體看公眾號示例）

【功能】重寫了插件訂閱的邏輯，現在應該會更合理一點點

【功能】刪除本地文件之前增加二次確認提醒

【功能】新增功能“倍速播放”

【功能】增加了一些無關緊要的分享

【樣式】換了個logo，丑的更直白一些

【樣式】專輯描述文字默認6行，點擊可以展開或折疊

【樣式】調整了一些樣式（如播放頁的模糊和透明度、歌詞樣式等）

【修復】修復部分情況下無法下載的問題

【插件】大量插件有更新，更新到此版本后更新訂閱即可