Appendix

Quick How-To

How-toAnswer
Change the key Select from the key selector wheel on the left side of the key-tuning-sound selector on the Settings screen.
Change the sound Select from the sound selector wheel on the right side of the key-tuning-sound selector on the Settings screen.
Read the type of sound See the Built-in Sounds section in this chapter.
Change the tuning Select from the tuning selector wheel on the middle of the key-tuning-sound selector on the Settings screen.
Read the type of tuning See the Built-in Tunings section in this chapter.
Check the current pitch Current pitch deviation from the standard is displayed in cents under the "Pitch" label at the top left on the Settings screen.
Adjust the pitch You can adjust the pitch with the pitch tuner dialog on the Settings screen.
Apply a reverb effect Adjust the slider labeled "Reverb" on the Utilities Screen.
Make airy sound louder (smaller) Adjust the slider labeled "Airy Sound" on the Utilities Screen.
Strengthen (Weaken) vibrato effect Adjust the slider labeled "Vibrato" on the Utilities Screen.
Stop the smart chord feature Toggle the "Smart Chord" to off on the Utilities Screen.
Apply dynamics to the sound of playing See the Expression section in the Utilities chapter of this guide.
Perform an accurate bend operation Activate the "Accur. Bend" feature on the Utilities screen.
A detailed explanation can be found in the Bending section in the Utilities chapter of this guide.
Know the bending feature See the Bending section in the Utilities chapter of this guide.
Know the splitting feature See the Multi Notes section in the Utilities chapter of this guide.
Change the width of the Overlap Adjust the slider labeled "Overlap" on the Utilities Screen.
Use it like a chromatic harmonica See the Slide section in the Utilities chapter of this guide.
Change the screen color See the Color Palette Dialog section in the Utilities chapter of this guide.
Play with songs in my iPod library See the PlayAlong chapter of this guide.
Create new sound See the Synthesizer chapter of this guide.
Modify the sound See the Synthesizer chapter of this guide.
Export the sound You can copy selected sound data to your device's clipboard.
See the Sound-Shelf Dialog section in the Synthesizer chapter of this guide.
Import the sound You can paste the sound data from your device's clipboard.
See the Button Operation of "Key, Tuning and Sound" section in the Settings chapter of this guide.
Apply my own tuning You can create tuning data with an external text editing app and import it; see the Import & Export Data in this chapter for data content.
And see the Button Operation of "Key, Tuning and Sound" section in the Settings chapter of this guide for importing the tuning data,

Built-in Sounds

"Resin", "Wood" and "Metal" are sounds just make you feel the material, not of a real harmonica. Similarly, "Clarinet", "Saxophone" and "Flute" are synthetic sounds, not real sound samples.

Sound NameCharacteristic
Resin Tone similar to ordinary harmonica.
Wood Slightly softer than "Resin", with a gentle attack and quick release.
Metal Slightly harder than "Resin", with a sharp attack and slow release.
Hollow A feeling of emptiness due to less fundamental part of harmonics.
SawTooth Containing all the harmonics.
Stringed Sharper than "SawTooth", similar to the sound of a stringed instrument.
Square Containing only odd harmonics.
Clarinet Triangle waveform: softer sound than that of a square wave.
Saxophone Woodwind sound close to that of a saxophone.
Flute Close to the sound of flute, or whistle.
ScaleCheck A logical tone for checking the scale of the harmonic editor.
SineWave A pure tone; close to the sound of tuning fork.

Intervals Notation

Notation and various interval expressions.

NotationMusical TermInterval StepsSemitones
root namePerfect Unison00
m2minor 2nd1H (Half)1
2Major 2nd1W (Whole)2
m3minor 3rd1W + 1H3
3Major 3rd2W4
4Perfect 4th2W + 1H5
+4 (-5)Augmented 4th (Diminished 5th)3W6
5Perfect 5th3W + 1H7
m6minor 6th4W8
6Major 6th4W + 1H9
m7minor 7th5W10
7Major 7th5W + 1H11

Diatonic Chord Structure

Notation of each note constituting diatonic chord.
Tip: This can be a cheat sheet for the chord playing with "Interval" notation.

