Sonata 使用与技术文档

Sonata 是一款优雅的 GTK 3 客户端，用于音乐播放守护进程（Music Player Daemon，MPD）。以下为安装指南、使用说明以及项目 API 使用文档。

1. 安装指南

系统需求

为了运行 Sonata，您需要以下依赖项：

• Python >= 3.2
• PyGObject（Python GObject Introspection）(推荐版本 3.7.4 或更高，早期版本可能也可用)
• GTK >= 3.4
• python-mpd2 >= 2.0
• MPD >= 0.15（可能在另一台计算机上）
• tagpy >= 2013.1 用于编辑元数据（可选）
• dbus-python 用于多媒体键（可选）

安装步骤

您可以从 Git 仓库下载 Sonata：

$ git clone git://github.com/multani/sonata.git
$ cd sonata

要运行 Sonata，可以选择以下任一方式：

• 以 root 身份在指定目录安装：

  # python setup.py install
  

• 直接从目录运行（无需预先安装）：

  $ ./run-sonata
  

2. 使用说明

Sonata 提供了以下功能：

• 展开/折叠视图，全屏专辑艺术模式
• 自动获取远程和本地专辑封面
• 按文件夹、流派/艺术家/专辑浏览库
• 用户可配置的列
• 自动获取歌词和封面
• 支持播放列表和流
• 支持编辑歌曲标签
• 支持拖放复制文件
• 弹出通知
• 库和播放列表搜索，边输入边过滤
• Audioscrobbler (Last.fm) 1.2 支持
• 多个 MPD 配置文件
• 键盘友好
• 支持多媒体键
• 命令行控制

3. 项目 API 使用文档

由于 Sonata 是使用 Python 编程语言编写的，并且是基于 GTK 3 工具包，具体的 API 使用文档可以参考官方文档。

4. 项目安装方式

如前所述，Sonata 可以通过以下方式安装：

• 直接从 Git 仓库克隆
• 使用包管理器（如在 Archlinux 的 AUR 或 Gentoo 的 stuff overlay）

请确保在安装前满足所有系统需求。