cli-anything-obs_studio
OBS Studio 씬 컬렉션 편집을 위한 상태 기반 명령줄 인터페이스로, Blender CLI 도구 모음과 동일한 패턴을 따릅니다. JSON 형식의 씬 컬렉션을 사용하며, 편집을 위해 OBS Studio가 설치되어 있을 필요는 없습니다.
설치
이 CLI는 cli-anything-obs_studio 패키지의 일부로 설치됩니다:
pip install cli-anything-obs_studio
사전 요구 사항:
- Python 3.10+
- 시스템에 obs_studio가 설치되어 있어야 함
사용법
기본 명령어
# 도움말 보기
cli-anything-obs_studio --help
# 대화형 REPL 모드 시작
cli-anything-obs_studio
# 새 프로젝트 생성
cli-anything-obs_studio project new -o project.json
# JSON 출력으로 실행 (에이전트용)
cli-anything-obs_studio --json project info -p project.json
REPL 모드
하위 명령어 없이 호출하면 대화형 REPL 세션이 시작됩니다:
cli-anything-obs_studio
# 탭 완성 및 기록 기능과 함께 명령어를 대화형으로 입력
명령어 그룹
프로젝트 (Project)
프로젝트 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
new | 새 OBS 씬 컬렉션 생성 |
open | 기존 프로젝트 열기 |
save | 현재 프로젝트 저장 |
info | 프로젝트 정보 표시 |
json | 원시 프로젝트 JSON 출력 |
씬 (Scene Group)
씬 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add | 새 씬 추가 |
remove | 인덱스로 씬 제거 |
duplicate | 씬 복제 |
set-active | 활성 씬 설정 |
list | 모든 씬 나열 |
소스 (Source Group)
소스 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add | 씬에 소스 추가 |
remove | 인덱스로 소스 제거 |
duplicate | 소스 복제 |
set | 소스 속성 설정 (이름, 표시 여부, 잠금, 불투명도, 회전) |
transform | 소스 변환 (위치, 크기, 자르기, 회전) |
list | 씬의 모든 소스 나열 |
필터 (Filter Group)
필터 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add | 소스에 필터 추가 |
remove | 소스에서 필터 제거 |
set | 필터 매개변수 설정 |
list | 소스의 모든 필터 나열 |
list-available | 사용 가능한 모든 필터 유형 나열 |
오디오 (Audio Group)
오디오 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add | 글로벌 오디오 소스 추가 |
remove | 글로벌 오디오 소스 제거 |
volume | 오디오 소스의 볼륨 설정 (0.0-3.0) |
mute | 오디오 소스 음소거 |
unmute | 오디오 소스 음소거 해제 |
monitor | 오디오 모니터링 유형 설정 |
list | 모든 오디오 소스 나열 |
전환 (Transition Group)
전환 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
add | 전환 추가 |
remove | 전환 제거 |
set-active | 활성 전환 설정 |
duration | 전환 시간(밀리초) 설정 |
list | 모든 전환 나열 |
출력 (Output Group)
출력/스트리밍/녹화 설정입니다.
| 명령어 | 설명 |
|---|---|
streaming | 스트리밍 설정 구성 |
recording | 녹화 설정 구성 |
settings | 출력 설정 구성 |
info | 현재 출력 설정 표시 |
presets | 사용 가능한 인코딩 프리셋 나열 |
세션 (Session)
세션 관리 명령어입니다.
| 명령어 | 설명 |
|---|---|
status | 세션 상태 표시 |
undo | 마지막 작업 실행 취소 |
redo | 마지막으로 취소한 작업 다시 실행 |
history | 실행 취소 기록 표시 |
예제
새 프로젝트 생성
새 obs_studio 프로젝트 파일을 생성합니다.
cli-anything-obs_studio project new -o myproject.json
# 또는 프로그래밍 방식 사용을 위한 JSON 출력
cli-anything-obs_studio --json project new -o myproject.json
대화형 REPL 세션
undo/redo를 지원하는 대화형 세션을 시작합니다.
cli-anything-obs_studio
# 명령어를 대화형으로 입력
# 사용 가능한 명령어를 보려면 'help' 입력
# 내역 탐색에는 'undo'와 'redo' 사용
상태 관리
CLI는 다음을 포함한 세션 상태를 유지합니다:
- 실행 취소/다시 실행 (Undo/Redo): 최대 50단계의 히스토리
- 프로젝트 영속성: JSON으로 프로젝트 상태 저장/불러오기
- 세션 추적: 수정 및 변경 사항 추적
출력 형식
모든 명령어는 이중 출력 모드를 지원합니다:
- 사람이 읽기 쉬운 형식 (기본값): 표, 색상, 서식이 지정된 텍스트
- 기계가 읽기 쉬운 형식 (
--json플래그): 에이전트 사용을 위한 구조화된 JSON
# 사람이 읽는 출력
cli-anything-obs_studio project info -p project.json
# 에이전트용 JSON 출력
cli-anything-obs_studio --json project info -p project.json
AI 에이전트를 위한 안내
이 CLI를 프로그래밍 방식으로 사용할 때:
- 항상
--json플래그를 사용하여 구문 분석 가능한 출력을 얻으십시오. - 반환 코드를 확인하십시오. 0은 성공, 0이 아닌 값은 오류입니다.
- stderr를 파싱하여 오류 발생 시 오류 메시지를 확인하십시오.
- 모든 파일 작업에는 절대 경로를 사용하십시오.
- 내보내기 작업 후 출력이 존재하는지 확인하십시오.
추가 정보
- 전체 문서: 패키지 내 README.md 참조
- 테스트 범위: 패키지 내 TEST.md 참조
- 방법론: cli-anything-plugin의 HARNESS.md 참조
버전
1.0.0