ghcr.io/jeffvli/feishin:development

Feishin

Sonixd 的重写版本。

功能特性

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

截图

快速开始

桌面版（推荐）

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

macOS 注意事项

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

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

Linux 注意事项

Feishin 可在 Flathub 中获取。

或者，您可以将其作为 AppImage 安装。我们提供了一个小型安装脚本，用于下载最新的 .AppImage、设置可执行权限、下载桌面环境所需的图标，并最终生成 .desktop 文件以将 Feishin 添加到应用程序启动器。

只需按如下方式运行安装程序：

dir=/your/application/directory
curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir"

该脚本还提供了添加启动参数以原生 Wayland 模式运行 Feishin 的选项。请注意，这在 Electron 中属于实验性功能，因此不受官方支持。如果您想使用此模式，请运行以下命令：

dir=/your/application/directory
curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir" wayland-native

它还提供了简单的卸载程序，用于删除已下载的文件：

dir=/your/application/directory
curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir" remove

应用条目应立即显示在应用程序启动器中。如果未显示，只需注销，等待 10 秒后重新登录。您的桌面环境可能还提供重新加载条目的方法。

FAQ

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

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

Feishin支持哪些音乐服务器？

Feishin支持任何实现Navidrome、Jellyfin或OpenSubsonic兼容API的音乐服务器。

• Navidrome
• Jellyfin
• OpenSubsonic兼容服务器，例如：
  • Airsonic-Advanced
  • Ampache
  • Astiga
  • Funkwhale
  • Gonic
  • LMS
  • Nextcloud Music
  • Supysonic
  • Qm-Music
  • 更多（？）
• Plex：Feishin不原生支持Plex。请使用lux032的分支版本以在Feishin中使用Plex。

在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

Ubuntu 24.04特别引入了影响命名空间工作方式的破坏性更改。有关可能的修复方法，请参见[***]

开发

使用Node v23.11.0构建和测试。

该项目基于electron-vite构建

• pnpm run dev - 启动开发服务器
• pnpm run dev:watch - 以监视模式启动开发服务器（用于主进程/预加载脚本的HMR）
• pnpm run start - 以生产预览模式启动应用
• pnpm run build - 构建桌面应用
• pnpm run build:electron - 构建electron应用（主进程、预加载脚本和渲染器）
• pnpm run build:remote - 构建远程应用（remote）
• pnpm run build:web - 构建独立Web应用（渲染器）
• pnpm run package - 打包项目
• pnpm run package:dev - 为本地开发打包项目
• pnpm run package:linux - 为Linux本地打包项目
• pnpm run package:mac - 为Mac本地打包项目
• pnpm run package:win - 为Windows本地打包项目
• pnpm run publish:linux - 发布Linux版本项目
• pnpm run publish:linux:beta - 发布Linux版本项目（测试通道）
• pnpm run publish:linux-arm64 - 发布Linux ARM64版本项目
• pnpm run publish:linux-arm64:beta - 发布Linux ARM64版本项目（测试通道）
• pnpm run publish:mac - 发布Mac版本项目
• pnpm run publish:mac:beta - 发布Mac版本项目（测试通道）
• pnpm run publish:win - 发布Windows版本项目
• pnpm run publish:win:beta - 发布Windows版本项目（测试通道）
• pnpm run typecheck - 类型检查项目
• pnpm run typecheck:node - 使用tsconfig.node.json类型检查项目
• pnpm run typecheck:web - 使用tsconfig.web.json类型检查项目
• pnpm run lint - 代码 lint 检查
• pnpm run lint:fix - 代码 lint 检查并修复错误
• pnpm run i18next - 生成i18n文件

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

许可协议

GNU General Public License v3.0 ©