GitHub: https://github.com/jeong0449/NanoArdule

본 문서는 APS v2.2a 기준의 사용자 매뉴얼 초안이다. APS는 드럼 패턴을 편집·연결·재생·스트리밍하기 위한 패턴 중심 스튜디오이며, 본 문서는 기능 나열보다 이해 가능한 사용 흐름과 설계 의도를 설명하는 데 목적이 있다.

APS는 단일 디렉토리 실행 구조를 전제로 한다.

• 모든 Python 스크립트는 하나의 디렉토리에 위치해야 한다.
• 동일한 위치에 반드시 patterns/ 디렉토리가 존재해야 한다.
• patterns/ 아래에는 ADT / ARR / ADP 등의 패턴 파일이 위치한다.

예시 구조:

APS/
├─ aps_main.py
├─ aps_stepseq.py
├─ aps_playback.py
├─ aps_ui.py
...
└─ patterns/
   ├─ *.ADT
   ├─ *.ARR
   └─ *.ADP

사용자가 직접 실행하는 스크립트는 aps_main.py 하나이다.

python aps_main.py

다른 스크립트들은 내부적으로 import되어 사용되며, 개별 실행은 지원하지 않는다.

• Python 3.9 이상 권장 (가급적 파이썬 공식 웹사이트에서 받아서 설치할 것)
  • mido, python-rtmidi
• curses 지원 터미널 (Windows Terminal 권장)
• MIDI 출력 장치 또는 가상 MIDI 포트 (Windows에 기본 내장된 Microsoft GS Wavetable Synth로도 소리가 잘 남)

APS(Ardule Pattern Studio)는 드럼 패턴 중심 워크플로우를 위한 프로그램이다. 보다 쉽게 표현하자면, PC에서 돌아가는 파이썬 프로그램으로서 자체 정의한 2-bar 드럼 패턴 파일(ADT)를 열람하고, 이를 조합하여 곡 단위의 정보를 만들거나, 패턴 단위의 편집을 하는 작은 프로그램이다. 물론 재생 기능도 갖고 있다. ADT 파일은 공개된 포맷의 텍스트 파일로서 MIDI 파일로부터 드럼 패턴을 추출하여 만들거나(필요한 모든 스크립트 제공) APS 또는 텍스트 편집기로도 편집 가능하다. 샘플 패턴 파일은 GitHub에서 제공한다.

• 개별 드럼 패턴 편집 (ADT)
• 패턴 연결을 통한 곡 구조 작성 (ARR)
• 실시간 재생 및 스트리밍 (ADS)

APS는 DAW가 아니다. APS의 기본 단위는 패턴 파일이며, 모든 재생은 패턴의 조합으로 이루어진다.

• ADT: 1-bar 드럼 패턴 파일
• ARR: 여러 ADT를 연결한 체인
• ADS: 하드웨어 스트리밍용 결과물

메인 화면은 APS의 중심이다.

• 패턴 목록
• 선택된 패턴 강조
• 상태 메시지 표시

APS에서 모드란 다음을 의미한다.

• 현재 화면
• 허용되는 키 입력 집합

같은 키라도 모드에 따라 다른 동작을 한다.

• 1 bar 길이
• 16-step 해상도
• 악기별 드럼 레인

패턴은 파일이며 데이터이지, 재생 상태가 아니다.

• _P### : Main Pattern
• _B### : Break Pattern

C 키를 누르면 두 패턴이 전환된다.

_P001  <->  _B001

J / K 키로 액센트를 변경한다.

ARR은 여러 패턴을 연결한 곡 구조 파일이다.

카운트인은 특수 로직이 아니라 패턴으로 다루는 것이 권장된다.

• 1-bar CountIn 패턴
• 체인 맨 앞에 1회 삽입

APS는 즉각 반응보다 예측 가능한 타이밍을 우선한다.

초기 재생 시 약간의 지연은 정상 동작이다.

APS의 대화상자는 Norton Commander 스타일을 따른다.

• 테두리 박스
• 타이틀 없음
• 명확한 확인/취소

• 전역 상태 최소화
• 특수 로직 제거
• 패턴 중심 설계

카운트인은 sleep 기반이 아닌 패턴 기반이 권장된다.