trying to be a user-friendly and hackable music player
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
data play mv Feb 8, 2019
docs merge fuocore.utils and feeluown.utils Feb 10, 2019
examples
feeluown 移动部分组件到 widgets 包中 Feb 10, 2019
fuocore merge fuocore.utils and feeluown.utils Feb 10, 2019
icons add three button on PlayerControlPanel Oct 23, 2018
research add research script: mpv_qtwidget_opengl.py Feb 7, 2019
tests update tests Feb 2, 2019
.gitignore merge fuocore package Feb 1, 2019
.pylintrc 移除垃圾代码 May 5, 2018
.travis.yml merge fuocore package Feb 1, 2019
LICENSE change license Dec 13, 2015
Makefile merge fuocore package Feb 1, 2019
README.md 移动部分组件到 widgets 包中 Feb 10, 2019
changelog.rst 拆分 protocol 包为 protocol 模块和 cmds 包 Feb 10, 2019
mpv.py play mv Feb 8, 2019
setup.cfg play mv Feb 8, 2019
setup.py

README.md

FeelUOwn - feel your own

Documentation Status Build Status Coverage Status PyPI python

FeelUOwn 是一个符合 Unix 哲学的跨平台的音乐播放器,主要面向 Linux/macOS 用户。

macOS 效果预览

特性

使用方法

安装

# Ubuntu 用户可以依次执行以下命令进行安装
sudo apt-get install python3-pyqt5  # 安装 Python PyQt5 依赖包
sudo apt-get install python3-pyqt5.qtopengl
sudo apt-get install libmpv1        # 安装 libmpv1 系统依赖
pip3 install 'feeluown>=2.2' --user -i https://pypi.org/simple/
## 为 feeluown 生成图标(Linux 用户)
feeluown-genicon   # 生成图标

## 一些非必须依赖
sudo apt-get install fcitx-frontend-qt5  # 使用 fcitx 输入法的用户可能需要安装

# macOS 用户安装方法
brew install pyqt
brew install mpv
pip3 install 'feeluown>=2.2' --upgrade --user

使用

# 第一种方法:Linux 用户直接点击图标运行程序
# 第二种方法:在命令行中启动,这时候会弹出 GUI 界面
feeluown
# 第三种方法:适用于不需要 GUI 界面的用户(比如使用命令行或者使用 Emacs 插件等)
feeluown -nw     # -nw 表示 no window
feeluonw -nw -d  # -d 表示打开 debug 模式,会输出更多日志

常见问题

其它常见问题请阅读文档:http://feeluown.readthedocs.io/en/latest/faq.html

怎样参与设计开发、如果编写插件?

目前,一方面可以通过阅读开发者文档来了解项目整体架构;另一方面,可以加入开发者/用户交流群,与大家一起讨论,大部分我自己也会在线,如果有相关疑问,我会尽量和大家沟通。

程序遇到错误怎么办?

一般来说,feeluown 运行时,会将日志输出到 ~/.FeelUOwn/stdout.log ,如果大家在使用时遇到程序异常,可以新建一个 Issue,将日志或者截图放在 Issue 中,让大家帮忙解答。另外,大家也可以加入交流群,在群中提出建议或者反馈。

有项目开发计划或者 bug 修复排期吗?

大家可以参考这个项目开发计划

已知的一些插件

大家如果发现或者自己编写了一些插件,可以在下面进行补充~

插件名 开发者们 状态
MPRIS2 @cosven 可用
macOS 全局快捷键 @cosven 未测试
Discord RPC Rich Precense 服务 @BruceZhang1993 可用