Automatic Ripping Machine (ARM) 项目安装与使用教程
1. 项目目录结构及介绍
Automatic Ripping Machine (ARM) 项目的目录结构如下:
automatic-ripping-machine/
├── arm-dependencies/
├── arm/
├── arm_wiki/
├── devtools/
├── docs/
├── scripts/
├── setup/
├── test/
├── .codeclimate.yml
├── .codecov.yml
├── .dockerignore
├── .gitignore
├── .gitmodules
├── .pylintrc
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── Dockerfile
├── LICENSE
├── README.md
├── SECURITY.md
├── VERSION
├── favicon.ico
├── requirements.txt
└── setup.cfg
目录介绍
- arm-dependencies/: 包含项目依赖的相关文件。
- arm/: 包含 ARM 项目的主要代码。
- arm_wiki/: 包含项目的 Wiki 文档。
- devtools/: 包含开发工具和脚本。
- docs/: 包含项目的文档文件。
- scripts/: 包含项目的脚本文件。
- setup/: 包含项目的设置和配置文件。
- test/: 包含项目的测试文件。
- .codeclimate.yml: CodeClimate 配置文件。
- .codecov.yml: Codecov 配置文件。
- .dockerignore: Docker 忽略文件。
- .gitignore: Git 忽略文件。
- .gitmodules: Git 子模块配置文件。
- .pylintrc: Pylint 配置文件。
- CHANGELOG.md: 项目变更日志。
- CODE_OF_CONDUCT.md: 项目行为准则。
- CONTRIBUTING.md: 贡献指南。
- Dockerfile: Docker 构建文件。
- LICENSE: 项目许可证。
- README.md: 项目自述文件。
- SECURITY.md: 安全政策文件。
- VERSION: 项目版本文件。
- favicon.ico: 项目图标。
- requirements.txt: Python 依赖文件。
- setup.cfg: 项目配置文件。
2. 项目启动文件介绍
ARM 项目的启动文件主要位于 arm/
目录下。以下是一些关键的启动文件:
- arm/main.py: 这是 ARM 项目的主启动文件,负责初始化并启动整个应用程序。
- arm/config.py: 配置文件,包含项目的配置选项和设置。
- arm/ripper.py: 负责光盘的识别和 ripping 过程。
- arm/transcoder.py: 负责视频的转码过程。
启动步骤
- 确保所有依赖项已安装(可以通过
requirements.txt
文件安装)。 - 运行
main.py
文件启动 ARM 项目:
python arm/main.py
3. 项目的配置文件介绍
ARM 项目的配置文件主要位于 setup/
目录下,以下是一些关键的配置文件:
- setup/arm.yaml: 主配置文件,包含 ARM 项目的所有配置选项,如光盘驱动器设置、 ripping 和转码选项等。
- setup/abcde.conf: 用于音频 CD ripping 的配置文件。
- setup/apprise.yaml: 通知服务的配置文件,支持多种通知方式如 IFTTT、Pushbullet 等。
配置文件示例
arm.yaml
# ARM 主配置文件
arm:
drive:
device: /dev/sr0
ripping:
mode: full
transcoding:
enabled: true
format: mp4
abcde.conf
# 音频 CD ripping 配置
OUTPUTTYPE=flac
OUTPUTFORMAT='${ARTISTFILE}-${ALBUMFILE}'
apprise.yaml
# 通知服务配置
notifications:
- service: pushbullet
token: YOUR_PUSHBULLET_TOKEN
- service: slack
webhook: YOUR_SLACK_WEBHOOK
通过这些配置文件,用户可以根据自己的需求自定义 ARM 项目的行为和设置。