Manage document themes: list bundled themes, import .thmx files, apply themes to documents, or auto-transition from Microsoft themes to Uniword equivalents.

1. Subcommands

Subcommand Description

list

List all bundled themes

import

Import .thmx files to YAML

apply INPUT OUTPUT

Apply a theme to a document

fonts INPUT OUTPUT

Replace the theme’s font scheme (Design → Fonts gallery)

colors INPUT OUTPUT

Replace the theme’s color scheme (Design → Colors gallery)

auto INPUT OUTPUT

Auto-transition MS theme to Uniword equivalent

2. list

Display all themes bundled with Uniword.

uniword theme list
uniword theme list --verbose

--verbose shows theme name, color count, and variant count for each entry.

3. import

Import Office .thmx theme files to YAML format for faster loading and human readability.

uniword theme import
uniword theme import --source themes/ --output data/themes

--source sets the input directory (default: references/word-package/office-themes).

--output sets the output directory (default: data/themes).

4. apply

Apply a bundled or file-based theme to a document.

# Apply a bundled theme by name
uniword theme apply input.docx output.docx --name atlas

# Apply with a specific variant
uniword theme apply input.docx output.docx --name atlas --variant 2

# Apply a .thmx file
uniword theme apply input.docx output.docx --file themes/Office.thmx

Options:

--name

Bundled theme name (e.g., atlas, celestial, meridian)

--file

Path to a .thmx file

--variant

Theme variant number (e.g., 1, 2)

--verbose, -v

Show detailed output

You must specify --name or --file, but not both.

5. fonts

Replace the document theme’s font scheme (major/minor fonts) while keeping its colors and formats — the CLI equivalent of Word’s Design → Fonts gallery. Reads from the 25 bundled font schemes.

# Apply a bundled font scheme
uniword theme fonts input.docx output.docx --name carlito_sans

# List available font schemes
uniword theme fonts --list

Options:

--name

Bundled font scheme name (e.g., carlito_sans)

--list

List available bundled font schemes and exit

--verbose, -v

Verbose output

When --list is passed, no document is required.

6. colors

Replace the document theme’s color scheme while keeping its fonts and formats — the CLI equivalent of Word’s Design → Colors gallery. Reads from the 23 bundled color schemes.

# Apply a bundled color scheme
uniword theme colors input.docx output.docx --name emerald

# List available color schemes
uniword theme colors --list

Options:

--name

Bundled color scheme name (e.g., emerald)

--list

List available bundled color schemes and exit

--verbose, -v

Verbose output

When --list is passed, no document is required.

7. auto

Detect the Microsoft Word theme in a document and automatically replace it with the matching Uniword theme using color fingerprint matching.

uniword theme auto ms_report.docx uniword_report.docx
uniword theme auto input.docx output.docx --verbose

This replaces proprietary Microsoft fonts with open-source alternatives.

8. Bundled themes

Uniword ships with 29 Office themes including Atlas, Berlin, Celestial, Facet, Gallery, Ion, Madison, Office, Organic, Slice, and Wood Type. Use uniword theme list to see all available names.