APS (Ardule Pattern Studio) 사용자 매뉴얼

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

APS는 NanoArdule 프로젝트에 포함된 도구 중 하나로 배포된다.

APS는 드럼 패턴 중심 워크플로우를 위한 PC용 프로그램이다. 'APS_'로 시작하는 파이썬 프로그램 모음으로서 자체 정의한 2-bar 드럼 패턴 파일(ADT v2.2a)를 그리드 형태로 시각화하며 재생하고, 편집하며, 이를 조합하여 곡 단위의 정보를 만든다. ADT는 APS 안에서 bar 또는 스텝 단위로 편집하는 것이 원칙이나 텍스트 편집기로도 처음부터 새로 만들거나 편집해도 된다. 단, 후자의 경우 문법 오류에 주의해야 한다.

APS는 DAW가 아니며, 복잡한 오디오·미디 편집 환경을 지향하지 않으며, 비교적 단순하고 명확한 조작을 목표로 한다. 일정 수준 익숙해지면 아래 키맵만 인쇄해 두고도 충분히 사용할 수 있다.

https://github.com/jeong0449/NanoArdule/blob/main/APS/APS_Keymap_A4_2column.pdf

APS가 입력물로 사용하는 기본 단위는 패턴 파일(ADT)와 이를 APS 내에서 이를 조합하여 만든 arrangement file(ARR)이다.

• 447개의 샘플 패턴 파일(ADT): https://github.com/jeong0449/NanoArdule/tree/main/patterns/ADT/
• 35개의 원본 MIDI 파일과 이를 처리하여 얻은 각 패턴의 시각화 자료(PDF): https://github.com/jeong0449/NanoArdule/tree/main/patterns/original-midi-files/

아래 설치 방법대로 따라서 하면 자동으로 로컬 컴퓨터에 깔릴 것이다.

• ADT(Ardule Drum Pattern Text): 2마디 길이의 드럼 패턴 파일. half pattern(1마디 재생)은 데이터를 삭제하지 않고, 재생 범위를 1마디로 제한하는 방식(PLAY_BARS=1)으로 구현된다.
• ARR(Arrangement File): 여러 ADT 패턴을 순서대로 연결한 텍스트 파일. 곡 단위의 드럼 연주 구조(song form)를 정의하며, 라이브 연주용으로 사용할 수 있다.
• ADS(Ardule Data Stream): Arduino 기반 Nano Ardule 장치에서 사용하기 위한 바이너리 스트림 파일.

G, C 등의 단일 문자 명령은 기본적으로 대소문자를 구별하지 않는다. 그러나 반드시 시프트키를 같이 눌러서 대문자 형태로 입력해야만 하는 것도 있으니 주의를 요한다.

본 절에서는 Microsoft Store를 사용하지 않고, APS(aps_python.py 및 부속 스크립트)를 실행하기 위한 Windows 환경을 구축하는 방법을 설명한다. ADC toolchain(MIDI → ADT 파일)에 대해서도 동일하다.

설치 대상은 다음과 같다.

• PowerShell 7+
• Windows Terminal
• Python 3.11.6 (pip 포함)

1. PowerShell 7 설치 (MSI)
2. Windows Terminal 설치 (MSIX)
3. Windows Terminal에서 PowerShell 7을 기본 셸로 설정
4. Python 3.11.6 설치 (EXE)
5. 설치 및 연계 확인

설치 순서를 지키는 것이 중요하다.

GitHub 공식 릴리스 페이지:

• https://github.com/PowerShell/PowerShell/releases

PowerShell-7.x.x-win-x64.msi 파일을 다운로드한다.

MSI 실행 시 다음 옵션을 체크한다.

• [x] Add PowerShell to PATH (필수)
• [x] Register Windows Event Logging
• [ ] Enable PowerShell remoting (선택)

설치 완료 후 새 콘솔 창에서 확인:

pwsh --version

GitHub 공식 릴리스 페이지:

• https://github.com/microsoft/terminal/releases

Microsoft.WindowsTerminal_<version>_x64.msixbundle 파일을 다운로드한다.

방법 1: 파일 더블클릭 후 설치

방법 2: PowerShell에서 설치

Add-AppxPackage .\Microsoft.WindowsTerminal_*.msixbundle

