Skip to content

TTK Creator

TTK Creator is packaged with ttkbootstrap so that you can modify, save, export, and import themes that you have created.

To run the program, type the following command in the console after you have installed ttkbootstrap:

python -m ttkcreator


Create a new theme

All of the controls for changing the theme are on the left-side control frame.

  1. Name your theme using the name entry

  2. Select a base theme; this will setup the initial colors

  3. Select a color for each color keyword using one of two options

    • Click the 🎨 button to choose a color from the color dialog
    • Or, type a hexadecimal or valid color name
  4. Click the Save button

Your theme is now saved in the file

Reset your theme

If you want to reset your color choices, you can click the Reset option from the top menu to reset all of the colors to the base theme colors.

Import user themes

If you have a user themes file that is in the format specified below, you can import that file into ttkbootstrap.

  1. Click the Import button on the top menu

  2. Select the themes file you wish to import, then click Ok to import


Importing a user themes file will overwrite the existing user defined themes within ttkbootstrap; so make sure you export your existing theme set if you wish to keep it

The file contains a dictionary of user defined themes. The file that you import must match the pattern illustrated below.

    "supercosmo": {
        "type": "light",
        "colors": {
            "primary": "#2780e3",
            "secondary": "#7E8081",
            "success": "#3fb618",
            "info": "#9954bb",
            "warning": "#ff7518",
            "danger": "#ff0039",
            "dark": "#373A3C",
            "bg": "#ffffff",
            "fg": "#373a3c",
            "selectbg": "#7e8081",
            "selectfg": "#ffffff",
            "border": "#ced4da",
            "inputfg": "#373a3c",
            "inputbg": "#fdfdfe"

Export user themes

User defined themes can be exported into the format specified above

  1. Click the Export button from the top menu

  2. Navigate to the location that you wish to export

  3. Select a valid file name; the extension is .py by default

  4. Click Ok to save the exported settings