ftcli name

Utilities for editing the name table.

Usage

ftcli name [OPTIONS] COMMAND [ARGS]...

build-full-name

Builds the NameID 4 (Full Font Name).

Usage

ftcli name build-full-name [OPTIONS] INPUT_PATH

Options

-p, --platform-id <platform_id>

Specify the platform ID to build the Full Name for.

Options:

1 | 3

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

build-mac-names

Builds the Macintosh-specific names.

The following names are built: 1 (Font Family Name), 2 (Font Subfamily Name), 4 (Full Font Name), 5 (Version String), 6 (PostScript Name).

Usage

ftcli name build-mac-names [OPTIONS] INPUT_PATH

Options

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

build-postscript-name

Builds the NameID 6 (PostScript Name).

Usage

ftcli name build-postscript-name [OPTIONS] INPUT_PATH

Options

-p, --platform-id <platform_id>

Specify the platform ID to build the PostScript Name for.

Options:

1 | 3

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

build-unique-id

Builds the NameID 3 (Unique ID).

If the --alternate flag is set, the unique ID is built using the following fields:

Manufacturer Name: Family Name - Subfamily Name: Creation Year

Otherwise, the unique ID is built using the following fields (Default):

Font Revision;Vendor ID;PostScript Name

Usage

ftcli name build-unique-id [OPTIONS] INPUT_PATH

Options

-alt, --alternate

Build the unique ID using the font’s family name and subfamily name.

-p, --platform-id <platform_id>

Specify the platform ID to build the unique ID for.

Options:

1 | 3

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

build-version-string

Builds the NameID 5 (Version String).

Usage

ftcli name build-version-string [OPTIONS] INPUT_PATH

Options

-p, --platform-id <platform_id>

Specify the platform ID to build the Version String for.

Options:

1 | 3

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

del-empty-names

Deletes empty NameRecords from the name table.

Usage

ftcli name del-empty-names [OPTIONS] INPUT_PATH

Options

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

del-mac-names

Delete Macintosh-specific NameRecords from the name table, excluding those with nameID 1, 2, 4, 5 and 6. If the --del-all flag is set, all Macintosh-specific NameRecords are deleted.

Usage

ftcli name del-mac-names [OPTIONS] INPUT_PATH

Options

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

del-names

Delete the specified NameRecords from the name table.

Usage

ftcli name del-names [OPTIONS] INPUT_PATH

Options

-n, --name-ids <name_ids_to_process>

Required Specify the name IDs to be delete.

Example: -n 1 -n 2 will delete name IDs 1 and 2.

-p, --platform-id <platform_id>

Specify the platform ID of the NameRecords to delete.

Example: -p 1 will modify only NameRecords with platform ID 1.

-l, --language-string <language_string>

Specify the language of the NameRecords to be modified.

Example: -l en will modify only NameRecords with language code “en”.

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

del-unused-names

Delete unused NameRecords from the name table.

Usage

ftcli name del-unused-names [OPTIONS] INPUT_PATH

Options

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

find-replace

Find and replace text in the specified NameRecords.

Usage

ftcli name find-replace [OPTIONS] INPUT_PATH

Options

-os, --old-string <old_string>

Required The string to be replaced in the NameRecords.

-ns, --new-string <new_string>

Required The string to replace the old string with in the NameRecords.

-n, --name-ids <name_ids_to_process>

Specify the name IDs to be modified.

Example: -n 1 -n 2 will modify name IDs 1 and 2.

-s, --skip-name-ids <name_ids_to_skip>

Specify the name IDs to skip.

Example: -s 1 -s 2 will skip name IDs 1 and 2.

-p, --platform-id <platform_id>

Specify the platform ID of the NameRecords to modify.

Example: -p 1 will modify only NameRecords with platform ID 1.

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

set-name

Set the string of the specified NameRecord in the name table.

Usage

ftcli name set-name [OPTIONS] INPUT_PATH

Options

-s, --string <name_string>

Required The string to set in the NameRecord

-n, --name-id <name_id>

Required The name ID of the NameRecord to set

-p, --platform-id <platform_id>

Specify the platform ID of the NameRecords to add.

1: Macintosh

3: Windows

Example: -p 1 will only add NameRecords with platform ID 1.

Options:

1 | 3

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument

strip-names

Remove leading and trailing whitespace from the NameRecords.

Usage

ftcli name strip-names [OPTIONS] INPUT_PATH

Options

-r, --recursive

Recursively find font files both in input directory and its subdirectories.

Only applicable if INPUT_PATH is a directory.

-out, --output-dir <output_dir>

The directory where output files are to be saved.

If not specified, files will be saved to the same folder.

If the output directory doesn’t exist, it will be created, as well as any missing parent directories.

-ow, --overwrite, -no-ow, --no-overwrite

Do not overwrite existing files on save.

If a file with the same name as the output file already exists, the command will suffix the filename with a number (#1, #2, etc.).

By default, existing files are overwritten.

-rbb, --recalc-bboxes, -no-rbb, --no-recalc-bboxes

Do not recalculate the font’s bounding boxes on save.

By default, glyf, CFF ``, ``head bounding box values and hhea/vhea min/max values are recalculated on save. Also, the glyphs are compiled on importing, which saves memory consumption and time.

-rtb, --reorder-tables

Reorder the font’s tables on save.

When this option is active, tables are sorted by tag on save (recommended by the OpenType specification).

-rts, --recalc-timestamp

Set the modified timestamp in the head table on save.

By default, the original modified timestamp is kept.

Arguments

INPUT_PATH

Required argument