快速上手

FeelUOwn 使用 Python 3 进行开发,目前默认使用 mpv 作为其播放引擎, 基于 PyQt6 构建 GUI。

安装

如果你有一定折腾经验,你可以参考"通用安装办法",它可控性强、行为可预期。 你也可以参考各个平台的安装教程来安装 FeelUOwn。你可以在两种方法中灵活选择。

通用安装办法

安装 FeelUOwn 分两步。一步是安装 libmpv;一步是安装 FeelUOwn 及其依赖的 Python 包。

  1. libmpv 通常可以使用系统包管理器安装

  2. FeelUOwn 及其依赖的 Python 包可以使用 Python 包管理工具来安装(如 pipx 或者 uv)。

libmpv, pipx 通常可以通过系统包管理器来安装,如 Debian Linux 可以使用 apt-get 命令, macOS 可以 brew 命令等。

# macOS
brewinstallmpvpipx
# Ubuntu
sudoapt-getinstalllibmpv1pipx

在安装好 libmpv 和 Python 包管理工具后。你可以运行如下命令来安装 FeelUOwn 及其依赖的 Python 包:

# Linux 用户可以使用如下命令
pipxinstallfeeluown[battery,ai,cookies,webengine,qt]-v
# macOS 和 Windows 用户可以分别使用如下命令
# 建议优先使用 Python 3.10/3.11 版本(部分依赖包没有适配 3.12 和 3.13 版本)
pipxinstallfeeluown[battery,ai,cookies,webengine,qt,macos]--python`whichpython3.11`-v
pipxinstallfeeluown[battery,ai,cookies,webengine,qt,win32]--python`whichpython3.11`-v

Ubuntu

下面命令在 Ubuntu 18.04 中测试通过,理论上其它 Linux 发行版 安装流程类似,只是一些包的名字可能有些许差别。

# 安装 Python 3 和 pipx (大部分系统已经安装好了)
sudoapt-getinstallpython3python3-pippipx
# 配置 pipx
# pipx 的安装配置教程可以参考:https://github.com/pypa/pipx?tab=readme-ov-file#on-linux
pipxensurepath
sudopipxensurepath--global
# 安装 libmpv1
sudoapt-getinstalllibmpv1
# 安装 PyQt6
sudoapt-getinstallpython3-pyqt5python3-pyqt5.qtopenglpython3-pyqt5.qtsvg
# 安装 dbus-python
sudoapt-getinstallpython3-dbuspython3-dbus.mainloop.pyqt5
# 安装 feeluown (是一个 Python 包)
# --upgrade 代表安装最新版,--user 代表不安装到系统目录
pipxinstall'feeluown[battery,cookies,webengine,ai]'
pipxinjectfeeluownpyopengl
# 运行 feeluown -h 来测试安装是否成功
# 如果提示 Command Not Found,请检查 pipx 的 PATH 配置
feeluown-h
# 生成桌面图标
feeluown-genicon
# (可能还需要安装)使用 fcitx 输入法的用户可能需要安装
# 否则有可能不能在 GUI 中切换输入法
sudoapt-getinstallfcitx-frontend-qt5

macOS 

# macOS Monterey(版本12)实测可以安装,版本 11 可能不能正常安装
# (https://github.com/feeluown/FeelUOwn/issues/421)
brewtapfeeluown/feeluown
brewinstallfeeluown--with-battery# 更多选项见 `brew info feeluown`
feeluowngenicon# 在桌面会生成一个 FeelUOwn 图标

Windows

你可以从 发布页 直接下载打包好的压缩包。 也可以按照如下步骤手动进行安装:

  1. 安装 Python 3,参考 链接 <https://www.python.org/downloads/windows/> (请勿从应用商店安装)

  2. 下载 mpv-1.dll , 将 mpv-1.dll 放入 C:\Windows\System32 目录。

  3. 安装 PyQt6,在 cmd 中运行 pip3 install PyQt6 -i https://pypi.douban.com/simple

  4. 安装 feeluown,在 cmd 中运行 pip3 install feeluown[battery,win32]

  5. 在 cmd 中运行 python -m feeluown genicon 命令,可以生成桌面图标

Arch Linux

https://archlinux.org/packages/extra/any/feeluown/

Gentoo

https://github.com/microcai/gentoo-zh/tree/master/media-sound/feeluown

Debian

https://github.com/coslyk/debianopt-repo

NixOS

https://github.com/berberman/flakes

openSUSE

对于 openSUSE Tumbleweed,请以根用户 root 运行下面命令:

zypperaddrepohttps://download.opensuse.org/repositories/home:weearcm/openSUSE_Tumbleweed/home:weearcm.repo
zypperrefresh
zypperinstall--recommendsfeeluown

对于 openSUSE Slowroll,请以根用户 root 运行下面命令:

zypperaddrepohttps://download.opensuse.org/repositories/home:weearcm/openSUSE_Slowroll/home:weearcm.repo
zypperrefresh
zypperinstall--recommendsfeeluown

详情可以参考: #833

基本使用

大家有几种方式启动 FeelUOwn:

  1. 直接双击桌面 FeelUOwn 图标,这时启动 GUI/Daemon 混合模式

  2. 在命令行中运行 feeluown 命令,这时也是混合模式

  3. 在命令行中运行 feeluown -nw 命令,这时是 Daemon 模式

Daemon 模式的使用方法,这里简单说明: (提示:如果不熟悉命令行,DAEMON 模式可能会有一定的折腾)

feeluown-nw# 使用 Daemon 模式启动 feeluown
fuostatus# 查看播放器状态
fuosearch周杰伦# 搜索歌曲
fuoplayfuo://netease/songs/470302665# 播放:(世界が终るまでは...)《灌篮高手》

如果大家对 NetCat 工具熟悉

nclocalhost23333
# 输入 `status` 命令,可以查看播放器状态
# 输入 `fuo play fuo://netease/songs/470302665` 可以播放音乐

关于 Daemon 更多使用细节,大家可以参考运行 fuo -h 来查看帮助文档