{"id":34623971,"url":"https://github.com/wifi-left/bamboo-music-web","last_synced_at":"2026-05-27T10:38:59.795Z","repository":{"id":272108183,"uuid":"915547918","full_name":"wifi-left/bamboo-music-web","owner":"wifi-left","description":"Bamboo Music Website","archived":false,"fork":false,"pushed_at":"2025-07-01T04:26:34.000Z","size":6788,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-05-27T10:38:36.722Z","etag":null,"topics":["music","web"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wifi-left.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-12T06:18:01.000Z","updated_at":"2025-07-01T04:26:37.000Z","dependencies_parsed_at":"2025-01-12T07:29:23.121Z","dependency_job_id":"717e1dc2-4e45-432d-b989-6e229ba11ffb","html_url":"https://github.com/wifi-left/bamboo-music-web","commit_stats":null,"previous_names":["wifi-left/bamboo-music-web"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/wifi-left/bamboo-music-web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wifi-left%2Fbamboo-music-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wifi-left%2Fbamboo-music-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wifi-left%2Fbamboo-music-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wifi-left%2Fbamboo-music-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wifi-left","download_url":"https://codeload.github.com/wifi-left/bamboo-music-web/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wifi-left%2Fbamboo-music-web/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33562772,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["music","web"],"created_at":"2025-12-24T15:43:34.873Z","updated_at":"2026-05-27T10:38:59.788Z","avatar_url":"https://github.com/wifi-left.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bamboo Music Manager\n竹子音乐 - 音乐框架\n\n## 开始使用\n### 初始化设置（需要文件访问权限）\n本框架自带本地API，您可以在 `/apis/cache/location.txt.bamboomusic` 设置地址（若文件不存在，请自行创建此文件。）\n\n格式为：\n```\n地址1\n地址2\n地址3\n```\n\n创建完毕后，您可以访问 `/manager/index.html` 对缓存进行刷新、修改文件夹别名等\n\n您还需要修改 `/static/js/default_settings.js`，将下面代码改为您的api：\n```JavaScript\nconst search_types = [\n    { \"name\": \"音频\", \"id\": \"audio\", \"type\": \"audio\" },\n    { \"name\": \"专辑\", \"id\": \"album\", \"type\": \"playlist\" },\n    { \"name\": \"视频\", \"id\": \"video\", \"type\": \"video\" },\n    { \"name\": \"在线B\", \"id\": \"onlineb\", \"type\": \"audio\" }\n]\n```\n注释：\n1. 这里的ID请尽量不重复，每个ID对应下面的api方法，如搜索提示词：\n   ```JavaScript\n   function get_api_suggest_key(type) {\n       switch (type) {\n           case 'audio':\n           // console.log(type);\n           case 'album':\n               return localUrlRoot + \"local.php?type=suggestKey\u0026value=${KEY}\";\n           case 'video':\n               return videoUrlRoot + \"video.php?type=suggestKey\u0026value=${KEY}\";\n           case 'onlinea':\n               return onlineAUrlRoot + \"suggest.php?value=${KEY}\"\n           case 'onlineb':\n               return onlineBUrlRoot + \"main.php?type=suggestKey\u0026value=${KEY}\"\n       }\n       return localUrlRoot + \"local.php?type=suggestKey\u0026value=${KEY}\";\n   }\n   ```\n   这里 `case` 后面的就是ID名称。\n   注意：每个方法对应的格式不同，详情请参考具体代码。\n2. `name` 为搜索选项提示名称\n3. `type` 为类型，貌似不是必须的？\n4. 如果您没有新的API，可以修改为：\n   ```JavaScript\n   const search_types = [\n       { \"name\": \"音频\", \"id\": \"audio\", \"type\": \"audio\" },\n       { \"name\": \"专辑\", \"id\": \"album\", \"type\": \"playlist\" }\n   ]\n   ```\n\n### 环境搭建\n#### 服务器\n本人在本地测试使用的IIS，您可以自己选择其他工具。\n\n您需要将后缀为 `.bamboomusic` 的文件或者将路径 `apis/cache` 禁止访问，避免私密信息外露。\n\n**本项目可以不用放在网站根目录。**\n\n将 `.php` 后缀绑定为 PHP 的MINE类型后缀，并且与PHP挂钩。\n\n#### PHP环境\n本地环境使用 `PHP 8`，您也可以使用 `PHP 7` 或更高版本。\n\n您应当启用下列PHP扩展：\n```ini\nextension=curl\nextension=fileinfo\nextension=gettext\nextension=mbstring\nextension=exif\nextension=openssl\n```\n\n### 网页端设置\n然后在网页端访问 `manager/index.html`，默认密码为 `admin`，进入管理界面后记得修改密码。\n\n点击 `刷新缓存`，等待刷新成功。\n\n点击 `设置别名`，为你的文件夹设置名称，这将会显示为专辑名称。\n\n设置完毕后点击 `确定` 即可保存。\n\n歌曲文件名形式为 `歌手 - 歌曲名.mp3`\n\n歌词文件名与歌曲相同，仅后缀改为 `.lrc`，如：\n\n`莫文蔚 - 这世界那么多人.mp3`\n`莫文蔚 - 这世界那么多人.lrc`\n\nlrc 请尽量使用 `GB2312` 或者是 `UTF-8`\n\n目前仅支持同一时间段一行歌词（老式歌词，如果要翻译请将翻译行时间设置为下一行的歌词时间），如：\n\n```lrc\n[00:31.40] 愛しき心君が為 永久に咲く花\n[00:39.69] 爱恋之心 只因为你 花朵不绝盛放\n[00:39.69] ほら ゆらゆら 風吹かれ\n[00:43.90] 随风飘摇\n[00:43.90] ほら ふわふわ 舞い上がる\n[00:48.25] 轻然飞舞\n[00:48.25] ほら ひらひら\n[00:50.99] 翩然飞往\n```\n\n### 新增自建 API\n请参考初始化设置修改 `static/js/default_settings.js`\n\n**API请求要求：**\n1. 获取播放链接 `type=url` 的请求返回结果必须是链接（可以是相对链接）\n2. 返回搜索结果结果是多个播放列表的结果需要在JSON根节点写入： `\"type\":\"playlist\"`\n3. 返回搜索结果内容存储在JSON根节点 `data` 内，并且有总数量（可以是 `当前已知数量+1` 代表未知总数，但有下一页），如返回播放列表：\n   ```JSON\n   {\n     \"data\": {\n       \"list\": [\n         {\n           \"name\": \"番剧 《偶像大师 灰姑娘女孩》系列 \u0026 U149\",\n           \"id\": 783,\n           \"pic\": \"./apis/local/cover.php?id=784\"\n         }\n       ],\n       \"total\": 21,\n       \"pic\": null\n     },\n     \"type\": \"playlist\"\n   }\n   ```\n4. 返回内容如果是普通数据，数据必须包含 `id` `artist` `name` `album`，剩下的 `albumid` `artistid` `pic` `releaseDate` `addition` 是可选项目。如：\n   ```JSON\n   {\n     \"data\": {\n       \"total\": 5,\n       \"list\": [\n         {\n           \"id\": 1898,\n           \"addition\": \"\",\n           \"artist\": \"莫文蔚\",\n           \"name\": \"外面的世界\",\n           \"album\": \"其他音乐\",\n           \"albumid\": 1592,\n           \"pic\": \"\",\n           \"artistid\": \"6I6r5paH6JSa\",\n           \"releaseDate\": null\n         },\n         {\n           \"id\": 1899,\n           \"addition\": \"\",\n           \"artist\": \"莫文蔚\",\n           \"name\": \"如果没有你\",\n           \"album\": \"其他音乐\",\n           \"albumid\": 1592,\n           \"pic\": \"\",\n           \"artistid\": \"6I6r5paH6JSa\",\n           \"releaseDate\": null\n         },\n         {\n           \"id\": 1900,\n           \"addition\": \"\",\n           \"artist\": \"莫文蔚\",\n           \"name\": \"盛夏的果实\",\n           \"album\": \"其他音乐\",\n           \"albumid\": 1592,\n           \"pic\": \"\",\n           \"artistid\": \"6I6r5paH6JSa\",\n           \"releaseDate\": null\n         },\n         {\n           \"id\": 1901,\n           \"addition\": \"\",\n           \"artist\": \"莫文蔚\",\n           \"name\": \"这世界那么多人\",\n           \"album\": \"其他音乐\",\n           \"albumid\": 1592,\n           \"pic\": \"\",\n           \"artistid\": \"6I6r5paH6JSa\",\n           \"releaseDate\": null\n         },\n         {\n           \"id\": 1952,\n           \"addition\": \"\",\n           \"artist\": \"黄品源\u0026莫文蔚\",\n           \"name\": \"那么爱你为什么\",\n           \"album\": \"其他音乐\",\n           \"albumid\": 1592,\n           \"pic\": \"\",\n           \"artistid\": \"6buE5ZOB5rqQJuiOq+aWh+iUmg==\",\n           \"releaseDate\": null\n         }\n       ]\n     }\n   }\n   ```\n   解释：\n   1. `id`：音乐播放ID，必须\n   2. `addition`：附加信息，可选\n   3. `artist`：歌手，必须\n   4. `name`：歌曲名称，必须\n   5. `album`：专辑名称，必须\n   6. `artistid`：歌手ID，可选\n   7. `albumid`：专辑ID，可选\n   8. `pic`：图片，需要直链（可以相对链接），可选\n   9. `releaseDate`：出版日期，可选\n   10. `hasMv`：是否有视频，视频ID与音频相同，默认为 `0` 或 `false`。\n   11. `hasAudio`：是否有音频，可选，默认为 `1` 或 `true`。\n5. 提示词 `type=suggest` 返回数据格式应类似于：\n  ```JSON\n  {\n    \"data\": [\n      \"莫文蔚\",\n      \"黄品源\u0026莫文蔚\"\n    ]\n  }\n  ```\n6. 歌曲信息 `type=info` 返回数据应该类似于：\n  ```JSON\n  {\n    \"data\": {\n      \"info\": {\n        \"id\": 808,\n        \"addition\": \"\",\n        \"artist\": \"灰姑娘女孩\",\n        \"name\": \"お願い! シンデレラ\",\n        \"album\": \"番剧 《偶像大师 灰姑娘女孩》系列 \u0026 U149\",\n        \"albumid\": 783,\n        \"artistid\": \"54Gw5aeR5aiY5aWz5a2p\",\n        \"releaseDate\": null,\n        \"pic\": \"http://127.0.0.1/musicnew/apis/local/cover.php?id=784\"\n      },\n      \"lrc\": \"[00:00.05] 作曲 : 内田哲也\\r\\n[00:00.06] 编曲 : 内田哲也\\r\\n[00:00.06]お願い！ シンデレラ\\r\\n[00:03.38]夢は夢で終われない\\r\\n[00:06.  13]不要让梦想停留于想象\\r\\n[00:06.13]動き始めてる 輝く日のために\\r\\n[00:22.76]开始行动吧 为了有朝一日能熠熠生辉\\r\\n[00:22.76]...\"\n    }\n  }\n  ```\n7. 如果要兼容 [MC Bamboo Music 插件（AllMusic Fork）](https://modrinth.com/plugin/allmusic-localapi)，还需要当访问参数`type=status`时，response code为200（内容任意）\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwifi-left%2Fbamboo-music-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwifi-left%2Fbamboo-music-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwifi-left%2Fbamboo-music-web/lists"}