Tonuino Cards Manager

欢迎使用，这是一个方便的实用程序，旨在简化为Tonuino音乐盒管理和组织音乐的过程。此工具简化了管理Tonuino SD卡内容和RFID卡设置的流程。

目录

• 概述
• 功能
• 安装
• 使用
  • 演示
• 配置
• 限制
• 贡献
• 许可协议

概述

提供了一种简单的方法来为您的Tonuino音乐盒准备和管理音乐收藏。无论您是想将单个歌曲还是整个专辑分配给特定的RFID卡，此工具都可通过单个YAML配置文件无缝处理设置。

功能

• 简单配置：使用简单的YAML文件定义每个RFID卡播放的音乐。
• 多个来源：将来自不同来源的歌曲或专辑分配给一个RFID卡。
• 所有模式：该工具支持所有现代播放模式，例如单曲和派对模式。
• 自动化管理：该工具自动将音乐文件复制和组织到Tonuino的适当结构中。
• 二维码生成：为每张卡片生成二维码，使您能够快速配置卡片，例如使用TonUINO NFC 工具
• 用户友好：直观且以简洁的设计理念管理孩子的音乐收藏。

安装

要安装 Tonuino 卡管理器，您需要安装 Python（至少版本 3.10）。您可以使用 pip 安装应用程序。

pip3 install tonuino-cards-manager

使用

安装完成后，您可以按照以下步骤使用此工具

1. 准备您的 YAML 配置文件（例如 mybox.yaml），指定每张 RFID 卡的音乐。
2. 使用以下命令运行工具

   tonuino-cards-manager --config mybox.yaml --destination /path/to/tonuino-sd-card/
   

3. 工具将处理 YAML 文件并根据指定的配置组织音乐（见下文）。

有关所有可用选项，请查看 tonuino-cards-manager --help。

演示

生成的二维码可以使用TonUINO NFC 工具扫描。在那里，您可以点击“输入列表”和“读取二维码”，然后批量编程您的 RFID 卡。

配置

Tonuino 卡管理器的核心是配置文件，其中您定义您的音乐设置。以下是一个配置示例的基本示例

# sourcebasedir: ""
# cardcookie: "1337B347"
# version: 2

cards:
  # A whole directory in album mode
  1:
    source:
      - Rolf Zuckowski/1994 Im Kindergarten
    mode: album
  # A whole directory in party mode. A single source can also be written this way
  2:
    source: Fredrik Vahle/1990 Der Spatz
    mode: party
  # A whole directory, play one of the 10 first episodes randomly
  3:
    source: Audio Books/Benjamin Blümchen/
    mode: play-from-to
    from_song: 1
    to_song: 10
  # Multiple single songs and a whole directory in party mode
  4:
    description: Favourite songs of the last few weeks
    source:
      - Singles/Die alte Moorhexe.mp3
      - Singles/Große Uhren machen tick tack.mp3
      - Singles/Best of Last Vacation/
    mode: party

配置细节

• sourcebasedir：如果您所有音乐都在一个目录中，您可以在此处添加路径，并使卡片的 source 条目相对于此目录。默认：""
• cardcookie：Tonuino 盒子的卡 cookie。有关背景信息。默认：1337B347
• version：卡片格式版本，为 Tonuino 2.1.x 和 TNG 的 2。默认：2
• cards：RFID 卡的列表。
  • id：卡片的编号。这些数字必须是唯一的，必须是实际的数字，而不是文本。
    • description：用于描述卡的文本字段，对于单首歌曲的收藏很有用。在处理二维码时，仅对您的信息有关。默认：""
    • source：分配给卡的路径字符串或歌曲或专辑列表。必需。
    • mode：此卡的播放模式。可以是以下模式中的任何一种。默认：play-random
      • play-random：播放文件夹中的随机文件，前后按钮锁定
      • album：播放整个文件夹
      • party：随机顺序播放文件夹中的文件
      • single：播放文件夹中的特定文件
      • audiobook：播放文件夹并保存进度
      • admin：创建管理员卡
      • play-from-to：播放起始和结束文件之间的随机文件（您需要设置 from_song 和 to_song）
      • album-from-to：按顺序播放起始和结束文件之间的所有文件（您需要设置 from_song 和 to_song）
      • party-from-to：随机播放起始和结束文件之间的所有文件（您需要设置 from_song 和 to_song）
    • from_song：如果您设置了 *-from-to 之一，请写下您想从列表中提供的源开始的歌曲编号。默认：0
    • to_song：与 from_song 相同。默认：0

限制

此工具目前有一些限制。请随时为该项目做出贡献或分享您修复它们的想法。

• 将支持最多 99 张卡片，因为每个配置的卡片都会创建一个单独的文件夹。典型的 Tonuino MP3 播放器组件只能支持 01-99 之间的文件夹。
• 由于我没有这样的盒子，因此尚未测试 RFID 卡格式的 1 版。

贡献

欢迎贡献力量！要为 Tonuino 卡管理器 做出贡献，请查看贡献指南。

许可协议

本项目采用 GNU 通用公共许可证 v3.0（GPL-3.0-only）授权。有关详细信息，请参阅LICENSE 文件。

可能存在在不同许可（兼容的）和不同版权所有者下的组件。该项目符合REUSE规范，这使得这些部分透明。您可以在LICENSES目录中找到所有使用的许可证。

享受Tonuino音乐盒带来的快乐！如果您有任何问题或需要进一步的帮助，请在GitHub上创建一个问题。