1. 소개
2. 시작하기
5. CLI 도구 사용법
6. AIVA 워크플로우
7. 문제 해결
Parksy Audio는 AIVA 작곡 워크플로우를 위한 올인원 오디오 처리 도구입니다.
| 구성 요소 | 용도 | 접근 방법 | ||
| Android 앱 | 모바일에서 오디오 처리 | APK 설치 | ||
|---|---|---|---|---|
| Secret Office | 웹에서 도구 접근 및 APK 다운로드 | 브라우저 (PIN 필요) | ||
| CLI 도구 | PC/WD Passport에서 명령어 실행 | Python |
Android 앱:
CLI 도구 (PC):
1. 웹에서 시작: https://dtslib1979.github.io/parksy-audio/
2. Secret Office 접속: https://dtslib1979.github.io/parksy-audio/office/
3. PIN 입력: 1126
4. APK 다운로드 또는 CLI 도구 사용
1. Secret Office에서 Release APK (18.5MB) 다운로드
2. 다운로드된 APK 파일 실행
3. "알 수 없는 앱 설치" 허용
4. 설치 완료
앱 실행 시 첫 화면입니다.
오디오 파일의 길이를 조절합니다.
사용 방법:
1. "파일 선택" 버튼 탭
2. 트림할 오디오 파일 선택
3. 프리셋 선택: 30초 / 60초 / 120초 / 180초
4. "트림 시작" 버튼 탭
5. 결과 파일 저장
팁: AIVA는 3분(180초) 이하 파일을 권장합니다.
오디오를 MIDI로 변환합니다.
사용 방법:
1. "파일 선택" 버튼 탭
2. 변환할 오디오 파일 선택 (MP3/WAV)
3. "MIDI 변환" 버튼 탭
4. 변환 완료까지 대기 (1~2분)
5. MIDI 파일 저장
주의: 인터넷 연결이 필요합니다.
처리된 파일들을 관리합니다.
1. 브라우저에서 접속: https://dtslib1979.github.io/parksy-audio/office/
2. PIN 입력창이 나타남
3. PIN: 1126 입력
4. 패널 진입
방법 1: 로컬 PC 설치
cd D:\PARKSY\parksy-audio\local-engine
pip install -r requirements.txt
방법 2: WD Passport 설치
# install-to-wd.bat 실행
D:\PARKSY\parksy-audio\local-engine\install-to-wd.bat
python -m parksy_audio status
출력 예시:
📊 Parksy Audio Status
──────────────────────────────
FFmpeg: ✅ (8.0.1)
ffprobe: ✅
basic-pitch: ❌ (온라인 모드 사용)
requests: ✅
──────────────────────────────
API Status:
MIDI API: ✅ Online
──────────────────────────────
python -m parksy_audio info "파일경로.mp3"
출력 예시:
📄 File: song.mp3
────────────────────────────────────────
Size: 8.53 MB
Duration: 3:45 (225.0s)
────────────────────────────────────────
Suggested trim commands:
parksy trim "song.mp3" -d 30
parksy trim "song.mp3" -d 60
parksy trim "song.mp3" -d 120
parksy trim "song.mp3" -d 180
# 기본 (120초)
python -m parksy_audio trim "input.mp3"
# 60초로 트림
python -m parksy_audio trim "input.mp3" -d 60
# 시작 지점 지정 (30초부터 60초 구간)
python -m parksy_audio trim "input.mp3" -s 30 -d 60
# 출력 파일 지정
python -m parksy_audio trim "input.mp3" -d 120 -o "output.wav"
# MP3 포맷으로 출력
python -m parksy_audio trim "input.mp3" -d 120 -f mp3
# 온라인 변환 (Cloud Run API)
python -m parksy_audio convert "input.mp3" --online
# 출력 파일 지정
python -m parksy_audio convert "input.mp3" --online -o "output.mid"
# 오프라인 변환 (basic-pitch 필요)
python -m parksy_audio convert "input.mp3" --offline
# WAV로 변환 (AIVA 호환)
python -m parksy_audio towav "input.mp3"
# MP3로 변환
python -m parksy_audio tomp3 "input.wav"
# 비트레이트 지정
python -m parksy_audio tomp3 "input.wav" -b 320k
# 폴더 내 모든 파일 처리
python -m parksy_audio batch ./input-folder
# 옵션 지정
python -m parksy_audio batch ./input-folder -d 60 -f mp3 -o ./output-folder
| 명령어 | 설명 | 주요 옵션 | ||
| `status` | 시스템 상태 확인 | - | ||
|---|---|---|---|---|
| `info` | 파일 정보 표시 | - | ||
| `trim` | 오디오 트리밍 | `-d` 길이, `-s` 시작점, `-f` 포맷 | ||
| `convert` | MIDI 변환 | `--online`, `--offline` | ||
| `towav` | WAV 변환 | `-o` 출력 경로 | ||
| `tomp3` | MP3 변환 | `-b` 비트레이트 | ||
| `batch` | 배치 처리 | `-d`, `-f`, `-o` |
원본 오디오 (긴 파일)
↓
[1] 트림 (120초 이하)
↓
[2] WAV 변환 (선택)
↓
[3] MIDI 변환
↓
[4] AIVA 업로드
↓
AI 작곡 완료!
# AIVA 권장: 120초 (2분)
python -m parksy_audio trim "원본.mp3" -d 120
python -m parksy_audio convert "원본_trim_120s.wav" --online
1. https://aiva.ai 접속
2. "Compose" → "From influence"
3. 생성된 MIDI 파일 업로드
4. 스타일/장르 선택
5. "Generate" 클릭
| 항목 | 권장값 | 이유 | ||
| 길이 | 60~120초 | AIVA 처리 최적화 | ||
|---|---|---|---|---|
| 포맷 | WAV | 무손실 품질 | ||
| 샘플레이트 | 44100Hz | 표준 CD 품질 |
A: FFmpeg를 설치해주세요.
A:
1. 인터넷 연결 확인
2. API 상태 확인: python -m parksy_audio status
3. 파일 크기가 너무 크면 먼저 트림
A:
A:
1. "알 수 없는 앱 설치" 허용
2. 설정 → 보안 → 출처를 알 수 없는 앱 허용
| 오류 | 원인 | 해결 | ||
| `FFmpeg not found` | FFmpeg 미설치 | FFmpeg 설치 및 PATH 추가 | ||
|---|---|---|---|---|
| `Timeout` | 서버 응답 지연 | 재시도 또는 파일 크기 줄이기 | ||
| `SSL Error` | 네트워크 문제 | VPN 확인, 인터넷 연결 확인 | ||
| `API Error 500` | 서버 오류 | 잠시 후 재시도 |
Parksy Audio - AIVA 작곡을 위한 최고의 오디오 도구