1. Windows Terminal 실행
2. 상단 ▼ → Settings
3. Startup → Default profile
4. PowerShell (pwsh.exe) 선택
5. 저장

확인:

$PSVersionTable.PSVersion

공식 릴리스 페이지:

• https://www.python.org/downloads/release/python-3116/

Windows installer(python-3.11.6-amd64.exe 파일)을 다운로드한다.

설치 첫 화면에서 반드시 체크:

• [x] Add Python 3.11 to PATH
• [x] Install launcher for all users

Windows Terminal (PowerShell 7)에서:

python --version
pip --version

PowerShell을 실행하여 창을 연 뒤 다음 명령어를 입력한다.

git clone https://github.com/jeong0449/NanoArdule.git
cd .\NanoArdule\
pip install -r requirements.txt
cd .\APS\
mkdir patterns
cp ..\patterns\ADT\* .\patterns\

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 하나이다. APS 디렉토리에서 다음과 같이 입력한 뒤 엔터를 친다. 다른 스크립트들은 내부적으로 import되어 사용되며, 개별 실행은 지원하지 않는다.

python .\aps_main.py

프로그램 실행 후 화면은 상·하단 상태바와 3분할 영역으로 구성된다. 스페이스바를 누르면 왼쪽 패턴 목록에서 하이라이트된 패턴이 1회 재생된다. 정상적인 PC라면 Microsoft GS Wavetable Synth를 통해 소리가 날 것이다. USB를 통해 MIDI OUT에 다른 장비가 연결되어 있는 경우 그것이 우선적으로 선택된다. F6을 눌러서 MIDI OUT 장비를 바꿀 수 있다. 속도가 마음에 들지 않으면 F9를 눌러서 BPM을 조정한다. 반복 재생을 하려면 R('Repeat')을 눌러서 REPEAT:ON으로 만든 뒤 스페이스바를 누른다. 그러면 다시 스페이스바를 눌러야만 재생이 멈춘다. R을 다시 누르면 REPEAT:OFF로 되돌아온다.

패턴명의 첫 세 글자는 장르를 의미한다. 알파벳 순서로 표시되므로 스윙(SWG)을 로드하여 재생하려면 패턴 목록창에서 한참을 내려가야 한다. G('Genre')를 누르면 장르 목록창이 뜬다. 가장 패턴이 많은 장르 순서대로 표시된다. 원하는 패턴으로 이동하여 엔터를 치면 그 패턴만 표시된다. 전체 패턴을 전부 표시하려면 G를 눌러 패턴 선택창으로 진입한 뒤 맨 위의 ALL을 고르면 된다.

그리드 프리뷰의 점은 노트가 없음을 의미하며, 작은 사각형의 색깔은 3단계의 타격 강도이다. 빨강은 강, 노랑은 중간, 초록은 약이다. ADT 체계에서는 이를 각각 O, X, -로 표기한다.

화살표 또는 페이지업/다운키를 이용하여 패턴을 바꾸어 보라. Grid Preview에 표시된 패턴 다이어그램이 바뀔 것이다. 프로그램을 종료하려면 Q 또는 F10을 누른뒤 나타나는 대화창에서 YES를 선택한다. 축하한다!

• Cursor(커서): 현재 위치를 나타내는 이동 가능한 표시
• Focus(포커스): 현재 키 입력을 받는 영역
• Defocused 상태: 포커스를 잃은 영역, APS에서는 시안색으로 표시됨

패턴파일의 명칭은 RCK_P001.ADT의 형태이다. P는 일반적인 그루브, B는 브레이크, h는 half pattern(첫 마디만 활성화)이다. C('Change')를 누르면 P→B→h→P…를 순환한다. P와 B의 판단 기준은 사람에 따라 다를 수 있다. P로 표시되어 있지만 브레이크로 취급하는게 합리적이라고 생각한다면 B로 바꾸면 된다. 유형을 바꾸면 파일명과 내부의 'NAME='라인만 바뀔 뿐이다. 패턴 내용을 확인하려면 F4(Info)를 누른다. 문서 편집기에서 ADT 파일을 열어 보는 것과 같다.

half pattern은 패턴의 첫번째 마디만 활성화하여 한 마디만 쓰도록 하는 것이다. half로 전환된 패턴의 2nd bar는 그리드 프리뷰에서 하얗게 표시되며, 첫번째 마디만 재생된다. 뒤에서 설명하겠지만 패턴 체인을 만들 때 P(온전함) + P-half + B-half 순서로 배열하면 아주 전형적인 3 bar(동일마디 3회) + 1 bar(브레이크)의 프레이즈를 만들 수 있다.

