kord

Binary Usage

Install

$ iwr https://github.com/twitchax/kord/releases/latest/download/kord_x86_64-pc-windows-gnu.zip$Expand-Archive kord_x86_64-pc-windows-gnu.zip-DestinationPath C:\Users\%USERNAME%\AppData\Local\Programs\kord

$ curl -LO https://github.com/twitchax/kord/releases/latest/download/kord_aarch64-apple-darwin.zip$ unzip kord_aarch64-apple-darwin.zip -d /usr/local/bin$ chmod a+x /usr/local/bin/kord

$ curl -LO https://github.com/twitchax/kord/releases/latest/download/kord_x86_64-unknown-linux-gnu.zip$ unzip kord_x86_64-unknown-linux-gnu.zip -d /usr/local/bin$ chmod a+x /usr/local/bin/kord

$ cargo install kord

$ npm install --save kordweb

Wasmer

$ wasmer install twitchax/kord

$ wasmer run twitchax/kord -- describe Am7

Help Docs

$ kord -hA tool to easily explore music theory principles.Usage: kord.exe [COMMAND]Commands:  describe  Describes a chord  play      Describes and plays a chord  loop      Loops on aset of chord changes,while simultaneously outputting the descriptions  guess     Attempt to guess the chord from aset of notes (ordered by simplicity)  analyze   Set of commands to analyze audio data  ml        Set of commands to train and infer with MLhelp      Print this message or thehelp of the given subcommand(s)Options:  -h, --help     Printhelp information  -V, --version  Print version information

Describe A Chord

$ kord describe Cmaj7Cmaj7   major 7, ionian, first mode of major scale   C, D, E, F, G, A, B   C, E, G, B

Play A Chord

$ kord play Bb7#9#11B♭7(♯9)(♯11)   dominant sharp 9, altered, altered dominant, super locrian, diminished whole tone, seventh mode of a melodic minor scale, melodic minor up a half step   B♭, C♭, D♭, E𝄫, F♭, G♭, A♭   B♭, D, F, A♭, C♯, E

Loop Through Chord Changes

$ kord loop -b 120"Em7b5@3^2""A7b13@3!""D-maj7@3^2""G7@3""Cmaj7@3^2"

Guess A Chord

$ kord guess C F# D# ACdim   fully diminished (whole first), diminished seventh, whole/half/whole diminished   C, D, E♭, F, G♭, A♭, B𝄫, B   C, E♭, G♭, B𝄫Cm(♭5)(add6)   minor   C, D, E♭, F, G, A♭, B♭   C, E♭, G♭, A

$ kord guess C G Bb F#5 FC7(♯11)(sus4)   dominant sharp 11, lydian dominant, lyxian, major with sharp four and flat seven   C, D, E, F♯, G, A, B♭   C, F, G, B♭, F♯Cm7(♯11)(sus4)   minor 7, dorian, second mode of major scale, major with flat third and flat seven   C, D, E♭, F, G, A, B♭   C, F, G, B♭, F♯

$ kord guess E3 C4 Eb4 F#4 A#4 D5 D4Cm9(♭5)(add2)/E   half diminished, locrian, minor seven flat five, seventh mode of major scale, major scale starting one half step up   C, D, E♭, F, G♭, A♭, B♭   E, C, D, E♭, G♭, B♭, D

Guess Notes / Chord From Audio

$ kord analyze micNotes: C3 E3 G3C@3   major   C, D, E, F, G, A, B   C, E, G

$ kord ml infer micNotes: C3 E3 G3C@3   major   C, D, E, F, G, A, B   C, E, G

Library Usage

[dependencies]kord ="*"#choose a version

Examples

use klib::known_chord::KnownChord;use klib::modifier::Degree;use klib::note::*;use klib::chord::*;// Check to see what _kind_ of chord this is.assert_eq!(Chord::new(C).augmented().seven().known_chord(),KnownChord::AugmentedDominant(Degree::Seven));

usecrate::klib::base::Parsable;use klib::note::*;use klib::chord::*;// Parse a chord from a string, and inspect the scale.assert_eq!(Chord::parse("Cm7b5").unwrap().scale(), vec![C,D,EFlat,F,GFlat,AFlat,BFlat]);

use klib::note::*;use klib::chord::*;// From a note, create a chord, and look at the chord tones.assert_eq!(C.into_chord().augmented().major7().chord(), vec![C,E,GSharp,B]);

JS Usage

importinit,{KordNote,KordChord}from'kordweb/klib.js';// Run `init` once.awaitinit();

// Create a note.constnote=KordNote.parse('C4');note.name();// C4note.octave();// 4// Create a chord.constchord=KordChord.parse('C7#9');chord.name();// C7(♯9)chord.chordString();// C4 E4 G4 Bb5 D#5// Easy chaining.KordChord.parse('C7b9').withOctave(2).chord().map(n=>n.name());// [ 'C2', 'D♭2', 'E2', 'G2', 'B♭2' ]// Build chords.KordChord.parse('C').minor().seven().chord().map(n=>n.name());// [ 'C4', 'Eb4', 'G4', 'Bb4' ]

Feature Flags

Test

cargotest

License