font-manager(1)

📦
version 0.9.4 · 2 versions
, in alpine 3.24, arch rolling, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 font-manager — the manual page, bestie edition 💖

okay so you know how fonts on a GTK+ desktop can be a whole situation? yeah. this is font-manager, and this is its manual page (font-manager(1)), and I'm about to walk you through it like we're texting at 2am. no gatekeeping, fr fr. 🫶

✨ NAME ✨

font-manager — Simple font management for GTK+ desktop environments 🌸

like. the name says it. it manages fonts. for GTK+ desktops. simple. iconic behaviour, honestly.

🌈 SYNOPSIS 🌈

font-manager [-a] [-v] [-l] [--list-full] [-e family] [-d family]
             [-i filepath] [-u] [--keep family]

that's the whole vibe. all those little flags? we're gonna go through every single one below, don't you dare scroll past. 👑

💅 DESCRIPTION 💅

So font-manager exists to give average users a way to easily manage desktop fonts — without having to resort to command line tools or editing configuration files by hand. Yes, bestie, you could go hand-edit your config like some kind of ancient wizard, but why would you when this exists?? 😭

While it was designed primarily with the Gnome Desktop Environment in mind, it should work well with other Gtk+ desktop environments too. so like. it's not gonna be weird about it. it plays nice. 🦋

🎀 OPTIONS 🎀

one bullet per flag, all of them, no skipping, periodt:

  • -a, --about — tells you about the application 💖
  • -v, --version — shows the application version ✨
  • -l, --list — lists the available font families 📋
  • --list-full — a full listing that also includes face information, and it comes out as JSON 🔥
  • -e, --enable family ... — a space separated list of font families to enable ✅
  • -d, --disable family ... — a space separated list of font families to disable 🙈
  • -i, --install filepath ... — a space separated list of files to install 📥
  • -u, --update — update the application database 🔄
  • --keep family ... — a space separated list of font families to keep while disabling all the others. This option is case insensitive and allows for partial matches. 🫶

⚠️ Caution (about --keep) ⚠️

bestie. listen. While the --keep option will require at least one font family to remain enabled, it makes no attempt to ensure that it is a suitable replacement for required system fonts. It does not check. It does not care. It just does the thing. 💀

also worth knowing, and this one's important:

The --enable option with no arguments should enable all available fonts. 🌈

🗂️ FILES 🗂️

here's where everything lives, so you can stop asking me where everything lives:

  • $XDG_DATA_HOME/fonts — Default user font directory. 🏠
  • $XDG_CACHE_HOME/font-manager — Application data which can safely be deleted. 🗑️ (yes, safely, go off)
  • $XDG_CONFIG_HOME/font-manager — Application specific configuration files. ⚙️
  • $XDG_CONFIG_HOME/fontconfig/conf.d — Generated fontconfig configuration files. 🧚
  • $XDG_CONFIG_HOME/dconf/user — User interface preferences. 🎨

and the lore behind all those XDG variables:

🚧 LIMITATIONS 🚧

real talk time. font-manager is a user level application, so it will not allow installation to, or removal of fonts from, anywhere other than the default user font directory. that's the boundary. that's the line. it's not crossing it. 🙅

<b>However</b> — and this is the fun part — the application does allow users to disable system fonts, and it also makes it easy to add font directories. so you get range, you just don't get everything. balance. 💅

🐛 BUG REPORTS 🐛

found a bug? got a feature request? do <b>not</b> suffer in silence, bestie. file it at:

https://github.com/FontManager/master/issues

and please — please — ensure that you are using a recent release. reporting a bug from a version from 400 years ago is not the serve you think it is. 😭

👑 AUTHOR 👑

Jerry Casiano <JerryCasiano@gmail.com>

the mastermind. the main character. we love them. 🫶

and that's the whole page, bestie!! ✨ you just read font-manager(1), version 0.9.4, and honestly? you ate. 💅 if you ever forget any of this, the manual page is right there waiting for you, exactly like this, forever. go forth and manage those fonts. 🌸💖🦋

📦 where this page comes from