@parksy_bridges_bot 사용 매뉴얼

버전: v2.4 | 최종 갱신: 2026-03-18

봇 핸들: `@parksy_bridges_bot`

---

이 봇이 하는 일

오디오/MIDI 파일이나 YouTube 연주 영상 URL을 보내면 자동으로 편곡·마스터링·M4A 변환까지 처리한다.

원하면 YouTube에도 바로 올려준다.

파일 드랍 또는 YouTube URL 전송
    ↓
봇이 파이프라인 자동 실행 (전사 → 편곡 → 렌더 → 마스터링)
    ↓
완성된 M4A 파일을 텔레그램으로 전송
    ↓
/approve 입력하면 YouTube 비공개 업로드

---

접근 권한

봇은 아무나 쓸 수 없다. 박씨(관리자)가 직접 슬롯을 열어줘야 한다.

	권한	가능한 것
	**어드민 (박씨)**	파일 드랍 + YouTube URL + 모든 명령어
	**슬롯 유저 (초대된 사람)**	파일 드랍만
	**그 외**	접근 불가

슬롯은 최대 3명. 접근 요청은 박씨에게 Telegram ID 알려주면 된다.

내 Telegram ID 확인: @userinfobot 에게 /start 보내면 나옴.

---

사용법 — Track A: 파일 드랍

지원 형식

	형식	확장자
	오디오	`.wav` `.mp3` `.m4a` `.flac` `.ogg`
	MIDI	`.mid` `.midi`
	음성 메모	Telegram 음성 메시지

텔레그램에서 파일을 문서(File)로 전송해야 한다. 사진/동영상으로 보내면 안 된다.

캡션으로 스타일 지정 (선택)

파일 전송할 때 캡션에 키워드를 쓰면 스타일을 지정할 수 있다. 없으면 기본값.

감정 프리셋 (하나만 선택):

	키워드	효과
	`elegy`	애수 — 슬프고 서정적
	`triumph`	승리 — 웅장하고 힘찬
	`nocturne`	야상 — 조용하고 몽환적
	`epic`	장대 — 스케일 크고 극적
	`pastoral`	목가 — 맑고 자연스러운

작곡가 스타일 (복수 가능):

	키워드	효과
	`bruckner`	두껍고 웅장한 화성
	`mahler`	복잡하고 감정적인 구조
	`faure`	섬세하고 인상파적

예시:

파일: nocturne.wav
캡션: elegy faure
→ 애수 감정 + Fauré 스타일

---

사용법 — Track B: YouTube URL (어드민 전용)

텍스트 메시지로 YouTube URL을 보내면 자동으로 오디오를 추출해서 파이프라인을 돌린다.

https://www.youtube.com/watch?v=xxxxx elegy faure

• URL 한 줄만 보내도 되고, URL 옆에 감정/스타일 키워드를 같이 써도 된다
• 파일 드랍과 완전히 동일한 파이프라인 실행
• **연주 전용 영상 (보컬 없는 것)** 을 타겟으로 할 것 — 클린 소스일수록 품질이 높다

권장 소스:

• 피아노 솔로 커버 채널
• 클래식 앙상블 연주
• 반주 트랙 (karaoke instrumental)

---

처리 진행 상황

파일/URL을 보내면 즉시 시작한다.

⚙️ 파이프라인 실행 중...

30초마다 현재 단계가 업데이트된다. 파일 길이에 따라 보통 2~10분 소요.

내부 처리 단계:

[L0] YouTube 다운로드 (URL 입력 시)
[L1] 소스 분리     — Demucs (--separate 플래그 시)
[L2] 전사          — 오디오 → MIDI (basic-pitch)
[L3] 편곡          — 감정 아크 + Markov 화음 진행
[L4] 스타일        — Bruckner/Mahler/Fauré 화성 적용
[L5] 인간화        — 루바토·페달·미세 타이밍
[L6] 렌더          — FluidSynth + EQ/Comp 마스터링
[L7] 채점          — 품질 자동 평가 (90점 미만이면 경고)

---

M4A 파일 받기

처리가 끝나면 M4A 파일을 텔레그램 오디오로 보내준다.

• **50MB 이하**: 텔레그램에서 바로 재생 가능
• **50MB 초과**: 파일 크기 초과, 파일 경로만 안내

---

YouTube 업로드 (어드민 전용)

M4A를 들어보고 마음에 들면:

/approve

자동으로 처리된다:

1. M4A → MP4 변환 (검정 배경 1280×720)

2. YouTube 계정 A 비공개 업로드

3. 완료 후 YouTube URL 전송

업로드 후 YouTube Studio에서 공개로 바꾸면 된다.

---

명령어 (어드민 전용)

	명령어	설명
	`/start`	봇 소개 + 명령어 목록
	`/approve`	마지막 결과물 YouTube 업로드
	`/upload`	`/approve`와 동일
	`/status`	현재 작업 상태 확인
	`/stop`	진행 중인 작업 중단
	`/new`	Claude 대화 세션 초기화
	`/render [설명]`	Claude에게 렌더링 지시
	`/queue`	작업 큐 확인
	`/score [설명]`	악보 처리 상태 확인
	`/slots`	현재 슬롯 목록
	`/addslot USER_ID 이름`	슬롯 추가
	`/rmslot USER_ID`	슬롯 제거

---

슬롯 관리 (어드민)

/addslot 123456789 홍길동
/rmslot 123456789
/slots

상대방 Telegram ID: @userinfobot에게 /start 보내면 확인 가능.

---

텍스트로 Claude에게 직접 지시 (어드민)

YouTube URL이 아닌 일반 텍스트는 Claude Code가 직접 처리한다.

"outputs 폴더에 있는 m4a 파일 목록 보여줘"
"현재 optimal_config.json 내용 알려줘"
"nocturne.mid elegy faure로 렌더링해줘"

---

문제 해결

봇이 응답 안 할 때

1. @parksy_bridges_bot 에 /start 보내기

2. 안 되면 박씨에게 연락

처리가 너무 오래 걸릴 때

• 파일이 길수록 오래 걸린다 (10분+)
• 30분 넘으면 뭔가 문제. 박씨에게 알려주기

M4A 파일이 안 나올 때

• 파일 형식 확인 (위 지원 형식 표 참고)
• YouTube URL이면 연주 전용 영상인지 확인 (보컬 혼합 영상은 품질 저하 가능)

---

YouTube 업로드 세부 정보

	항목	값
	업로드 계정	dimas.thomas.sancho@gmail.com (계정 A)
	기본 공개 범위	**비공개**
	카테고리	음악

자동 생성 설명란:

🎹 {제목}

♫ Public Domain classical music
♫ Rendered with FluidSynth + SoundFont
♫ PARKSY Audio Pipeline

⚖️ No copyright claimed. Free to use.

#ASMR #Piano #ClassicalMusic #PublicDomain #Parksy

---

작성: 2026-03-18 | @parksy_bridges_bot v2.4

← Back to Document Library · PARKSY Audio