PyCodeDJ マニュアル

Python コードを書く。保存する。音が変わる。

1. PyCodeDJ とは

PyCodeDJ は Python のソースコードをライブ演奏に変換するツールです。ファイルを AST 解析し、@loop が付いた関数の構造と dj.* のメタ情報を読み取って SuperCollider に OSC を送ります。

from pycodedj import dj, loop

@loop(interval=2.0)
def bass():
    dj.volume = 0.4
    for i in range(8):
        if i % 2 == 0:
            pass

@loop(synth="kick_floor", beat=0.25)
def kick():
    dj.volume = 0.8
    dj.pattern = "x . x ."

関数名がループ名になります。pycodedj eval demo.py::bass のように指定します。

2. インストールと起動

pip install 'pycodedj[watch]'

SuperCollider IDE で sc/synths.scd を実行し、次の表示を確認します。

PyCodeDJ synths loaded. Ready. OSC port: 57120

pycodedj eval examples/demo.py::bass

3. ループの基本構文

from pycodedj import dj, loop

@loop(interval=1.0)
def loop_name():
    dj.volume = 0.3
    dj.eq = "flat"
    pass

@loop(interval=0.25)
def hats():
    dj.volume = 0.08
    dj.eq = "edm"
    dj.low = 0.5
    dj.high = 1.25

4. コード構造マッピング

dj.pattern がないループでは、関数本体の形が音になります。

5. dj.pattern でリズムと音程を指定する

@loop(synth="bass_acid", root="A1", scale="minor", beat=0.25)
def bass():
    dj.volume = 0.35
    dj.pattern = "0 . [0 3] ~ 5 . 3 ."

dj.pattern = p1 のような変数参照は読み取りません。パターン文字列はループ本体に直接書いてください。

6. 複数ループ

@loop(synth="kick_floor", beat=0.25)
def kick():
    dj.volume = 0.8
    dj.pattern = "x . x ."

@loop(interval=4.0)
def pad():
    dj.volume = 0.08
    # 広い空間
    pass

pycodedj watch examples/demo.py

7. 音色リファレンス

synth= に SuperCollider の音色名を指定します。関数名はループ名のままで、synth= は鳴らす音色だけを選びます。

@loop(synth="bass_acid", root="A1", scale="minor", beat=0.25)
def acid():
    dj.volume = 0.25
    dj.pattern = "0 . 3 . 5 ."

全音色を 1 つずつ試聴:

pycodedj eval examples/sound_showcase.py::kick_floor
pycodedj eval examples/sound_showcase.py::bass_acid
pycodedj eval examples/sound_showcase.py::lead_acid

Kick

Bass

Percussion

Chords / Stabs

Leads / Notes

Atmosphere / FX

8. CLI リファレンス

pycodedj eval FILE::LOOP
pycodedj watch examples/demo.py
pycodedj panic
pycodedj stop bass
pycodedj mute bass
pycodedj unmute bass

9. トラブルシューティング

音が出ない場合は SuperCollider を boot し、sc/synths.scd を実行し、OSC port を確認してください。

loop not found の場合、:: の後ろが Python の関数名と一致しているか確認してください。

10. 内部構成

PyCodeDJ は Python ソースを ast で解析します。loop, dj, pattern は通常 import できる実行時ヘルパーです。