Metadata-Version: 2.4
Name: cli-anything-garageband
Version: 1.0.0
Summary: CLI harness for GarageBand - macOS audio project editing via Python. Requires: macOS
Home-page: https://github.com/HKUDS/CLI-Anything
Author: cli-anything contributors
Author-email: cli-anything@users.noreply.github.com
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Multimedia :: Sound/Audio :: Editors
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: MacOS
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0.0
Requires-Dist: prompt-toolkit>=3.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# cli-anything-garageband

GarageBand CLI — macOS 音频项目的状态化命令行接口。

## 功能

- 项目管理（新建、打开、保存、BPM设置）
- 音轨管理（添加、删除、音量、声像、静音、独奏）
- 片段管理（添加音频、裁剪、移动、删除）
- 效果链（EQ、压缩、混响、延迟等11种效果）
- 音频导出（WAV/MP3/M4A/AIFF）
- 撤销/重做
- 交互式 REPL
- JSON 输出模式（AI Agent 友好）

## 安装

```bash
pip install cli-anything-garageband
```

## 快速开始

```bash
# 创建项目
cli-anything-garageband project new --name "My Song" --bpm 140

# 添加音轨
cli-anything-garageband track add --name "Vocals" --instrument "Vocals"
cli-anything-garageband track add --name "Guitar" --instrument "Acoustic Guitar"

# 添加音频
cli-anything-garageband clip add 0 vocal.wav --position 0
cli-anything-garageband clip add 1 guitar.wav --position 0

# 添加效果
cli-anything-garageband effect add 0 reverb
cli-anything-garageband effect add 0 compressor

# 混音
cli-anything-garageband track volume 0 -3
cli-anything-garageband track pan 1 30

# 导出
cli-anything-garageband export render output.wav
cli-anything-garageband export render output.m4a --format m4a

# JSON 模式
cli-anything-garageband --json track list

# 交互式 REPL
cli-anything-garageband repl
```

## 依赖

- macOS（导出 M4A/AIFF 使用 afconvert）
- 可选：lame（MP3 导出）
