Skip to content
Snippets Groups Projects
README.md 5.52 KiB
Newer Older
Boyuan Yang's avatar
Boyuan Yang committed
|[English](README.md)|[Română](README.ro.md)|
|--------------------|----------------------|
Boyuan Yang's avatar
Boyuan Yang committed
# Font Manager <img src="help/C/media/com.github.FontManager.FontManager-48.png" align="right">
Boyuan Yang's avatar
Boyuan Yang committed

A simple font management application for GTK Desktop Environments

Boyuan Yang's avatar
Boyuan Yang committed
![Main Window](https://raw.githubusercontent.com/FontManager/font-manager/master/help/C/media/main-window.png)
Boyuan Yang's avatar
Boyuan Yang committed

Font Manager is intended to provide a way for average users to easily manage desktop fonts, without having to resort to command line tools or editing configuration files by hand. While designed primarily with the Gnome Desktop Environment in mind, it should work well with other GTK desktop environments.

Font Manager is NOT a professional-grade font management solution.

## Features

- Preview and compare font files
- Activate or deactivate installed font families
- Automatic categorization based on font properties
Boyuan Yang's avatar
Boyuan Yang committed
- Google Fonts Catalog integration
Boyuan Yang's avatar
Boyuan Yang committed
- Integrated character map
- User font collections
- User font installation and removal
- User font directory settings
- User font substitution settings
- Desktop font settings (GNOME Desktop or compatible environments)

Boyuan Yang's avatar
Boyuan Yang committed
## Localization
Boyuan Yang's avatar
Boyuan Yang committed

Font Manager is being translated using [Weblate](https://weblate.org), a web tool designed to ease translating for both developers and translators.

If you would like to help this application reach more users in their native language please visit the [project page on Weblate](https://hosted.weblate.org/engage/font-manager/).

<a href="https://hosted.weblate.org/engage/font-manager/">
<img src="https://hosted.weblate.org/widgets/font-manager/-/svg-badge.svg" alt="Translation status" />
</a>

Boyuan Yang's avatar
Boyuan Yang committed
## Installation

Boyuan Yang's avatar
Boyuan Yang committed
### Distribution packages

#### Arch User Repository
Arch Linux users can install [`font-manager`](https://archlinux.org/packages/extra/x86_64/font-manager/) from official repositories:
Boyuan Yang's avatar
Boyuan Yang committed
```bash
pacman -S font-manager
```
Boyuan Yang's avatar
Boyuan Yang committed

#### Fedora COPR

[![Copr build status](https://copr.fedorainfracloud.org/coprs/jerrycasiano/FontManager/package/font-manager/status_image/last_build.png)](https://copr.fedorainfracloud.org/coprs/jerrycasiano/FontManager/package/font-manager/)

Fedora packages built from latest revision:

Boyuan Yang's avatar
Boyuan Yang committed
```bash
Boyuan Yang's avatar
Boyuan Yang committed
dnf copr enable jerrycasiano/FontManager
dnf install font-manager
```

#### Gentoo
Boyuan Yang's avatar
Boyuan Yang committed
Gentoo users may find [`font-manager`](https://github.com/PF4Public/gentoo-overlay/tree/master/app-misc/font-manager) in [::pf4public](https://github.com/PF4Public/gentoo-overlay) Gentoo overlay

#### Ubuntu Personal Package Archive
Ubuntu packages built from latest revision:

Boyuan Yang's avatar
Boyuan Yang committed
```bash
Boyuan Yang's avatar
Boyuan Yang committed
sudo add-apt-repository ppa:font-manager/staging
sudo apt-get update
sudo apt-get install font-manager
```

Boyuan Yang's avatar
Boyuan Yang committed
#### File Manager extensions
Boyuan Yang's avatar
Boyuan Yang committed
Fedora and Ubuntu users can also find extensions for Nautilus, Nemo and Thunar in the repositories.
Boyuan Yang's avatar
Boyuan Yang committed
The extension currently allows you to quickly preview font files by simply selecting them in the file manager while font-viewer is open and also adds an option to install font files in the file manager context menu.
Boyuan Yang's avatar
Boyuan Yang committed
The Thunar extension also has very basic bulk renamer support.
Boyuan Yang's avatar
Boyuan Yang committed

### Building from source

You'll need to ensure the following dependencies are installed:

Boyuan Yang's avatar
Boyuan Yang committed
- `meson >= 0.59`
Boyuan Yang's avatar
Boyuan Yang committed
- `ninja`
Boyuan Yang's avatar
Boyuan Yang committed
- `glib >= 2.62`
Boyuan Yang's avatar
Boyuan Yang committed
- `vala >= 0.56`
- `freetype2 >= 2.10`
- `gtk+-4.0 >= 4.12`
- `json-glib-1.0 >= 1.5`
- `libxml-2.0 >= 2.9.10`
- `sqlite3 >= 3.35`
Boyuan Yang's avatar
Boyuan Yang committed
- `gobject-introspection`
Boyuan Yang's avatar
Boyuan Yang committed
- `yelp-tools` (optional)
- `gettext` (optional)

Boyuan Yang's avatar
Boyuan Yang committed
If you wish to also build file manager extensions, you will need corresponding development libraries:
Boyuan Yang's avatar
Boyuan Yang committed
- `libnautilus-extension`
- `libnemo-extension`
- `thunar`
Boyuan Yang's avatar
Boyuan Yang committed
If you wish to also build Google Fonts integration, which is enabled by default, the following libraries are required:
Boyuan Yang's avatar
Boyuan Yang committed
- `webkitgtk-6.0 >= 2.4`
- `libsoup3 >= 3.2`
Boyuan Yang's avatar
Boyuan Yang committed
To build the application:

Boyuan Yang's avatar
Boyuan Yang committed
```bash
Boyuan Yang's avatar
Boyuan Yang committed
meson --prefix=/usr --buildtype=release build
cd build
ninja
```

To run the application without installing:

Boyuan Yang's avatar
Boyuan Yang committed
```bash
Boyuan Yang's avatar
Boyuan Yang committed
src/font-manager/font-manager
```

To install the application:

Boyuan Yang's avatar
Boyuan Yang committed
```bash
Boyuan Yang's avatar
Boyuan Yang committed
sudo ninja install
```

To uninstall:

Boyuan Yang's avatar
Boyuan Yang committed
```bash
Boyuan Yang's avatar
Boyuan Yang committed
sudo ninja uninstall
```

Boyuan Yang's avatar
Boyuan Yang committed
For a list of available build options:

Boyuan Yang's avatar
Boyuan Yang committed
```bash
Boyuan Yang's avatar
Boyuan Yang committed
meson configure
```

To change an option after the build directory has been configured:

Boyuan Yang's avatar
Boyuan Yang committed
```bash
Boyuan Yang's avatar
Boyuan Yang committed
meson configure -Dsome_option=true
```

Boyuan Yang's avatar
Boyuan Yang committed
### Flatpak

Please see [Known Issues](https://github.com/FontManager/font-manager/issues/272) before installing.

<a href='https://flathub.org/apps/details/org.gnome.FontManager'><img width='220' alt='Download on Flathub' src='https://flathub.org/assets/badges/flathub-badge-i-en.png'/></a>

- Access to xdg-config/fontconfig is necessary for other Flatpak applications to recognize changes made by Font Manager. You can use an application such as [Flatseal](https://flathub.org/apps/details/com.github.tchx84.Flatseal) or add --filesystem=xdg-config/fontconfig to the command used to launch the application. This needs to be done for every installed Flatpak application.

- Archive support does not work in Flatpak builds


Boyuan Yang's avatar
Boyuan Yang committed
## License

This project is licensed under the GNU General Public License Version 3.0 - see
[COPYING](COPYING) for details.

## Acknowledgements

- Karl Pickett for getting the ball rolling with [fontmanager.py](https://raw.githubusercontent.com/FontManager/font-manager/6b9b351538b5118d07f6d228f3b42c91183b8b73/fontmanager.py)
- The compare mode in Font Manager is modeled after [gnome-specimen](https://launchpad.net/gnome-specimen) by Wouter Bolsterlee
Boyuan Yang's avatar
Boyuan Yang committed
- Font Manager makes use of data compiled for [Fontaine](https://www.unifont.org/fontaine/) by Edward H. Trager
Boyuan Yang's avatar
Boyuan Yang committed
- The character map in Font Manager is based on [Gucharmap](https://wiki.gnome.org/action/show/Apps/Gucharmap)