# 定时播放器

**Repository Path**: ssget/timer-player

## Basic Information

- **Project Name**: 定时播放器
- **Description**: 在香橙派(orangepi)5上的自动播放程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-18
- **Last Updated**: 2026-03-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 定时播放器

#### 介绍
在香橙派(orangepi)5上的自动播放程序

#### 软件架构
软件架构说明


#### 安装教程

1.  安装必要依赖
2.  将py和conf文件放到对应目录，本程序默认放到/home/orangepi
3.  赋予执行权限之后，配置定时执行cron和待播放的音乐music后，直接执行./aux_audio_player.py

#### 使用说明

1.  确保orangepi环境安装好了必要依赖
```
# 1. 核心音频工具（播放MP3必需）
sudo apt update && sudo apt install -y alsa-utils alsa-tools libasound2 libasound2-dev mplayer

# 2. Python依赖（解析crontab定时规则）
pip3 install croniter
```
2.  在music_play.conf中配置定时任务corn规则
```
[cron]
# 定时规则：分 时 日 月 周（示例：每天 8:00、12:00、13:00播放）
schedule = 0 8,12,13 * * *

[music]
# 歌曲列表（每行一个路径，支持绝对/相对路径）
/home/orangepi/tzdxp.mp3
/home/orangepi/tzdxp.mp3
/home/orangepi/tzdxp.mp3
```
3.  在music_play.conf中配置待播放的音乐文件的绝对路径

#### 其他注意事项

1. 依赖仅需装一次，重启后无需重复安装；
2. 程序启动后按 Ctrl+C 可优雅退出，自动保存播放进度；
3. .player_state 文件是播放进度记录，请勿手动删除；
4. 定时规则支持标准 crontab 语法（如 */30 * * * * 每 30 分钟播放）；
5. 若需开机自启，可将启动命令加入 /etc/rc.local（需加 nohup 后台运行）。