#mpd #statistics #stats #track

app mscout

mscout 用于 mpd,监听事件,跟踪统计数据,将它们存储在 mpd 标签中或直接写入元数据以进行永久存储

1 个不稳定版本

0.3.0 2023 年 7 月 15 日

#671音频

Apache-2.0

61KB
1K SLoC

mscout

这是一个 mpd 插件,根据播放次数和跳过次数对每首歌曲进行评分。

注意:如果启用了 consume,则此功能不工作

功能

  1. 监控事件并更新 mpd 的统计数据。
  2. 查询或更新统计数据 OTF。
  3. 可选地,在状态更改时运行可脚本的动作命令

要求

  1. mpd
  2. rust <仅在从源代码构建时是可选的>

安装

从源代码构建

  • git clone https://github.com/hardfau18/mscout.git
  • cdmscout
  • cargobuild --release
  • cp target/release/mscout~/.local/bin
  • 如果 ~/.local/bin/ 路径未设置,则使用以下命令设置它: export PATH=~/.local/bin:$PATH。 要使其永久,请将其添加到 ~/.bashrc 文件中。

运行

要运行 mscoutmpd 应在后台运行,并监听本地网络套接字或 Unix 套接字文件。要配置 mpd 监听网络套接字,请将以下两行添加到 mpd.conf 文件中。

bind_to_address   "any"
port              "6600"

要监听 Unix 套接字文件,请使用以下行。请确保 ~/.local/run/mpd 文件夹存在,如果不存在,请使用以下命令创建它:mkdir ~/.local/run/mpd

bind_to_address		"~/.local/run/mpd/socket"

存储歌曲统计信息有两种方式。

  1. 使用 mpd 标签数据库来存储评分
  2. 使用歌曲的 ID3 标签来存储评分 默认情况下,使用 mpd 数据库来存储评分。但这不是持久的。如果您将任何文件移动到单独的目录中,则这些文件的所有评分都将重置。ID3 标签在移动歌曲时也会存储评分。评分将存储在相应歌曲的 ID3 标签的注释部分中。如果想要使用 ID3 标签,请使用 --socket-path <套接字文件路径> 选项或 --root-dir <mpd 音乐目录路径> 选项,并使用 --use-tags 选项。

如果您不想每次都使用 --use-tags,您可以export MSCOUT_USE_TAGS=1 变量。

示例

对于监听带有 mpd 标签数据库的网络套接字

mscout-a127.0.0.1:6600 -L

对于监听带有 id3 标签的网络套接字

mscout-a127.0.0.1:6600 --使用-标签-r<mpd 音乐目录> -L

对于监听带有 id3 标签的套接字文件

mscout-p~/.local/运行/mpd/套接字--使用-标签-L

检索评分。

要获取特定歌曲的评分,使用 get-stats 选项。例如,获取当前歌曲的统计数据

mscout-a127.0.0.1:6600 -G--当前

或要获取任何其他歌曲的统计数据,给出相对于 mpd 音乐目录的路径

mscout-a127.0.0.1:6600 -G<相对于歌曲的路径>

要获取整个播放列表的统计数据。

mscout-G--播放列表<播放列表> ...

要获取当前队列的统计数据。

mscout-G-Q

使用 -s 标志获取准确的播放和跳过次数

依赖项

~7–36MB
~531K SLoC