Diatonic ChordBase note3rd note5th note6th note7th note
Tonicroot3567
Dominant57234
Sub Dominant46root23
Ⅱ minor2467root
Ⅲ minor357root2
Ⅵ minor6root345
Ⅶ diminished72456

Built-in Tunings

Most are popular tuning names, but some are unique to this app.
B.P represents breath pattern; R: Richter, C: Chromatic, U: Unified

Tuning NameB.PAlterationCharacteristic
MajorR - The most common regular 10 hole diatonic harmonica tuning. 2nd position is Mixolydian mode: a great scale for blues and rock music.
Natural MinorR 3rd, 6th and 7th notes of Major tuning are lowered 1 semitone. 1st position is Aeolian mode; this allows you to play minor tune intuitively.
Harmonic MinorR 3rd and 6th notes of Major tuning are lowered 1 semitone. A variant of Natural Minor: 7th note is raised 1 semitone to work as a leading note; suited for playing minor folk melodies.
Jazz MinorR 3rd note of Major tuning is lowered 1 semitone. A variant of Harmonic Minor: 6th note is raised 1 semitone to resolve the gap between 6th and 7th notes.
Country R Hole 5 drawing (lower side) note of Major tuning is raised 1 semitone. In 2nd position, major scale containing major 7th note is available along the middle octave: suitable for playing melodies, especially country music styles.
Major-7thR Hole 5 and 9 drawing (lower side) notes of Major tuning are raised 1 semitone. In 2nd position, major scale containing major 7th note is available along the middle and upper octaves: more suitable for playing melodies.
Major-7th MelodyR Hole 3 blowing (upper side) note of Major-7th tuning is raised by 1 tone. The tuning called Melody Maker™: complete major diatonic scale is available in 2nd position; this makes it very suitable for playing melodies and several main diatonic chords.
SoloC A typical tuning for chromatic harmonica. Tip: You can play this instrument as a tiny chromatic harmonica with this tuning and the "Slide" feature.
High-tuned SoloC Octave higher than Solo tuning. It can be used for play like a whistling with the sound close to a sine-wave.
BebopU Spare root note of Solo tuning is changed to minor 7th. It makes a chromatic harmonica to have unified breath pattern and to get a consecutive chromatic sequence from 6th to root, including minor 7th: suitable for jazz playing.
SpiralU The diatonic scale is assigned in sequence from blow to draw along all holes. Also called "Circular": there is no missing note in the major scale, and you can play all diatonic chords of the scale.
Spiral Minor7thU 7th note of Spiral tuning is lowered 1 semitone One position off compared to Spiral tuning: 1st position is Mixolydian mode; major scale is in 12th position.
DorianR Hole 3 and 7 drawing (lowe side) notes of Major tuning are lowered 1 semitone. 2nd position is Dorian mode which the player familiar with the 2nd position can easily play with.
Easy ThirdR Hole 2 and 3 drawing (lower side) notes of Major tuning are lowered 1 tone. In 3rd position, scale and chord of the minor tonic in lower scale are available with no bending; very suitable for minor melodies and chord play.
Paddy RichterR Hole 3 blowing (upper side) note of Major tuning is raised 1 tone. 6th note changed from 5th makes it easier to play the pentatonic scale. Great for melodic music such as Irish and Celtic music.
PowerBenderU The layout higher than hole 5 has been changed. Repositioning important notes to drawing side where is easy to bend, so that it reduces the need to use difficult over-blows and gets fluent breath pattern.
PowerDrawU Restored the allocation of hole 5 and 6 of PowerBender to Richter tuning. A combination of the good parts of standard Richter tuning and PowerBender tuning.
DiminishedU Eight notes per octave are regularly arranged by the parts of 1W-1H. Combining the 1 semitone draw bending, it is possible to make all notes of the chromatic scale.

Root Table

Root note for position in key from G to F#
Note: In Major tuning, 7th to 11th position has no root note, so these positions are not normally used.

