Ever wondered why Glyphs knows so much about the glyphs you create? Like, when you enter the name of a glyph, it sets the Unicode and when you choose Glyph > Set Anchors (Cmd-U) or Glyph > Reset Anchors (Cmd-Opt-U), it sets the right diacritical anchors. Where does it store all that information?
Tucked away inside the Glyphs application, there is a file called
GlyphData.xml. You are not supposed to touch the one inside the app, but you can make a copy of it in the Application Support folder and keep your personal customizations there. Glyphs will use your glyph info to override the built-in settings.
Make a Copy of GlyphData.xml
Okay, so we have to dig into the application and fish out the XML file. To do that, you first make sure that your Glyphs app is called Glyphs and resides in your Applications folder. Then, copy this line into the clipboard:
Then, in Finder, choose Go > Go to Folder… (Cmd-Shift-G). Paste the line we just copied into the appearing dialog:
Hit Go and the Finder will show you the
GlyphData.xml, buried somewhere in the Glyphs application:
While the XML file is selected, choose Edit > Copy GlyphData.xml (Cmd-C). You can close the Finder window now.
Now, we have to navigate to the Application Support folder. The easiest way to get there is to choose Script > Open Scripts Folder (Cmd-Shift-Y) in Glyphs. This will take you to the Scripts folder inside the Application Support folder. All you need to do is make sure you are in the enclosing folder. Next to the Scripts folder, you may see Temp and Plugins folders as well as a
CustomFilter.plist file. If you do not see an Info folder there yet, it’s time to create it (Cmd-Shift-N). Inside the Info folder, paste the
Open the XML file with your favorite XML or plaintext editor. Personally, I recommend TextMate, many people also like SublimeText and Atom, and you may also be happy with BBEdit or its free counterpart TextWrangler.
Both XML files, the one buried in the app as well as the one we just copied into the Info folder, contain all relevant glyph info. They compliment each other, so you can limit your copy of the XML file to just the letters you need. To do so, remove everything between
<glyphData> (should be located around line 20) and
</glyphData> (the last line). So you end up with something like this:
Now, an entry for a letter must adhere to a certain form. Let’s take an example. Imagine you want to encode a letter of your favourite script Tengwar, what about
U+E000 TENGWAR LETTER TINCO, and maybe throw in
U+E046 TENGWAR SIGN ACUTE as well. We would add these lines to our copy of
<glyph unicode="E000" name="tinco-tengwar" decompose="longCarrier-tengwar, ooreStemless-tengwar" category="Letter" subCategory="Primary" script="tengwar" altNames="tincoTengwar, tengwarTinco" production="uniE000" description="TENGWAR LETTER TINCO" anchors="top, bottom" accents="threeDotsAbove-tengwar, threeDotsBelow-tengwar, twoDotsAbove-tengwar, twoDotsBelow-tengwar, dotAbove-tengwar, dotBelow-tengwar, acute-tengwar, doubleAcute-tengwar, rightCurl-tengwar, doubleRightCurl-tengwar, leftCurl-tengwar, doubleLeftCurl-tengwar, nasalizer-tengwar, doubler-tengwar, tilde-tengwar, breve-tengwar" /> <glyph unicode="E046" name="acute-tengwar" category="Mark" subCategory="Nonspacing" script="tengwar" altNames="acuteTengwar, tengwarAcute, andaith" production="uniE046" description="TENGWAR SIGN ACUTE" />
Now, it should look like this (I admit I cheated a bit with the indentation here):
Save it, restart Glyphs, take a look in Window > Glyph Info, and search for
tengwar to see if Glyphs accepted your addition. And if you did everything right, you will see something like this:
You see, if you want to add a new glyph to the database, you have to add an XML element called
glyph. Its basic structure is:
<glyph attribute="value" />
glyph element can take various attributes of the structure
attribute="value". And every glyph entry needs these three required attributes:
nameis the name of the glyph. Glyphs recognizes your glyph by its name, so this must be set to a valid glyph name, and it must be unique all throughout your glyph data.
descriptionis the Unicode-style descriptive name of your glyph. If you have an encoded glyph, you can find the official name with Unicode Checker or the unofficial name from the ConScript Unicode Registry.
categoryis the category or group of the glyph. Possible values are:
Letter(letters like ‘x’ or ‘ä’),
Number(figures like ‘3’),
Mark(e.g. the acute mark),
Punctuation(like the period or the comma),
Separator(like the wordspace),
Symbol(like the Emoji signs, arrows or the Radioactive symbol).
You can (and where possible, should) make use of these optional attributes:
unicodeis the hexadecimal UTF16 value. Leave it out if you want to create an unencoded glyph like a ligature.
subCategoryhelps you further define the kind of the glyph. This, of course, depends on the
category. This could be
Letteretc. Take a look at Window > Glyph Info for possible subcategories. Roughly put, categories and subcategories are what you see in the sidebar of the Font tab, or as separators in grid view.
scriptdefines the scripting system the glyph belongs to. Can be left out if it doesn’t belong to any script (e.g. for math symbols). Possible values include
hanetc. You get the idea.
anchorsis comma-separated list of possible diacritical anchors for the glyph. The usual suspects are
right. Corresponding mark anchors need preceding underscores, e.g.
_top. Stackable combining marks can have both kinds of anchors. Omit this attribute if your glyph cannot be a base for a diacritic or vice versa.
accentsdefines the possible accents the glyph can take. This mainly helps Glyphs draw the mark cloud when you click on an anchor.
altNamesis a comma-separated list of alternate glyph names that are recognised by the application, so the glyph can be sorted or renamed correctly. E.g.,
oslashwas sometimes called
ostroke. When you open a legacy font that uses this weird name, Glyphs can update it to
oslashwhen you run Glyph > Update Glyph Info.
productionis what the glyph is renamed to at export time. Usually describes the legacy Adobe Glyph List name. You probably want to make use of this attribute wherever the AGL uses
unifollowed by the 4-digit Unicode or
uand the 5-digit code. E.g. the glyph element for Romanian and Moldovan
Tcommaaccenthas both a
decomposedefines the components of a compound glyph. In other words, the parts that make up the glyph. This information is used when you construct such a letter using the Glyph > Make Component Glyph command (Cmd-Opt-Shift-C). Make sure the base letter comes first and all the diacritics follow. This is also useful for ligatures. In that case, you add the names of the glyphs that comprise the ligature, e.g.
decompose="f, f, k"for an
sortName: by default, Glyphs orders the glyphs alphabetically within their category. If you want to manipulate the display order, add this attribute. For instance, to make sure that
AEcomes after all the
Adiacritics instead of between
Adieresisand Agrave, there’s a
sortName="Az"attribute in it. This is very important for figures, where the
sortNamecan look like
There’s an App for That!
Since May 2017, there is a smarter and more convenient way to edit your glyph data: it is called EditGlyphData and you will find it in the Tools section of our website. Use it also to merge the data from multiple XML files into one, and, maybe best of all, export the data to a tab-separated text file, so you can edit it in your favourite spreadsheet app. Plus, avoid all XML inconsistency problems (see below). Cool.
Be careful and precise. If you mess up your glyph data, you will run into problems. Here are a few common problems, so you can avoid them right from the start:
First, make sure you always fill out the three required attributes, especially
Secondly, it is seductive to to create your own naming schemes with this trick. But keep in mind that Glyphs expects certain names for automatically building OpenType features. So, you may have to write your own feature code as well, once you roll your own glyph data.
Thirdly, and this is important: Glyphs will ignore your custom glyph data if your
GlyphData.xml contains broken XML. So, make sure you properly validate your XML from time to time. Many tools like TextMate sport a built-in validator. You can, of course, also copy and paste your XML into a web-based validator such as the W3 Markup Validation Service. Or, use the EditGlyphData app (see above).
That’s all there is to injecting your custom info into Glyphs. If you feel that other people could also profit from your additions, you can put your
GlyphData.xml file on Github, and if you do so, do it with the GlyphsInfo GitHub repository (instructions in the readme). Or, if you are uncomfortable with git, post a suggestion in the Glyphs Forum, or, if you think your changes should be the default for every Glyphs user, file a feature request in the forum or get in touch with us otherwise.
Update 2013-02-03: added note on how to navigate to GlyphData.xml in 10.6 (thanks @typefacts); two minor text improvements.
Update 2013-02-12: added ‘Potential pitfalls’.
Update 2013-03-25: corrected XML file name typo (thanks George Thomas).
Update 2014-12-11: Updated to new notation for dotless glyphs, changed the sortName example to AE.
Update 2015-07-08: Partial rewrite. Updated to Glyphs 2, new and updated links. Removed outdated passages. Added Tengwar and links (thanks @Tosche_E).
Update 2017-05-30: Added reference to EditGlyphData app, removed deprecated bugreport link.
Update 2018-09-25: Added link to GlyphsInfo repo. Thx Dave.