Documentation Index Fetch the complete documentation index at: https://mintlify.com/TomSchimansky/CustomTkinter/llms.txt
Use this file to discover all available pages before exploring further.
Basic widgets are the building blocks of your CustomTkinter interface. They provide essential functionality for displaying content and handling user interactions.
CTkButton Clickable button for user actions and commands
CTkLabel Text and image display component
CTkFrame Container widget for grouping other widgets
A modern button widget for triggering actions and commands.
def button_callback (): print ( "Button clicked!" ) button = ctk.CTkButton( app, text = "Click Me" , command = button_callback, width = 200 , height = 40 ) button.pack( pady = 20 )
Key Features:
Customizable colors, fonts, and borders
Support for icons and images
Hover effects and state management
Corner radius customization
Multiple text alignments
View Full API Reference → CTkLabel Displays text and images with modern styling.
label = ctk.CTkLabel( app, text = "Welcome to CustomTkinter" , font = ( "Arial" , 24 ), text_color = "#3B8ED0" ) label.pack( pady = 10 ) # Label with image image = ctk.CTkImage( light_image = Image.open( "icon.png" ), size = ( 30 , 30 )) icon_label = ctk.CTkLabel(app, image = image, text = "" ) icon_label.pack()
Key Features:
Text and image display
Custom fonts and colors
Text wrapping support
Anchor and justify options
Compound layouts (text + image)
View Full API Reference → CTkFrame A container widget for organizing and grouping other widgets.
frame = ctk.CTkFrame( app, width = 300 , height = 200 , corner_radius = 10 , fg_color = "transparent" ) frame.pack( pady = 20 , padx = 20 , fill = "both" , expand = True ) # Add widgets to the frame label = ctk.CTkLabel(frame, text = "Inside Frame" ) label.pack( pady = 10 ) button = ctk.CTkButton(frame, text = "Frame Button" ) button.pack( pady = 10 )
Key Features:
Groups related widgets together
Customizable background colors
Border and corner radius options
Works with all geometry managers (pack, grid, place)
Supports nesting for complex layouts
View Full API Reference → Common Patterns button_frame = ctk.CTkFrame(app) button_frame.pack( pady = 20 ) ctk.CTkButton(button_frame, text = "Save" ).pack( side = "left" , padx = 5 ) ctk.CTkButton(button_frame, text = "Cancel" ).pack( side = "left" , padx = 5 ) ctk.CTkButton(button_frame, text = "Apply" ).pack( side = "left" , padx = 5 )
Card-Style Layout card = ctk.CTkFrame(app, corner_radius = 15 ) card.pack( pady = 10 , padx = 10 , fill = "x" ) title = ctk.CTkLabel(card, text = "Card Title" , font = ( "Arial" , 18 , "bold" )) title.pack( pady = ( 10 , 5 ), padx = 10 , anchor = "w" ) description = ctk.CTkLabel(card, text = "Card description goes here" ) description.pack( pady = ( 0 , 10 ), padx = 10 , anchor = "w" ) action_button = ctk.CTkButton(card, text = "Action" ) action_button.pack( pady = ( 0 , 10 ), padx = 10 )