gmusicbrowser 技术文档

1. 安装指南

系统要求

• 操作系统：支持大多数 Linux 发行版
• Perl 环境
• GTK+2 及其 Perl 绑定（GTK3 版本处于测试阶段）
• GStreamer 或 mpg123/ogg123、mplayer 或 mpv、mpg321/ogg123/flac123/amixer（可选）
• Net::DBus 模块（用于通过 DBus 控制gmusicbrowser或使用包含的gnome多媒体键插件）

安装步骤

1. 确保系统已安装 Perl 环境、GTK+2 及其 Perl 绑定。
2. 安装 GStreamer 或 mpg123/ogg123、mplayer 或 mpv、mpg321/ogg123/flac123/amixer 中的一种或多种音频播放库。
3. 安装 Net::DBus 模块。
4. 下载 gmusicbrowser 源码。
5. 运行 perl Build.PL。
6. 运行 ./Build。
7. 运行 ./Build install。

2. 项目使用说明

gmusicbrowser 是一款针对大量 mp3/ogg/flac/mpc 文件的音乐播放器。以下是主要功能的简要说明：

• 窗口布局自定义：可以根据个人喜好调整窗口布局。
• 艺术家/专辑锁定：轻松将播放列表限制为当前艺术家或专辑。
• 相关歌曲访问：方便地访问与当前播放歌曲相同艺术家、专辑或标题的其他歌曲。
• 简单的批量标记和重命名：支持对歌曲进行批量标记和重命名。
• 多流派支持：每首歌曲可以设置多个流派。
• 自定义标签：可以为每首歌曲设置自定义标签。
• 过滤器：支持条件无限嵌套的过滤器。
• 自定义加权随机模式：可以根据评分、上次播放时间等因素自定义加权随机播放。

3. 项目API使用文档

由于 gmusicbrowser 是一个 Perl 项目，以下是一些基本的 Perl API 使用说明：

初始化

use Gmu::Player;
my $player = Gmu::Player->new();

播放音乐

my $song = $player->get_song_by_id($song_id);
$player->play($song);

获取播放列表

my @playlist = $player->get_playlist();

添加歌曲到播放列表

my $song = $player->get_song_by_id($song_id);
$player->add_to_playlist($song);

其他功能

更多 API 使用说明，请参考项目源码中的相关模块和文档。

4. 项目安装方式

项目安装方式已在“1. 安装指南”中详细描述，这里不再重复。简要概括为：确保系统环境满足要求，下载源码，使用 Perl 的 Build.PL 脚本构建和安装。