Key (1st)2nd3rd4th5th6th7th8th9th10th11th12th
GDAEBF#D♭A♭E♭B♭FC
A♭E♭B♭FCGDAEBF#D♭
AEBF#D♭A♭E♭B♭FCGD
B♭FCGDAEBF#D♭A♭E♭
BF#D♭A♭E♭B♭FCGDAE
CGDAEBF#D♭A♭E♭B♭F
D♭A♭E♭B♭FCGDAEBF#
DAEBF#D♭A♭E♭B♭FCG
E♭B♭FCGDAEBF#D♭A♭
EBF#D♭A♭E♭B♭FCGDA
FCGDAEBF#D♭A♭E♭B♭
F#D♭A♭E♭B♭FCGDAEB

Mode Characteristics

Note: Here is a very brief overview; details may be found in various music theory books.

ModeTypeCharacteristicExamples
IonianMajorSame as the Major scale: bright and very suitable for melodies and chords"Let It Be", "Mozart’s Piano Sonata No.16"
MixolydianMajorIncludeing minor 7th: great blues scale, heard all over rock, blues, jazz, funk etc.“Norwegian Wood”
DorianMinorMinor scale with major 6th: melancholic but bit a brighter, used in lots of Celtic and Irish music"Scarborough Fair", "Eleanor Rigby"
AeolianMinorNatural minor scale: suited for playing in a minor key"All along the watchtower"
PhrygianMinorIncluding minor 2nd: dark, ambiguous and mysterious, also called Spanish Gypsy Scale"Hungarian Rhapsody No.2"
LocrianMinorIncluding diminished 5th: unstable, dissonant
LydianMajorIncluding augmented 4th: meandering and lack of direction, widely used in jazzTheme of "The Simpsons"

Import & Export Data

A correct sound data and tuning data can be imported via the device clipboard; conversely, the sound data placed on the sound-shelf can be exported via the device clipboard.
You can paste the exported data into another application such as Memo or Mail, and can view, edit, copy and send it.
Note: When editing these data on the device, it is necessary to turn off the "Smart Punctuation" of the device to make it proper: Settings > General > Keyboard > Smart Punctuation.

Importing sound data

When selecting a sound in the settings screen, if valid sound data is found in the device's clipboard, the paste button at the top right of the selector wheel becomes available.
Tap it and a dialog will appear asking if you want to import the data.
Note: Pay attention to the data name. Built-in data with the same name will be overwritten on import.

Importing tuning data

When selecting a tuning in the settings screen, if valid tuning data is found in the device's clipboard, the paste button at the top right of the selector wheel becomes available.
Tap it and a dialog will appear asking if you want to import the data.
Note: Pay attention to the data name. Built-in data with the same name will be overwritten on import.

Data structure
Sound Data

The sound data contains following items described in JSON format.

ItemDescription
name Name of this sound data.
partials Array of 20 numbers of the harmonic level having the value from -1 to 1.
attack The attack (rise up) time in seconds.
subattack The delay time of higher harmonics in seconds; usually 0
release The release (fall down) time in seconds.

An example of the sound data is shown below.

{
"name":"Triangle",
"partials":[1.000, 0, -0.111, 0, 0.040, 0, -0.020, 0, 0.012, 0, -0.008, 0, 0.006, 0, -0.004, 0, 0.003, 0, -0.003, 0],
"attack":0.03,
"subattack":0,
"release":0.33
}

Tuning Data

The tuning data contains following items described in JSON format.

ItemDescription
name Name of this tuning data.
blow Array of the blowing note number.
draw Array of the drawing note number.
blowLift Array of blowing deviation in cents; usually 0
drawLift Array of drawing deviation in cents; usually 0

Each array in the data structure has the length of 10 same as a harmonica holes count.
The note number of each element is represented by a chromatic offset from note C4; for example: D4 is 2, B3 is -1 and of course C4 is 0.
This application handles the tuning data assuming that key is "C", therefore note number 0 is actually note of C4 when the key setting is "C"; with these in mind, you are free to design any scale you like.
"blowLift" and "drawLift" can be used for fine tuning in cents.
An example of the tuning data is shown below.

{
"name":"Major",
"blow":[ 0, 4, 7, 12, 16, 19, 24, 28, 31, 36],
"draw":[ 2, 7, 11, 14, 17, 21, 23, 26, 29, 33],
"blowLift":[0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
"drawLift":[0, 0, 0, 0, 0, 0, 0, 0, 0, 0]
}

Note: Extremely out-of-range values in the data will be validated upon import.


Copyright ©2020 Chord-Works