C키를 누를 때마다 즉각적으로 패턴 파일명이 바뀌고, half pattern은 내부에 'PLAY_BARS=1'가 삽입된다.

한 패턴의 앞마디와 다른 패턴의 뒷마디를 연결하여 하이브리드 패턴을 만들 수 있다. 앞마디를 선택할 패턴으로 이동하여 B('hyBrid')를 누르면 패턴 번호 앞에 A가 표시된다. 다른 패턴으로 이동하여 또 B를 누르면 이번에는 B가 표시된다. 그 다음으로 Shift + B를 누르면 A:1st bar + B:2nd bar가 결합한 하이브리드 패턴이 만들어진다. 이 상태에서 Shift + B를 또 누르면 B:1st bar + A:2nd bar가 결합한 하이브리트 패턴이 된다. 이를 저장하려면 F7을 눌러라. 하이브리드 패턴의 기본 명칭은 HYB_P901.ADT이다. 장르 필터 모드라면 HYB로 시작하는 패턴이 보이지 않을 것이다. 따라서 ALL 또는 HYB 장르를 골라야 한다.

A와 B가 골라진 상태에서 제3의 패턴으로 이동하여 B를 누르면 A는 사라지고 기존의 B는 A로, 새로 고른 것은 B가 된다. A/B 표지를 없애려면 해당 패턴에서 B를 누르면 된다. 하이브리드를 만들었다고 하여 A/B 마킹이 저절로 사라지지는 않는다는 의미이다.

모든 패턴 두 개가 하이브리드 대상이 되지는 못한다. 둘 다 straight이거나, 동일한 트리플렛 구조(8T + 8T, 또는 16T + 16T여야 한다).

APS 내에는 패턴을 지우는 기능이 없다. 탐색기나 명령행에서 직접 삭제하기 바란다.

스텝시퀀서는 현재 선택된 패턴을 편집하고 저장하는 기능만 갖고 있다. 따라서 편집용 패턴 원본을 유지하려면 복사본을 먼저 만든뒤 이를 대상으로 편집을 실시하는 것이 안전하다. 가령 BAL_P001.ADT를 선택한 상태에서 F5(DupPat - Duplicate Pattern)을 누르면 900단위 번호의 BAL_P900ABC_P901.ADT로 즉시 복사된다. 만약 동일 장르에 대하여 _P901 패턴이 이미 존재한다면 자동으로 다음 번호(_P902)가 붙는다.

편집하려는 패턴을 선택한 상태에서 S('StepSeq')을 누르면 다음과 같이 첫번째 마디가 그리드 형태로 펼쳐진다. 화살표 또는 vi 에디터와 비슷하에 h/j/k/l 키를 이용하여 원하는 위치로 이동한 뒤 엔터를 눌러 보라. 노트가 없던 자리라면 노트가 삽입되고, 있던 자리라면 지워질 것이다.

타격 강도를 변화하려면 대문자 J(약하게), 또는 대문자 K(강하게)를 누른다. 마디를 전환하려면 [ 또는 ] 키를 누른다. 첨 마디의 편집 상태를 둘째 마디로 그대로 복사하려면 C를 누른다. 스페이스바를 누르면 재생이 이루어진다. 그러나 재생 엔진이 메인 창과는 다르기 때문에 정확한 템포는 아님에 유의하라.

스텝 시퀀서가 아니더라도 텍스트 편집기에서 ADT 파일을 수정할 수 있다. 단, 오리엔테이션에 주의해야 한다. APS 프로그램에서는 가로축이 시간(스텝)이고 사람의 시각에서는 이게 매우 자연스럽지만, ADT에서는 가로축은 악기(slot)에 해당한다. 따라서 각 줄(row)가 스텝에 해당하며, 프로그램 입장에서는 이것이 해석하기 자연스럽다. ADT에서는 ORIENTATION=STEP|SLOT으로 방향을 바꿀 수 있다.

곡 수준의 패턴 체인을 만들어서 섹션(intro, verse, chorus, bridge 등) 정보와 더불어 ARR(arrangement) 파일로 저장하는 일은 APS 기능의 '꽃'이라고 할 수 있다. 특히 섹션은 체인 편집을 더욱 편리하게 만든다.

