| C Am | F G | と書けば、鳴る。
ChordScript は、コード進行をテキストで書いて再生するための小さな言語です。このページでは書き方をひと通り説明します。例の下にある「エディタで試す」を押すと、その例が新しいファイルとしてエディタに開きます。
01まずは鳴らしてみる
コード名をスペースで区切って並べるだけで、1つのコードが1小節ずつ鳴ります。エディタで Ctrl+Enter(Mac は ⌘+Enter)を押すか、右上の「実行」ボタンで再生、Esc で停止です。
C Am F G
はじめて音を出すときは、ブラウザの仕様でボタンかキー操作が必要です。音が出ないときは、端末のマナーモードと音量スライダーを確認してください。
02小節と長さ
小節線 | で区切る
| と | の間が1小節です。1小節に複数のコードを書くと、その小節を均等に分けます。4拍子で2つなら2拍ずつ、4つなら1拍ずつです。
| C G | Am Em | F | G |
空白の数は自由です。そろえておくと読みやすくなります。
拍数を指定する :
コードの後ろに :数字 を付けると、その拍数だけ鳴らします。指定のないコードは、残りの拍を均等に分けます。
| C:3 G:1 | Am:1 G F |
伸ばす・繰り返す・休む
| 記号 | 意味 | 例 |
|---|---|---|
| - | 前のコードをそのまま伸ばす(鳴らし直さない) | | C | - | |
| % | 前のコードをもう一度鳴らす | | Am | % | |
| _ | 休符。N.C. と書いても同じ | | C:3 _:1 | |
| x2 | 行末に置くと、その行を丸ごと繰り返す | | C | G | x2 |
| F | - | G | % | x2 | C:3 _:1 |
小節線を書かない行では、1コードがそのまま1小節になります。C:2 G:2 のように拍数を付けると、その長さの小節になります。
03コードの種類
コード名は「ルート音」+「種類」で書きます。ルート音は C D E F G A B の大文字で、# や b を付けられます(F#、Bb)。種類は次の表のとおりです。右の列は、よく使われる別の書き方で、どれでも同じように認識します。
| 書き方 | 名前 | C での構成音 | 別の書き方 |
|---|---|---|---|
| C | メジャー | C E G | CM, Cmaj |
| Cm | マイナー | C E♭ G | Cmin, C- |
| C7 | セブンス | C E G B♭ | |
| Cmaj7 | メジャーセブンス | C E G B | CM7, C△7, CΔ7, C△ |
| Cm7 | マイナーセブンス | C E♭ G B♭ | Cmin7, C-7 |
| CmM7 | マイナーメジャーセブンス | C E♭ G B | Cm(maj7), Cm△7 |
| C6 / Cm6 | シックス | C E G A | |
| Csus4 | サスフォー | C F G | Csus |
| Csus2 | サスツー | C D G | |
| C7sus4 | セブンス・サスフォー | C F G B♭ | C7sus |
| Cdim | ディミニッシュ | C E♭ G♭ | Co, C° |
| Cdim7 | ディミニッシュセブンス | C E♭ G♭ A | Co7, C°7 |
| Cm7b5 | ハーフディミニッシュ | C E♭ G♭ B♭ | Cm7-5, Cm7(b5), Cø |
| Caug | オーギュメント | C E G♯ | C+ |
| Caug7 | オーギュメントセブンス | C E G♯ B♭ | C+7, C7#5 |
| Cadd9 / Cmadd9 | アドナインス | C E G D | Cadd2 |
| C9 / Cmaj9 / Cm9 | ナインス | C E G B♭ D | C7(9), CM9 |
| C69 | シックスナインス | C E G A D | |
| C7b9 / C7#9 | オルタード・テンション | C E G B♭ D♭ | C7(b9), C7(#9) |
| C7b5 / C7#11 | ♭5 / ♯11 | C E G♭ B♭ | C7-5 |
| Cmaj7#11 | メジャーセブンス♯11 | C E G B F♯ | CM7#11 |
| C11 / Cm11 | イレブンス | C G B♭ D F | |
| C13 | サーティーンス | C E B♭ D A | |
| C5 | パワーコード | C G |
分数コード(オンコード)
/ の後ろにベース音を書きます。C/E は「ベースが E の C」です。右側のパネルの鍵盤では、ベース音は緑色で表示されます。
| C G/B | Am Am/G | F C/E | Dm7 G7 |
04度数で書く
コード名の代わりに、キーの主音から数えたローマ数字(度数)でも書けます。key で決めたキーを基準に、実際のコードへ変換されます。度数で書いておけば、key を書き換えるだけで曲全体を転調できます。
| ルール | 例(key C) |
|---|---|
| 大文字はメジャー、小文字はマイナー | I → C vi → Am |
| 種類は後ろに付ける。小文字なら自動でマイナー系になる | ii7 → Dm7 V7 → G7 IVmaj7 → Fmaj7 |
o はディミニッシュ、ø はハーフディミニッシュ | viio → Bdim viiø7 → Bm7b5 |
| 臨時記号は前に付ける | bVII → B♭ bVI → A♭ #IVm7b5 → F#m7b5 |
| 分数コードのベースも度数で書ける | I/III → C/E V/VII → G/B |
セカンダリードミナントは V7/行き先 | V7/ii → A7 V7/V → D7 viio7/V → F#dim7 |
key C | IVmaj7 | V7 | iii7 | vi | key E | IVmaj7 | V7 | iii7 | vi |
V7/ii のように V や vii に種類(7 や o)が付いているときはセカンダリードミナントとして読みます。V/VII のように種類がない三和音のときは、分数コード(ベース指定)として読みます。マイナーキーの場合
key Am のようにマイナーキーにすると、度数は自然短音階を基準にします。III は C、VI は F、VII は G です。ドミナントを強くしたいときは、V7(E7)のように大文字で書きます。
key Am | i | VI | III | VII | | iv7 | V7 | i | - |
エディタでは Alt+D を押すと、カーソルのある行のコード名と度数を相互に変換できます。
05テンポ・キー・音色
行の先頭にキーワードを書くと設定を変えられます。設定はその行から下に効きます。曲の途中に書けば、そこからテンポや音色が変わります。
| 書き方 | 意味 | 指定できる値 | 最初の値 |
|---|---|---|---|
| tempo 96 | テンポ(1分あたりの拍数)。bpm でも可 | 20〜320 | 100 |
| key Am | キー。度数表記の基準 | C F# Bb Am C#m など | C |
| meter 3 | 1小節の拍数。3/4 と書いても可 | 1〜16 | 4 |
| sound pad | 音色 | epiano エレピ / piano ピアノ / pad パッド / organ オルガン / pluck プラック | epiano |
| style arp | 奏法 | block 和音をのばす / strum ギター風にずらす / arp 8分のアルペジオ / pulse 8分で刻む | strum |
| bass off | ベース音 | on / off | on |
tempo 72 meter 3 sound piano style arp | C | Am | Dm7 | G7 | // ここから音色と奏法が変わる sound organ style block | F | G | C | - |
// から行末まではコメントで、音には影響しません。
06セクションと play
イントロ、Aメロ、サビのようなまとまりに名前を付けて、あとから呼び出せます。セクションを定義しただけでは鳴りません。play で呼んだときに鳴ります。
1行で書く: 名前 = …
複数行で書く: 名前 { … }
{ は名前と同じ行の最後に、} は独立した行に書きます。名前は英字で始まる英数字(- と _ も可)です。
呼び出す: play
play の後ろに名前を並べると、その順番で鳴ります。名前の後ろの x2 はそのセクションを2回、verse*2 と書いても同じです。
tempo 100 key G intro = | IVmaj7 | V | verse { | I | V/VII | vi | iii | | IV | I/III | ii7 | V7 | } chorus = | IV | V | iii7 | vi | play intro verse chorus x2
- セクションの外に書いた進行は、上から順番に、
playと同じ流れの中で鳴ります。 - セクションは、
playより後ろで定義しても呼び出せます。 playの前にkeyを変えると、度数で書いたセクションは新しいキーで鳴ります。- セクションの中にセクションは作れません。セクションの中で別のセクションを
playすることはできます。 - 左側の「アウトライン」に、セクションの一覧と小節数が出ます。クリックすると定義した行へ移動します。
07テンプレートとフォルダ
よく使う進行をセクションとして1つのファイルにまとめておき、別のファイルから import で読み込んで使えます。これがテンプレートです。
テンプレートを作る
ふつうのファイルにセクションを書くだけです。度数で書いておくと、呼び出す側の key に合わせて移調されるので、どの曲でも使い回せます。サンプルとして templates/pop.chord と templates/jazz.chord が入っています。
// templates/pop.chord oudou = | IVmaj7 | V7 | iii7 | vi | ending = | IV | V7sus4 V7 | I | - | // 単体で試すとき用。import した側では鳴りません key C play oudou ending
別のファイルで呼び出す
ファイルの先頭で import "パス" と書くと、そのファイルのセクションが ファイル名.セクション名 で呼べるようになります。
import "templates/pop.chord" import "templates/jazz.chord" as jz key E play pop.oudou x2 pop.ending key Bb play jz.two-five jz.turnaround
| 書き方 | 意味 |
|---|---|
| import "templates/pop.chord" | このファイルから見た場所でファイルを指定。pop.〜 で呼べる |
| import "../lib/pop" | .. で1つ上の階層。.chord は省略できる |
| import "/templates/pop" | 先頭の / は、いちばん上の階層から数える |
| import "…" as jz | 呼び出し名を付ける(jz.〜 で呼べる)。ファイル名に日本語や数字始まりなど、そのまま名前に使えない文字があるときは必須 |
- 読み込まれるのはセクションだけです。テンプレート側でセクションの外に書いた設定や進行、
playは、読み込んだ側では無視されます。 - テンプレートのセクションの中に
keyやsoundを書いた場合は、呼び出したときにそれが効きます。 - テンプレートの中でさらに別のファイルを
importすることもできます。お互いを読み込み合う(循環する)とエラーになります。 importのパスやplay pop.oudouを Ctrl+クリックすると、読み込み先のファイルやセクションの定義へ移動します。左の「アウトライン」には読み込んだセクションも出ます。import "まで打つと、ファイルの候補が出ます。
フォルダを作る
左のエクスプローラーの上にあるボタンで、ファイルとフォルダを作れます。
| 操作 | やり方 |
|---|---|
| フォルダを作る | フォルダの形のボタン。選択中のフォルダの中に作られます(選択中のフォルダは名前がオレンジ色になります)。いちばん上に作るときは「エクスプローラー」の文字をクリックしてから |
| フォルダの中にファイルを作る | フォルダをクリックして選んでから、ファイルの形のボタン |
| 開く・閉じる | フォルダをクリック |
| 名前を変える | ダブルクリック。ファイル名を templates/pop のように / 付きで入力すると、そのフォルダへ移動します(なければ作られます) |
| ファイルを移動する | ファイルをフォルダへドラッグ。いちばん上に戻すときは一覧の空いている所へドロップ |
| 削除する | 「✕」を2回押す。フォルダの場合は中のファイルもまとめて削除されます |
import しているほかのファイルのパスも自動で直ります。スマホでは、エディタ上部のファイル選択から「+ 新しいフォルダ」を選びます。
08エディタの機能
補完
コードを打ち始めると候補が出ます。D と打つと、今のキーに合う Dm Dm7 が先頭に並びます。↑ ↓ で選んで Tab か Enter で確定です。候補を選ぶたびに音が鳴ります(右下の「試聴」で切り替えられます)。何も打っていない場所で Ctrl+Space を押すと、次に来そうなコードの候補が出ます。
次のコード予測
進行の行でコードのあとにスペースを打つと、次に来そうなコードが薄い文字で出ます。Tab で確定、Alt+] と Alt+[ でほかの候補に切り替えます。Tab を続けて押すと、進行を続けて書いていけます。セブンスコードのあとは、解決先のコードが優先されます。
エラー表示
読めないコードや未定義のセクションには赤い波線が付き、下の「問題」パネルに理由が出ます。クリックするとその場所へ移動します。エラーのある部分は飛ばして、それ以外は再生できます。
再生中の表示と、書き換えながらの再生
再生中は、鳴っているコードがエディタ上で光り、右側に構成音と鍵盤が出ます。ループ再生中に書き換えると、次のループの頭から新しい内容に切り替わります。ただしエラーが残っている間は、前の内容のまま鳴り続けます。
右側のパネル
カーソルを置いたコードや再生中のコードについて、度数、機能(トニック/サブドミナント/ドミナント/借用など)、構成音を表示します。下のコード譜は小節ごとの一覧で、小節をクリックするとそこから再生します。
ファイル
左の一覧で、複数のファイルを切り替えられます。「+」を押すとその場でファイル名を入力できます(.chord は自動で付きます)。あとから変えるときは、エディタ上部の「名前変更」ボタン、F2、または一覧のファイル名をダブルクリックします。「✕」を2回押すと削除です。内容はこのブラウザの中に自動で保存されます。サーバーには送られないので、別の端末やブラウザには引き継がれません。残しておきたいものは「コピー」ボタンで書き出しておいてください。
09ショートカット
Mac では Ctrl の代わりに ⌘ も使えます。
Alt+↑ を key の行で押すと、キーそのものが半音ずつ変わります。度数で書いた部分はそれに合わせて全部移調されます。
10よくあるエラー
| メッセージ | よくある原因と直し方 |
|---|---|
| 不明なコードの種類「…」です | 種類の綴りが表にないものです。Cmaj7 のつもりで Cmj7 と打っていないか確認してください。対応しているコードの種類を参照。 |
| 「verse」をコードとして解釈できません | セクション名を進行の行に直接書いています。play verse と書きます。 |
| セクション「…」は定義されていません | play の名前と定義の名前が一致していません。大文字小文字も区別されます。 |
| 「}」で閉じられていません | { に対応する } がありません。最後の行に } だけの行を足します。 |
| 「{」の後ろは改行して… | verse { | C | のように同じ行に続けて書いています。改行するか、1行なら verse = | C | と書きます。 |
| ファイル「…」が見つかりません | import のパスが間違っています。パスはそのファイルから見た場所で書きます。フォルダの中のファイルから外を読むときは "../〜" です。 |
| セクション「oudou」は定義されていません。pop.oudou のことですか? | 読み込んだセクションは pop.oudou のように、呼び出し名を付けて呼びます。 |
| キーは C, F#, Bb, Am … のように書きます | key c(小文字)や key ハ長調 は読めません。key C と書きます。 |
11定番進行レシピ
よく使われる進行を度数で書いたものです。key を好きなキーに変えて使ってください。
王道進行
key D | IVmaj7 | V7 | iii7 | vi | x2
小室進行
key C style pulse | vi | IV | V | I | x2
カノン進行
key D style arp | I V/VII | vi iii/V | IV I/III | IV V |
ツーファイブワン(ジャズ)
key Bb tempo 120 style block | ii7 | V7 | Imaj7 | V7/ii | x2
丸サ進行
key D style pulse | IVmaj7 | III7 | vi7 | v7 I7 | x2
guide-… や recipe-… という名前で追加されます。