Font and instructions for improved New Real Book style chord names

I have struggled for a few days trying to get chord names the way I wanted it, and I learned quite a few things in the process. This could be useful to others, so if you like the attached chord chart reply to this message and I will post the needed files & instructions.
Basically I started from the very nice font developed by Jochen Pietsch ( and increased the size of the superscripts (which I found hard to read) as well as added a couple symbols (esp. dim & half-diminished).

chart.pdf229.75 KB


I like it. Does it transpose

I like it. Does it transpose right ? and export to MusicXML?

Hmmm.. do I need to do

Hmmm.. do I need to do anything special for it to transpose??
I didn't change any chord IDs in chord.xml, so the only changes should be to the rendering. And I didn't notice any particular problem when transposing myself.

Looks excellent.

I would be interested, for sure.

Thanks for your work.


Here we are

Here we are:
- unzip the attached archive
- double-click the .ttf font file and choose "Install" (I assume it works the same on XP, I use Win7)
- copy chords.xml and realbookchords.xml to the "styles" folder in your Muse install
- restart Muse, and in your template or in your score:
- Choose Style -> Edit General Style... -> Chordnames -> realbookchords.xml
- Choose Style -> Edit Text Style... -> Chordname -> Font = "New Real Book Chords", size = 12, uncheck Bold

If you already had chords you will need to double-click them & revalidate to see the changes.
The only change to chords.xml is that I added a chord for maj7#11 at the end, if you don't need it you can keep the original chords.xml (you may need to remove the render instruction for chord id 208 from realbookchords.xml).

A few hints on tweaking things further:

- what you type as you enter the chord is matched against the "name" elements in chords.xml to find the chord ID
- The rendering instructions are then looked up by chord ID in realbookchords.xml
- Check out the DOCTYPE section at the top of realbookchords.xml, it defines internal entities (aliases), and I have included commented out versions of some popular choices for common chords (maj7, 1/2 dim, ...).
- Install a font viewer that displays the index for each character (eg and to get character at decimal index xxx to display insert &#xxx; in realbookchords.xml
- chord ID 32 is half-diminished, I left the alternate m7b5 rendering as a comment in realbookchords.xml
- chord ID 33 is diminished, use _ to have it displayed as a superscript "dim." glyph
- last but not least, check that the half-diminished symbol renders/prints correctly for you, there are apparently pretty complex rules for creating ttf glyphs and I just savagely added the diagonal stroke on top of an existing glyph, which seems to work for me...

If someone has Jochen Pietsch's email thank him on my behalf for his font :)

[EDIT: Added updated attachment with XML entities to make maintenance easier and sample uses of vertically stacked tensions].

AttachmentSize 33.49 KB

Installing the font

I use Windows Vista, and the procedure to install ttf fonts is a bit different, as follows:
Click on the Start button in the lower left corner, then choose Settings (sorry, my Windows speaks German to me, and there it is 'Systemsteuerung'
From there you choose 'Schriftarten' (don't know the exact English word, but I think it would be 'fonts')
The system fonts folder will open. Drop the Files menu and select 'New font' (Neue Schriftart). This opens a file selector. Navigate to the unzipped archive file and double click on the .ttf file. This is where you will answer 'Install'.
That's how I did it. Will now open MuseScore and see what I have got.


In Windows 7 you can double

In Windows 7 you can double click on the .ttf file and then click the install button. Maybe it is the same in Vista?

Installing .ttf files

Not quite. When I double click on a .ttf file in Vista I just open it with the font viewer. There is no install button on this mask. Besides, the chord names look rather exactly like the jazzbook.ttf font version.
In Vista I do have to go thru the Settings menu.


Last version, getting pretty

Last version, getting pretty close to the Brandt & Roemer standard, with XML entities in realchords.xml for easy (well, easier :) ) customization.
See attached chart.pdf for a preview.

AttachmentSize 34.15 KB
chart.pdf 40.85 KB

These look really nice -

These look really nice - thanks for doing that! I guess the main other thing that would still need to be done is to make a customized chords.xml so the chords would parse the way they are spelled. That is, so you can type Cmi7 to get Cmi7.

As for the chord themselves, I personally like to use parens around the ma7 in Cmima7 and similar chords so they come out Cmi(ma7), and I do prefer mi7b5 over the half-dim symbol (thanks for anticipating that option), but aside from that, it looks ready to go for me!

Try the attached chords.xlm,

Try the attached chords.xlm, edit the two entities at the top to suit your needs. No guarantees, hardly tested...

chords.xml 27.8 KB

How to input the chords

Your chords.xml, which turns out to be a chords_2.xml (all for the better, so I can have both in my Styles folder), has a totally different structure than the realbookchords.xml, but it does tell you how to enter every single chord - it even gives a sample voicing when used in C. While I got the desired results when using realbookchords.xml, it is more a matter of feeling, especially when you have more than one tension.
May I assume that the entry format is the same in both cases, so I can use the info in chords_2.xml anyway?


Great Question


Unless I messed up somewhere,

Unless I messed up somewhere, that chords.xml is in fact very similar to the original one (which also has voicings). I have simply introduced alias definitions at the top of the file (maj7...

have become


In other terms the file should be strictly equivalent to the original one (until you enter different key sequences for some of the entities).


Perhaps my question should

Perhaps my question should have been: how do I input chords when using realbookchords.xml? This one does not seem to have such guide. Or what is the info between the and the tags?
I would like to use realbookchords.xml because it seem that the output it delivers is nicer than that of chords.xml.


Muse uses two files in

Muse uses two files in conjunction: chords.xml and realchords.xml (or, if you use the original settings, chords.xml and stdchords.xml).
No matter which fonts or rendering you want to use chords.xml is always the file Muse uses to decide which chords are defined, and what keyboard input is used to enter them.
realchords.xml only defines how chords are rendered. The connection between the two lists is through chord IDs.

So to answer your question, look into chords.xml for how to input chords when you use realchords.xml.
Hope this helps - Franck

Thank you. This is exactly

Thank you. This is exactly what I wanted to know.


License issues with font

Unfortunately Jochen Pietsch's fonts use a license that is not compatible with the GNU General Public License that MuseScore uses (which allows commercial use).

Contacted Jochen

I contacted Jochen with the request to change the license of his font so we can include it in MuseScore. Fingers crossed.

Works great

Busy transcribing Mas Que Nada... ;-) But I wanted to give feedback, since your post and the thread was very helpful. btw Muse guys, can't you choose something more creative looking the boring old Times New Roman?

Downloaded this version and used the instructions posted above onto my Ubuntu system (Natty 11.04) and the chord formatting worked perfectly. Just needed to tweak one thing - couldn't understand the curly bracket "{" instead of a good old "m" when I put minor in, so read through the post again, went in and found the relevant part in the xml file and changed the behaviour there (for those that want to do it, the file explains how its just a question of commenting and un-commenting a couple of lines).

I've included the file below, here's the diff.

huang@revo:~/downloads/muse$ diff realbookchords.xml /usr/share/mscore-1.0/styles/realbookchords.xml
< -->
< -->
< -->

realbookchords.xml 16.01 KB

Problem editing realbookchords.xml

I am trying to figure out how to edit realbookchords.xml on a windows XP system. I use metapad as my text editor and I remove the ! from the top of the file for half diminished to render as m7b5. When I load an existing score, edit the style sections, and try to re-render the chords get an error message: error reading chord description C;/Program Files/MuseScore/styles/realbookchords.xml at line 8 column 6: letter is expected. As best as I can see there is a letter in column 6 since deleting the ! places E in ENTITY at column 6. Any one that has played with these on a Windows system that can recommend either a different editor or shed some light on what I am doing wrong I wil be eternally grateful!


Did you try putting the

Did you try putting the exclamation mark back?

The original looks like:

<!-- half-diminished symbol - uncomment one only
			"&#187;"			striked circle
			"}7b5"				superscript  m7b5
    <!ENTITY half_dim "&#187;">
    <!ENTITY half_dim "}7b5">

If you want to uncomment the other one then it would look like:

<!-- half-diminished symbol - uncomment one only
			"&#187;"			striked circle
			"}7b5"				superscript  m7b5
    <!ENTITY half_dim "&#187;">
    <!ENTITY half_dim "}7b5">

Didnt get it :-)

Hey Guys

Sry, but I'm a real beginner in writing music on pc and i like your chord names, franck102!
I installed the font like you said and changend chordnames from "jazzchords" to "realbookchords", but it didnt work.
Could you explain the process (step by step) ?!
This would really help!

Thanks a lot and greets!

What specifically didn't

What specifically didn't work? In other words, what did you do, what did you expect to see happen, and what happened instead?

In general, to get customized chord symbols you need to do these things:

1) have a customized XML file to describe how the chords should *look* - in this case, realbookchords.xml
2) have a customized XML file to describe what you need to *type* to get those chords - in this case, chords.xml
3) tell MuseScore to use these files (by setting the appropriate style option to use realbookschords.xml, and by restartng MuseScore after replacing the stock chords.xml with your customized one)
4) have the approriate fonts installed
5) tell MuseScore to *use* those fonts via the text style (this can be done within the XML file; not sure if realbookchords.xml does this or not)
6) enter a chord symbol that MuseScore recognizes according to #2

