♯ChordScript 書き方ガイド ショートカット エディタを開く

| C Am | F G | と書けば、鳴る。

ChordScript は、コード進行をテキストで書いて再生するための小さな言語です。このページでは書き方をひと通り説明します。例の下にある「エディタで試す」を押すと、その例が新しいファイルとしてエディタに開きます。

01まずは鳴らしてみる

コード名をスペースで区切って並べるだけで、1つのコードが1小節ずつ鳴ります。エディタで Ctrl+Enter(Mac は ⌘+Enter)を押すか、右上の「実行」ボタンで再生、Esc で停止です。

C Am F G
→ C(4拍) Am(4拍) F(4拍) G(4拍)

はじめて音を出すときは、ブラウザの仕様でボタンかキー操作が必要です。音が出ないときは、端末のマナーモードと音量スライダーを確認してください。

02小節と長さ

小節線 | で区切る

| と | の間が1小節です。1小節に複数のコードを書くと、その小節を均等に分けます。4拍子で2つなら2拍ずつ、4つなら1拍ずつです。

| C  G | Am  Em | F | G |
→ C 2拍・G 2拍 / Am 2拍・Em 2拍 / F 4拍 / G 4拍

空白の数は自由です。そろえておくと読みやすくなります。

拍数を指定する :

コードの後ろに :数字 を付けると、その拍数だけ鳴らします。指定のないコードは、残りの拍を均等に分けます。

| C:3 G:1 | Am:1 G  F |
→ C 3拍・G 1拍 / Am 1拍・G 1.5拍・F 1.5拍

伸ばす・繰り返す・休む

記号意味例
-前のコードをそのまま伸ばす(鳴らし直さない)| C | - |
%前のコードをもう一度鳴らす| Am | % |
_休符。N.C. と書いても同じ| C:3 _:1 |
x2行末に置くと、その行を丸ごと繰り返す| C | G | x2
| F | - | G | % |  x2
| C:3 _:1 |
→ F を8拍、G を2回、これを2周。最後は C のあと1拍休み

小節線を書かない行では、1コードがそのまま1小節になります。C:2 G:2 のように拍数を付けると、その長さの小節になります。

03コードの種類

コード名は「ルート音」+「種類」で書きます。ルート音は C D E F G A B の大文字で、# や b を付けられます(F#、Bb)。種類は次の表のとおりです。右の列は、よく使われる別の書き方で、どれでも同じように認識します。

書き方名前C での構成音別の書き方
CメジャーC E GCM, Cmaj
CmマイナーC E♭ GCmin, C-
C7セブンスC E G B♭
Cmaj7メジャーセブンスC E G BCM7, C△7, CΔ7, C△
Cm7マイナーセブンスC E♭ G B♭Cmin7, C-7
CmM7マイナーメジャーセブンスC E♭ G BCm(maj7), Cm△7
C6 / Cm6シックスC E G A
Csus4サスフォーC F GCsus
Csus2サスツーC D G
C7sus4セブンス・サスフォーC F G B♭C7sus
CdimディミニッシュC E♭ G♭Co, C°
Cdim7ディミニッシュセブンスC E♭ G♭ ACo7, 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 DCadd2
C9 / Cmaj9 / Cm9ナインスC E G B♭ DC7(9), CM9
C69シックスナインスC E G A D
C7b9 / C7#9オルタード・テンションC E G B♭ D♭C7(b9), C7(#9)
C7b5 / C7#11♭5 / ♯11C E G♭ B♭C7-5
Cmaj7#11メジャーセブンス♯11C 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 |
→ ベースが C→B→A→G→F→E→D→G と下がっていく
鳴らし方について 構成音は、前のコードとの音の動きが小さくなるように自動で転回して並べます(ボイシング)。テンションの多いコードは、5度などを省いて4音以内に収めます。

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 |
→ Fmaj7 G7 Em7 Am → Amaj7 B7 G#m7 C#m
V7/x と V/x の違い 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 | - |
→ Am F C G / Dm7 E7 Am

エディタでは Alt+D を押すと、カーソルのある行のコード名と度数を相互に変換できます。

05テンポ・キー・音色

行の先頭にキーワードを書くと設定を変えられます。設定はその行から下に効きます。曲の途中に書けば、そこからテンポや音色が変わります。

書き方意味指定できる値最初の値
tempo 96テンポ(1分あたりの拍数)。bpm でも可20〜320100
key Amキー。度数表記の基準C F# Bb Am C#m などC
meter 31小節の拍数。3/4 と書いても可1〜164
sound pad音色epiano エレピ / piano ピアノ / pad パッド / organ オルガン / pluck プラックepiano
style arp奏法block 和音をのばす / strum ギター風にずらす / arp 8分のアルペジオ / pulse 8分で刻むstrum
bass offベース音on / offon
tempo 72
meter 3
sound piano
style arp
| C | Am | Dm7 | G7 |
// ここから音色と奏法が変わる
sound organ
style block
| F | G | C | - |
→ 3拍子のワルツ。後半からオルガンの白玉

// から行末まではコメントで、音には影響しません。

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
→ intro 2小節 → verse 8小節 → chorus 4小節 × 2
  • セクションの外に書いた進行は、上から順番に、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
→ 王道進行が E で、ツーファイブが Bb で鳴る
書き方意味
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 の代わりに ⌘ も使えます。

全体を再生Ctrl+Enter
カーソル行(またはセクション)だけ再生Shift+Enter
停止Esc
補完候補を出すCtrl+Space
予測を確定Tab
予測を切り替えAlt+] / Alt+[
コードを半音上げる/下げるAlt+↑ / Alt+↓
コード名⇄度数を変換Alt+D
コメントの切り替えCtrl+/
インデント/戻すTab / Shift+Tab
コードを試聴Ctrl+クリック
ファイル名を変更F2
import 先・定義へ移動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
→ Gmaj7 A7 F#m7 Bm

小室進行

key C
style pulse
| vi | IV | V | I |  x2
→ Am F G C

カノン進行

key D
style arp
| I  V/VII | vi  iii/V | IV  I/III | IV  V |
→ D A/C# Bm F#m/A G D/F# G A

ツーファイブワン(ジャズ)

key Bb
tempo 120
style block
| ii7 | V7 | Imaj7 | V7/ii |  x2
→ Cm7 F7 Bbmaj7 G7

丸サ進行

key D
style pulse
| IVmaj7 | III7 | vi7 | v7  I7 |  x2
→ Gmaj7 F#7 Bm7 Am7 D7
エディタを開く 「エディタで試す」で開いた例は、左のファイル一覧に guide-… や recipe-… という名前で追加されます。