GLYPHSLIB(1)

💖 GLYPHSLIB 💖

okay bestie, welcome to glyphsLib — that's the metapackage for python3-glyphsLib: defcon extras, and the manual page is GLYPHSLIB(1) if we're being official about it. it lives in the User Commands corner of your man pages, and it's basically the group chat between your UFOs and your Glyphs files. pull up a chair, we're converting fonts 💅

---

✨ NAME ✨

glyphsLib — metapackage for python3-glyphsLib: defcon extras. that's the whole name entry, short and sweet, like a good text message. 🎀

---

🌸 DESCRIPTION 🌸

so here's the vibe. you run this thing, and the usage it hands you looks exactly like this:

usage: python3 -m glyphsLib ufo2glyphs [-h] [--version]
       [--output-path OUTPUT_PATH]
       [--ufo-module UFO_MODULE] [--no-preserve-glyphsapp-metadata]
       [--enable-last-change] [--enable-automatic-alignment]
       [--expand-includes] DESIGNSPACE_FILE_OR_UFOS
       [DESIGNSPACE_FILE_OR_UFOS ...]

yes bestie, that's a lot of brackets. that's just how it is. every single one of those options is real and we're gonna go through all of them, no skipping, because i love you and i want you to actually know what you're typing. 🫶

---

👑 positional arguments: 👑

• DESIGNSPACE_FILE_OR_UFOS — okay so this is your main character. it's either a single designspace file or one or more UFOs that you want converted into a Glyphs file. one designspace, or a whole lil squad of UFOs, your call. and yeah, you can pass more of them, hence the ... up there in the synopsis. ✨

---

💅 options: 💅

• -h, --help — shows this help message and then dips. classic. shows the help, exits, done.
• --version — shows the program's version number and exits. that's it, that's the whole job, and it does it beautifully. 🌈
• --output-path OUTPUT_PATH — the path where your Glyphs file gets written. tell it where to put the baby. 👶
• --ufo-module UFO_MODULE — this one picks the default library used for reading UFOs. you choose between ufoLib2 and defcon, and heads up: the default is ufoLib2. so if you don't say anything, ufoLib2 is what you get. ✨

---

🦋 Roundtripping between UFOs and Glyphs: 🦋

this is the section for when you're going back and forth, back and forth, UFO → Glyphs → UFO, like a little ping-pong match. 🏓

• --no-preserve-glyphsapp-metadata — skips preserving Glyphs metadata in master UFOs and designspace file. and why would you want that metadata? because it's the stuff that gets used to minimize differences when you roundtrip between Glyphs and UFOs. so like… think before you reach for this one. 🙈
• --enable-last-change — stores the modification timestamp in glyphs. and honestly? unnecessary when you're using Git. git already knows when you changed stuff, bestie. it always knows. 💀
• --enable-automatic-alignment — enables automatic alignment of components in glyphs. components align themselves. slay. ✨
• --expand-includes — expands include statements in the UFO features.fea and inlines them into the exported .glyphs features. no more include, just the actual content, sitting right there. periodt. 💖

---

real talk for a sec: these flags are not vibes-only. the ones under Roundtripping between UFOs and Glyphs genuinely change how your metadata and features survive the trip. read the description of each one before you yeet it into a script, okay? i'm not being dramatic, i'm being a good friend. 🫶

---

and that's the whole page, bestie!! you now know every flag, every default, every path, the roundtripping caveats, the works. go convert something iconic. 👑

glyphsLib version 6.16.2 🎀 — dated October 2026 🌸 — and that's the sign-off from your favorite manual page, mwah 💜🦋