Depending on what went wrong, I'm guessing you didn't enter a chord symbol MuseScore recognizes according to whatever chords.xml you have installed. it's also possible you needed to set the chordname text style to use the realbook font and you didn't do that.

BTW, if you have trouble getting these XML files working, you can also try this customized XML file I created, which is based on the one here but is designed to be even easier to customize and also to not require any additional fonts:

It turns out that you can include information on how chords should be typed within the same XML file you use to control how they are displayed, so I did that in my version. So you won't have to replace your existing chords.xml and restart MuseScore with my version. But because it doesn't depend on any additional fonts, it doesn't look quite as slick as franck102's in some respects.

Just discovered this. Looks

Just discovered this. Looks amazing. Compatible with Finale?


Compatible in what way?

Compatible in what way? MuseScore cannot open Finale files or vice versa, but you can transfer them by exporting/importing in the standard MusicXML files. Things don't come over perfectly, but it gets you started.

If you have more specific questions on using MuseScore, please start a new thead in the Support forum - and read this first:

My questions was specifically

My questions was specifically about the chord library/font (Real Book Style). Can they be imported into a Finale doc?


The font that is included

The font that is included with MuseScore 1.2 is called MuseJazz, and it is compiled into the program rather than installed as a font in the OS. So it wouldn't be available. However, if you really need it - doesn't Finale already come with a variety of similar fonts? - you could always grab the font from the source code to MuseScore on sourceforge or wherever it actually lives (see the Development link at right of this page).

Syndicate content