Matplotlib Theme Tweaker

A simple GUI tool for adjusting, previewing, and managing matplotlib style sheets.

Current version (0.1.0) has only been tested on Windows platforms. Issues may arise on other platforms.

Installation

The software was developed using Python 3.13 and currently supports the following installation methods:

pipx

pipx install mpl-theme-tweaker

uv tool

uv tool install mpl-theme-tweaker

For Windows users, you can also directly download the precompiled executable from the Release page.
Install from source code. This project uses uv as the dependency management tool. It is recommended to use uv to install project dependencies. After downloading, run the following command to install dependencies:

uv sync

Basic Usage

After installing via methods 1-3 above, you can run the mpl-theme-tweaker command in the command line or double-click the application icon to start the tool. If you installed via method 4, you need to execute the main.py file to run the software. The software interface is as follows:

gui

Users can adjust parameters in different configuration sections and observe the changes on the image.

File menu: Used to export style files
View menu: Used to control software views and themes
Style menu: Used to switch between different style sheets

Multi-language Support

The software uses Python's gettext module for internationalization, and uses the Gnu gettext tool to create translation files with the following command:

msgfmt messages.<LANG_ID_CODE>.po -o messages.mo

Currently supports Chinese and English. Translation files are located in the src/mpl_theme_tweaker/assets/locale/ directory. Users who need other languages can copy the messages.en.po file and translate it themselves.

Todo

Custom formula fonts
Add more example images
Add code tests (multi-platform)

Metadata

Release files for mpl-theme-tweaker 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for mpl-theme-tweaker 0.1.1
File	Interpreter	ABI	Platform	Actions Reset
mpl_theme_tweaker-0.1.1-py3-none-any.whl 20.3 MB Dec 8, 2025 Without provenance	Python 3	none	any	Details for mpl_theme_tweaker-0.1.1-py3-none-any.whl

Release files / mpl_theme_tweaker-0.1.1-py3-none-any.whl

Download URL	mpl_theme_tweaker-0.1.1-py3-none-any.whl
Size	20.3 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`3509170a2d89af70aa2037b760e38999c278650e09043d1b0d4a84eda56aad17`
BLAKE2b-256 checksum How to use checksums	`370cea671b44df2393a5d881db336916e50e073afcb9fa05949f95c03e4b139b`
Upload date	Dec 8, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.13.2`

Security for mpl-theme-tweaker 0.1.1

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

Dec 8, 2025 1 release file No provenance

0.1.0