체인을 만드는 가장 간단한 방법은 패턴 리스트 창에서 원하는 패턴으로 커서를 이동하여 엔터를 치는 것이다. 그러면 체인 리스트 창이 패턴이 추가된 순서대로 나열된다. 가장 마지막 패턴은 시안색으로 하이라이트된다. 동일한 패턴 위에서 엔터를 여러번 치면 xN이 표시된다. 아래 이미지의 패턴 체인 일련번호 옆 괄호 내 번호(b01, b03..)은 해당 패턴의 시작 위치를 마디 번호로 나타낸 것이다.

패턴 체인을 재생하려면 탭을 눌러서 포커스를 패턴 체인창으로 옮겨야 한다. 포커스가 옮겨지면서 패턴 리스트의 선택된 패턴(백색 반전)은 시안색으로 바뀌고, 패턴 체인창의 가장 마지막 패턴은 시안색에서 백색 반전으로 바뀐다. 스페이스바를 누르면 선택된 패턴부터 재생이 되므로, 커서를 맨 위 패턴으로 옮겨야 한다. 패턴 체인은 동일 패턴의 반복 외에는 순차적으로 재생됨을 의미한다. 카운트인을 맨 앞에 넣으려면 F8(CountIn)을 눌러서 CountIn_HH(closed hihat)을 선택하라.

F7(SaveARR) 또는 W키를 누르면 현재 만들어진 패턴 체인을 ARR 파일로 저장한다. 기본명은 SONG_001.ARR이며, .\patterns 디렉토리에 저장된다. 동일 번호의 ARR 파일이 있다면 자동으로 다음 번호를 제안한다.

Delet키는 하이라이트된 패턴의 삭제, Backspace키는 직전 패턴을 삭제한다. 패턴을 삽입하려면 커서를 원하는 패턴체인의 원하는 위치로 옮긴 뒤 탭을 눌러 포커스를 패턴 리스트 창으로 옮긴다. 삽입할 패턴을 선택한 뒤 엔터를 누르면 시안색으로 표시된 패턴의 다음에, O키를 누르면 그 앞에 삽입된다. 삽입된 패턴은 시안색으로 표시된다.

패턴 리스트 창에서 F2(Pat/ARR)을 누르면 패턴→ARR→패턴을 순환하면서 보여준다. 패턴과 마찬가지로 엔터를 치면 패턴체인으로 로드된다. 그러나 패턴 삽입과 마찬가지로 기존에 패턴체인이 있는 경우 그 위치에 ARR 전체를 삽입하는 것이 기본 동작이다. 따라서 필요하다면 패턴체인창의 패턴을 모두 지운 뒤 로드해야 한다. 패턴체인창을 한꺼번에 지우는 기능은 없다.

패턴체인에서 특정 패턴 위에 커서를 둔 뒤 V를 누르면 블록의 시작점이 지정된다. 화살표나 페이지키를 눌러서 블록의 끝 패턴까지 이동한 뒤 X를 누르면 블록 전체가 지워진다. Y('Yank')를 누르면 블록이 클립보드에 복사된다. 이어서 원하는 곳에 가서 P('Paste')를 쳐서 붙여넣는다. 하이라이트된 패턴의 앞 또는 뒤 어디에 붙여넣는지를 묻는 대화상자가 뜰 것이다.

블록이 설정된 상태에서 S를 누르면 섹션명을 입력할 수 있다.

섹션이 설정되면, 붙여넣기('P') 대화상자에서 섹션 목록도 표시되므로 편집 작업이 매우 손쉬워진다. 즉, 블록으로 지정하여 Yank를 하지 않아도 다른 곳에 붙여 넣을 수 있음을 뜻한다. F('Flush')를 누르면 클립보드에 저장된 것을 삭제한다.

섹션 내부의 아무 패턴이든 R을 누르면 섹션명이 삭제된다.

섹션 내에 패턴이나 ARR을 넣으면 '섹션_L'과 '섹션_R'로 분할된다. 불러온 ARR에 기존 패턴체인의 섹션과 같은 이름의 것이 있으면 일련번호가 뒤에 붙어서 구분된다.

모든 편집 사항은 Ctrl+Z(Undo)로 되돌릴 수 있다.