cli-anything-audacity은(는) 무엇을 하나요?
오디오 편집을 위한 상태 저장 명령줄 인터페이스로, 이 저장소의 GIMP 및 Blender CLI와 동일한 패턴을 따릅니다.
설치
이 CLI는 cli-anything-audacity 패키지의 일부로 설치됩니다:
pip install cli-anything-audacity
전제 조건:
- Python 3.10+
- 시스템에 audacity가 설치되어 있어야 합니다
사용법
기본 명령어
# 도움말 표시
cli-anything-audacity --help
# 대화형 REPL 모드 시작
cli-anything-audacity
# 새 프로젝트 생성
cli-anything-audacity project new -o project.json
# JSON 출력으로 실행 (에이전트 소비용)
cli-anything-audacity --json project info -p project.json
REPL 모드
하위 명령어 없이 호출하면 CLI가 대화형 REPL 세션에 진입합니다:
cli-anything-audacity
# 탭 완성 및 기록과 함께 명령어를 대화형으로 입력
명령어 그룹
프로젝트
프로젝트 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
new | 새 프로젝트 생성 |
open | 기존 프로젝트 열기 |
save | 현재 프로젝트 저장 |
info | 프로젝트 정보 표시 |
settings | 프로젝트 설정 보기 또는 업데이트 |
json | 원시 프로젝트 JSON 출력 |
트랙
트랙 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add | 새 트랙 추가 |
remove | 인덱스로 트랙 제거 |
list | 모든 트랙 나열 |
set | 트랙 속성 설정 (이름, 음소거, 솔로, 볼륨, 팬) |
클립
클립 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
import | 오디오 파일 프로브/가져오기 (메타데이터 표시) |
add | 트랙에 오디오 클립 추가 |
remove | 트랙에서 클립 제거 |
trim | 클립의 시작 및/또는 끝 트리밍 |
split | 주어진 시간 위치에서 클립 분할 |
move | 클립을 새 시작 시간으로 이동 |
list | 트랙의 클립 나열 |
효과 그룹
효과 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
list-available | 사용 가능한 모든 효과 나열 |
info | 효과에 대한 세부 정보 표시 |
add | 트랙에 효과 추가 |
remove | 인덱스로 효과 제거 |
set | 효과 매개변수 설정 |
list | 트랙의 효과 나열 |
선택
선택 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
set | 선택 범위 설정 |
all | 모두 선택 (전체 프로젝트 기간) |
none | 선택 해제 |
info | 현재 선택 표시 |
레이블
레이블/마커 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add | 시간 위치에 레이블 추가 |
remove | 인덱스로 레이블 제거 |
list | 모든 레이블 나열 |
미디어
미디어 파일 작업입니다.
| 명령어 | 설명 |
|---|---|
probe | 오디오 파일 분석 |
check | 참조된 모든 오디오 파일이 존재하는지 확인 |
내보내기 그룹
내보내기/렌더링 명령어입니다.
| 명령어 | 설명 |
|---|---|
presets | 내보내기 프리셋 나열 |
preset-info | 프리셋 세부 정보 표시 |
render | 프로젝트를 오디오 파일로 렌더링 |
세션 그룹
세션 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
status | 세션 상태 표시 |
undo | 마지막 작업 실행 취소 |
redo | 마지막으로 취소된 작업 다시 실행 |
history | 실행 취소 기록 표시 |
예제
새 프로젝트 생성
새 Audacity 프로젝트 파일을 생성합니다.
cli-anything-audacity project new -o myproject.json
# 또는 프로그래밍 방식 사용을 위한 JSON 출력
cli-anything-audacity --json project new -o myproject.json
대화형 REPL 세션
실행 취소/다시 실행 지원으로 대화형 세션을 시작합니다.
cli-anything-audacity
# 명령어를 대화형으로 입력
# 사용 가능한 명령어를 보려면 'help' 사용
# 기록 탐색에는 'undo' 및 'redo' 사용
프로젝트 내보내기
프로젝트를 최종 출력 형식으로 내보냅니다.
cli-anything-audacity --project myproject.json export render output.pdf --overwrite
상태 관리
CLI는 다음을 통해 세션 상태를 유지합니다:
- 실행 취소/다시 실행: 최대 50단계의 기록
- 프로젝트 지속성: 프로젝트 상태를 JSON으로 저장/로드
- 세션 추적: 수정 사항 및 변경 사항 추적
출력 형식
모든 명령어는 이중 출력 모드를 지원합니다:
- 사람이 읽을 수 있는 (기본값): 표, 색상, 형식화된 텍스트
- 기계가 읽을 수 있는 (
--json플래그): 에이전트 소비를 위한 구조화된 JSON
# 사람용 출력
cli-anything-audacity project info -p project.json
# 에이전트용 JSON 출력
cli-anything-audacity --json project info -p project.json
AI 에이전트를 위해
이 CLI를 프로그래밍 방식으로 사용할 때:
- 항상
--json플래그를 사용하여 구문 분석 가능한 출력을 얻으세요 - 반환 코드를 확인하세요 - 성공 시 0, 오류 시 0이 아님
- 실패 시 오류 메시지를 위해 stderr를 구문 분석하세요
- 모든 파일 작업에 절대 경로를 사용하세요
- 내보내기 작업 후 출력이 존재하는지 확인하세요
추가 정보
- 전체 문서: 패키지의 README.md 참조
- 테스트 범위: 패키지의 TEST.md 참조
- 방법론: cli-anything-plugin의 HARNESS.md 참조
버전
1.0.0