Skip to main content
CustomTkinter provides a rich set of modern UI widgets built on top of Tkinter. All widgets support appearance modes (light/dark) and custom theming.

Widget Categories

Windows

Main application windows and dialogs

Basic Widgets

Fundamental UI components like buttons, labels, and frames

Input Widgets

Interactive controls for user input and selections

Display Widgets

Components for displaying information and progress

Layout Widgets

Advanced containers for organizing complex layouts

Common Features

All CustomTkinter widgets share these features:
  • Appearance Mode Support: Automatic light/dark mode switching
  • Custom Theming: Built-in themes with customization options
  • DPI Scaling: Automatic high-DPI display support
  • Modern Design: Clean, contemporary look and feel
  • Tkinter Compatible: Works seamlessly with existing Tkinter code

Quick Start

Every CustomTkinter widget follows a consistent API pattern:
import customtkinter as ctk

# Create main window
app = ctk.CTk()
app.title("My App")

# Add widgets
button = ctk.CTkButton(app, text="Click Me")
button.pack(pady=20)

app.mainloop()

Next Steps

Explore each widget category to learn about specific components and their usage:

Build docs developers (and LLMs) love