# Chord Editor dialog

This is a dialog that allows you to get a chord based on it’s theory, recognize a chord based on the tab, memorize or get a chord from a library, and few more things. This is also the only way to add a chord name or/and diagram in the tab.

As you can see chord dialog consists of many things, but is still easy to use. Nevertheless, every feature of the dialog will be explained here.

## Opening the dialog

When you open the dialog by clicking on it’s icon (or hitting “A” key as shortcut), the first thing you will notice is that the notes from your tab are now in the chord dialog editor, the chord is recognized according to the theory and you can hear the sound preview of it.

## Editor

In editor you can compose your own chord by simple drawing. You should first choose the starting fret with the slider on the right side of the editor and then put the black dots on the frets. Clicking above the line on the editor changes the note between the “empty-string” (white dot) or “don’t play this string” sign (marked with X). The span of the editor is 5 frets, but you will have to admit that you rarely play chords by stratching the fingers to 6-fret span. :)

While you are “drawing” the chord, it will constantly be recognized, which can be seen in recognizer window.

After composing your chord you can save it to library, or simply press OK and add it to tab.

## Chord

This bunch of controls is used to compose a chord based on it’s name (theory).

You should first choose chord root, either in sharp or flat. Then you should choose chord flavor (major, maj7, sus2, sus4...).

Next, you can alterate the chord. You can make /9 chord (adds b7 and 9 tones), /11 chord (adds b7, 9 and 11 tones) and /13 chord (adds b7, 9, 11 and 13 tones). By enabling the “add” checkbox you get the “add” chord (which means add13 chord has only 13 note, without b7, 9 and 11).

You can modify the selected alteration with +/- control, and other alterations with appropriate +/- box (rightmost of the Chord controls).

On the bottom of chord controls is a bass note. If you choose a different bass note than the chord root you will get so-called inverted chord.

## Proposals

Based on the chosen chord theory, you will get proposals for the fingerings. On the proposal thumbnails you can see the chord position and the fingering. The chord proposals are generated and sorted, so don’t be too dissapointed if you don’t see your favourite chord on the second position.

On the other hand, proposals are generated for any tunning and any criteria the same way. You may be surprised when it digs some convenient fingering for a chord you had trouble with.

After you click on the proposal, it will appear in editor, it’s name would be written and you should hear the way it sounds.

## Name

The title of the chord is changed every time you choose one of the proposals. The chord name isn’t displayed while you edit the chord because you would loose the chord name you typed in the first place.

## Recognized

The recognized window contains the proposals of the chord title, according to the theory. Besides the chord name you will see the probability of a chord. The probability is less when a chord is missing some tone to be complete.

When you click on an item in recognition window, the chord controls should change based on the chord you chose, it’s name will be displayed in title window, and the proposals of more fingering positions should be generated below.

## Library

When you compose a convenient chord, you can add it into library. Once added, it can be accessed outside the chord dialog - by clicking on the arrow besides Chord Editor icon in the toolbar. When you add a chord to a tab that way, it’s name and/or diagram will be displayed in the tab.

In Chord Editor dialog you can manipulate the library list: add, rename or remove chord from a library.

## Settings

In the Settings dialog are some options which can customize and improve the chord proposal assembly process.

Chords to display is the number of the best chord proposals to be considered into proposal list. Note that this number of proposals wouldn’t be displayed, because the very similar fingerings (like x02210 and x0221x for Am) will not be included.

Chord type is a very important property. Besides the “Most common” chords, here you can choose between “Open-voiced chords“, “Closed-voiced chords” and “Chord inversions“. While chord inversions mean that the bass note isn’t the root note of the chord, open- and closed-voiced chords are a little bit more specific: closed voice have tones very close (tonically) to each other, while open-voiced tend to distribute the notes of the chord in different octaves.

Open chords include empty strings into chord composition, so you get “open chords”. For example, famous “Hendrix chord” is an open chord ( 076780 ). Open chords are another chord type, but can be used in combination with any of them.

Search frets is an option for you if you are looking for a chord on a specific position. Normally all the chords from fret 0 to fret 15 will be proposed, but you can narrow (or expand!) the search by modifying the starting and ending fret. If open chords is selected, zero-fret will be included in the search, too.

By clicking on the OK button your changes will be applied, but they won’t be remembered next time you run TuxGuitar.

## Chord layout

When you insert a chord it will be displayed on the main tab view. There are two different views of a chord, plus mixed one. It is changed in the main menu, checking one or both of the items from Layout→Chord_Style.

You can view the chord as a diagram (where to put the fingers), only its name (entered in the library), or both.