usable 是一个功能强大的自托管音乐流媒体服务，提供类似 Spotify 的现代化界面和丰富功能。 默认邮箱：admin@admin.com 密码：admin123 ### 核心特性 ✨ **智能音乐库管理** - 自动扫描和组织音乐文件 - 支持 MP3、FLAC、WAV、M4A、AAC、OGG 等主流格式 - 自动提取专辑封面，支持 YouTube 封面搜索 - 实时文件监控，自动检测新增音乐 🎨 **现代化界面** - Spotify 风格的暗色主题 - 响应式设计，支持移动端访问 - 网格和列表多种浏览模式 - 流畅的动画和过渡效果 🎧 **高级音频播放** - 高品质音频流 - 内置均衡器和多种预设 - 播放队列管理 - 随机播放、循环播放 - 键盘快捷键支持 👥 **社交聆听** - 实时音乐房间 - 和朋友同步听歌 - 房间主持人控制 - 实时歌曲显示 - 公开/私密房间选择 📊 **个人统计** - 播放历史记录 - 最常播放统计 - 最近播放快速访问 - 收藏和关注功能 ### 步骤 1:在**懒猫网盘**中创建 `music` 文件夹并上传音乐： 1. 打开懒猫网盘 2. 创建名为 `music` 的文件夹（如果还没有） 3. 上传你的音乐文件到 `music` 文件夹 ### 步骤 2: 添加音乐库路径 1. 登录 Musable 后，点击左侧菜单的 **"Admin Panel"**（最下方，蓝色高亮） 2. 在顶部标签栏中，点击 **"Library Management"**（🎵 图标） 3. 在 **"Library Paths"** 区域，你会看到一个输入框： ``` Enter library path (e.g., /home/user/Music) ``` 4. 在输入框中输入： ``` /music ``` 5. 点击输入框右侧的蓝色 **"+"** 按钮 6. 路径添加成功后，会显示在路径列表中 > ⚠️ **重要**：必须先添加路径，否则点击 "Scan Library" 会报错： > ``` > Error 500: No library paths configured > ``` ### 步骤 3: 开始扫描音乐库 1. 添加路径后，点击右上角的 **"Scan Library"** 按钮 2. 扫描开始后，你会看到： - 扫描进度条 - 实时扫描日志 - 已发现的歌曲数量 3. 扫描时间取决于音乐数量： - 100 首歌曲：约 30 秒 - 500 首歌曲：约 2-3 分钟 - 1000+ 首歌曲：约 5-10 分钟 4. 扫描完成后，会显示扫描结果： ``` ✅ Scan completed successfully 📊 Songs found: XXX 🎵 Artists: XXX 💿 Albums: XXX ``` ### 步骤 4: 查看扫描历史 在 Library Management 页面下方，你可以查看： - **Scan History**：历次扫描记录 - **扫描时间** - **发现的歌曲数量** - **扫描状态**