Metadata-Version: 2.4
Name: ctk-theme-builder
Version: 3.2.12
Summary: A desktop theme editor for building and previewing CustomTkinter themes.
License-Expression: MIT
License-File: LICENSE
Keywords: customtkinter,tkinter,theme,gui,desktop
Author: Clive Bostock
Requires-Python: >=3.10,<3.14
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: X11 Applications
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: User Interfaces
Requires-Dist: CTkMessagebox (==2.5)
Requires-Dist: bump2version (>=1.0.1,<2.0.0)
Requires-Dist: colorharmonies (==1.0.5)
Requires-Dist: colour (==0.1.5)
Requires-Dist: contourpy (==1.3.2)
Requires-Dist: ctkfontawesome[images] (>=0.6.0,<0.7.0)
Requires-Dist: ctktooltip (==0.9)
Requires-Dist: customtkinter (==5.2.2)
Requires-Dist: cycler (==0.12.1)
Requires-Dist: darkdetect (==0.8.0)
Requires-Dist: distro (==1.9.0)
Requires-Dist: fonttools (==4.59.0)
Requires-Dist: importlib-resources (==6.1.1)
Requires-Dist: kiwisolver (==1.4.8)
Requires-Dist: loguru (==0.7.2)
Requires-Dist: matplotlib (==3.10.5)
Requires-Dist: numpy (==2.2.6)
Requires-Dist: packaging (==23.2)
Requires-Dist: pathvalidate (==3.2.0)
Requires-Dist: pillow (==11.3.0)
Requires-Dist: pyparsing (==3.1.1)
Requires-Dist: pyperclip (==1.8.2)
Requires-Dist: python-dateutil (==2.8.2)
Requires-Dist: scikit-build (==0.17.6)
Requires-Dist: six (==1.16.0)
Requires-Dist: tomli (==2.0.1)
Requires-Dist: zipp (==3.15.0)
Project-URL: Homepage, https://github.com/avalon60/ctk_theme_builder
Project-URL: Issues, https://github.com/avalon60/ctk_theme_builder/issues
Project-URL: Repository, https://github.com/avalon60/ctk_theme_builder
Description-Content-Type: text/markdown

# CTk Theme Builder

![CTk Theme Builder](assets/images/ctk-tb-logo.png)

CTk Theme Builder is a desktop editor for creating, previewing, and refining themes for [CustomTkinter](https://github.com/TomSchimansky/CustomTkinter) applications.

It provides a live preview workflow for adjusting colours, geometry, palettes, and theme metadata without editing theme JSON files by hand.

## Features

- Visual theme editing with live preview
- Support for light and dark theme variants
- Theme geometry editing for supported widget properties
- Palette management and colour harmonics tools
- Theme merge and import/export support
- Provenance tracking for theme metadata
- Built-in theme and palette assets to get started quickly

## Installation

Recommended installation from PyPI, using a virtual environment:

```bash
python -m venv .venv
source .venv/bin/activate
pip install ctk-theme-builder
```

On Windows PowerShell:

```powershell
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install ctk-theme-builder
```

Alternative install methods for users who already use `uv`:

```bash
uv pip install ctk-theme-builder
uvx --from ctk-theme-builder ctk-theme-builder
```

## Usage

Launch the application:

```bash
ctk-theme-builder
```

Optional command-line arguments:

```bash
ctk-theme-builder --set-appearance Dark
ctk-theme-builder --set-theme /path/to/theme.json
```

To migrate themes and palettes from a legacy installation:

```bash
ctktb-migrate-assets /path/to/old/install
```

## Requirements

- Python 3.10 to 3.13
- A desktop environment capable of running Tk-based GUI applications

## Documentation

- Installation and upgrade notes: [docs/installs-upgrades.md](docs/installs-upgrades.md)
- User guide: [docs/UserGuide-3.2.md](docs/UserGuide-3.2.md)
- Release notes: [release-notes-3.2.9.md](release-notes-3.2.9.md)
- Source code and issue tracker: [GitHub repository](https://github.com/avalon60/ctk_theme_builder)

## Licence

Released under the MIT Licence. See [LICENSE](LICENSE).

