<img src="https://yellow-cdn.veclightyear.com/835a84d5/80fd7fd2-052d-409b-bf9d-2c4168112e50.png" alt="标志" title="feishin" align="right" height="60px" />

Feishin

<p align="center"> <a href="https://github.com/jeffvli/feishin/blob/main/LICENSE"> <img src="https://img.shields.io/github/license/jeffvli/feishin?style=flat-square&color=brightgreen" alt="许可证"> </a> <a href="https://github.com/jeffvli/feishin/releases"> <img src="https://img.shields.io/github/v/release/jeffvli/feishin?style=flat-square&color=blue" alt="发布"> </a> <a href="https://github.com/jeffvli/feishin/releases"> <img src="https://img.shields.io/github/downloads/jeffvli/feishin/total?style=flat-square&color=orange" alt="下载量"> </a> </p> <p align="center"> <a href="https://discord.gg/FVKpcMDy5f"> <img src="https://img.shields.io/discord/922656312888811530?color=black&label=discord&logo=discord&logoColor=white" alt="Discord"> </a> <a href="https://matrix.to/#/#sonixd:matrix.org"> <img src="https://img.shields.io/matrix/sonixd:matrix.org?color=black&label=matrix&logo=matrix&logoColor=white" alt="Matrix"> </a> </p>

Sonixd的重写版本。

特性

• MPV播放器后端
• 网页播放器后端
• 现代化界面
• 将播放记录同步到您的服务器
• 智能播放列表编辑器（Navidrome）
• 支持同步和非同步歌词
• 提出功能请求或查看任务面板

截图

<a href="https://yellow-cdn.veclightyear.com/835a84d5/61df1da7-f1b0-47cf-a8ac-b3c7df765a76.png"><img src="https://yellow-cdn.veclightyear.com/835a84d5/61df1da7-f1b0-47cf-a8ac-b3c7df765a76.png" width="49.5%"/></a> <a href="https://yellow-cdn.veclightyear.com/835a84d5/302403b7-746d-4364-a99b-d589dd28674d.png"><img src="https://yellow-cdn.veclightyear.com/835a84d5/302403b7-746d-4364-a99b-d589dd28674d.png" width="49.5%"/></a> <a href="https://yellow-cdn.veclightyear.com/835a84d5/458f4874-ab2b-464c-bc8c-63550fa7d5b1.png"><img src="https://yellow-cdn.veclightyear.com/835a84d5/458f4874-ab2b-464c-bc8c-63550fa7d5b1.png" width="49.5%"/></a> <a href="https://yellow-cdn.veclightyear.com/835a84d5/fe3db514-d0ca-415c-85d1-dc3cab82da42.png"><img src="https://yellow-cdn.veclightyear.com/835a84d5/fe3db514-d0ca-415c-85d1-dc3cab82da42.png" width="49.5%"/></a>

入门指南

桌面版（推荐）

下载最新的桌面客户端。桌面客户端是使用Feishin的推荐方式。它同时支持MPV和网页播放器后端，并内置歌词获取功能。

MacOS注意事项

如果您使用的设备运行macOS 12（Monterey）或更高版本，请查看此处了解如何从隔离区移除应用程序的说明。

要使媒体键正常工作，系统会提示您允许Feishin成为受信任的辅助功能客户端。允许后，您需要重启Feishin以使隐私设置生效。

网页版和Docker

访问https://feishin.vercel.app使用Feishin的托管网页版。网页客户端仅支持网页播放器后端。 Feishin 也可以作为 Docker 镜像使用。镜像托管在 ghcr.io 上，可以在这里查看。您可以使用以下命令运行容器：

# 运行最新版本
docker run --name feishin -p 9180:9180 ghcr.io/jeffvli/feishin:latest

# 在本地构建镜像
docker build -t feishin .
docker run --name feishin -p 9180:9180 feishin

Docker Compose

要通过 Docker Compose 安装，请使用以下代码片段。这也适用于 Portainer。

version: '3'
services:
  feishin:
    container_name: feishin
    image: 'ghcr.io/jeffvli/feishin:latest'
    environment:
      - SERVER_NAME=jellyfin # 预定义服务器名称
      - SERVER_LOCK=true # 当设为 true 且名称/类型/URL 已设置时，只能切换用户名/密码
      - SERVER_TYPE=jellyfin # navidrome 也可以
      - SERVER_URL= # http://地址:端口
      - PUID=1000
      - PGID=1000
      - UMASK=002
      - TZ=America/Los_Angeles
    ports:
      - 9180:9180
    restart: unless-stopped

配置

1. 启动时，您将看到提示选择 MPV 二进制文件的路径。如果您尚未安装 MPV，可以在这里下载，或使用您操作系统支持的任何包管理器安装。输入路径后，重启应用程序。

2. 重启应用程序后，系统会提示您选择服务器。点击"打开菜单"按钮并选择"管理服务器"。在弹出窗口中点击"添加服务器"按钮，填写所有适用的详细信息。您需要输入服务器的完整 URL，包括协议和端口（如果适用）（例如 https://navidrome.my-server.com 或 http://192.168.0.1:4533）。

• Navidrome - 为获得最佳体验，创建服务器时选择"保存密码"，并在 Navidrome 配置中将 SessionTimeout 设置为更大的值（例如 72h）。
  • Linux 用户 - 默认密码存储使用 libsecret。也支持 kwallet4/5/6，但必须在设置 > 窗口 > 密码/密钥存储中明确设置。

3. 可选 - 如果您想在子路径（非 /）上托管 Feishin，请传入以下环境变量：PUBLIC_PATH=PATH。例如，要在 /feishin 上托管，传入 PUBLIC_PATH=/feishin。

4. 可选 - 要硬编码服务器 URL，请传入以下环境变量：SERVER_NAME、SERVER_TYPE（jellyfin 或 navidrome 之一）、SERVER_URL。要防止用户更改这些设置，传入 SERVER_LOCK=true。只有在设置了前三个值时才能设置此项。

常见问题

MPV 不工作或在暂停/播放状态之间快速切换

首先要检查 MPV 二进制路径是否正确。导航到设置页面，重新设置路径并重启应用程序。如果问题仍未解决，请尝试重新安装 MPV。已知可用的版本包括 v0.35.x 和 v0.36.x。v0.34.x 是已知的有问题版本。

Feishin 支持哪些音乐服务器？

Feishin 支持任何实现 Navidrome 或 Jellyfin API 的音乐服务器。目前不支持 Subsonic API。这可能会在新的 Subsonic API 确定后添加。

• Navidrome
• Jellyfin
• Funkwhale - 待定
• Subsonic 兼容服务器 - 待定

在 Linux 上遇到 "The SUID sandbox helper binary was found, but is not configured correctly" 问题

这是因为您禁用了用户（非特权）命名空间（sysctl kernel.unprivileged_userns_clone 返回 0）。您可以通过启用非特权命名空间或将 chrome-sandbox 设为 Setuid 来解决此问题。

chmod 4755 chrome-sandbox
sudo chown root:root chrome-sandbox

开发

使用 Node v16.15.0 构建和测试。

本项目基于 electron-react-boilerplate v4.6.0 构建。

翻译

本项目使用 Weblate 进行翻译。如果您想贡献，请访问该链接并提交翻译。

许可证

GNU 通用公共许可证第3版 ©