Menu
×
   ❮     
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP C C++ C# AWS W3.CSS HOW TO BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS DSA TYPESCRIPT ANGULAR ANGULARJS GIT POSTGRESQL MONGODB ASP AI R GO KOTLIN SWIFT SASS VUE GEN AI SCIPY CYBERSECURITY DATA SCIENCE INTRO TO PROGRAMMING INTRO TO HTML & CSS BASH RUST TOOLS MATH

Python Tutorial

Python HOME Python Intro Python Get Started Python Syntax Python Output Python Comments Python Variables Python Data Types Python Numbers Python Casting Python Strings Python Booleans Python Operators Python Lists Python Tuples Python Sets Python Dictionaries Python If...Else Python Match Python While Loops Python For Loops Python Functions Python Range Python Arrays Python Iterators Python Modules Python Dates Python Math Python JSON Python RegEx Python PIP Python Try...Except Python String Formatting Python None Python User Input Python VirtualEnv

Python Classes

Python OOP Python Classes/Objects Python __init__ Method Python self Parameter Python Class Properties Python Class Methods Python Magic Methods Python Inheritance Python Polymorphism Python Encapsulation Python Inner Classes

File Handling

Python File Handling Python Read Files Python Write/Create Files Python Delete Files

Python Modules

NumPy Tutorial Pandas Tutorial SciPy Tutorial Django Tutorial Playwright Tutorial

Python Turtle

Turtle Intro Turtle Move and Turn Turtle Pen Turtle Position Turtle Colors Turtle Shapes Turtle Fill Turtle Text Turtle Events Turtle Animation Turtle Projects

Python Tkinter

Tkinter Intro Tkinter Label Tkinter Button Tkinter Entry Tkinter Layout Tkinter Events Tkinter Check and Radio Tkinter Messagebox Tkinter Listbox Tkinter Text Tkinter Canvas Tkinter ttk Tkinter Menu Tkinter Timers Tkinter Project Tkinter To-Do List

Python Matplotlib

Matplotlib Intro Matplotlib Get Started Matplotlib Pyplot Matplotlib Plotting Matplotlib Markers Matplotlib Line Matplotlib Labels Matplotlib Grid Matplotlib Subplot Matplotlib Scatter Matplotlib Bars Matplotlib Histograms Matplotlib Pie Charts

Machine Learning

Getting Started Mean Median Mode Standard Deviation Percentile Data Distribution Normal Data Distribution Scatter Plot Linear Regression Polynomial Regression Multiple Regression Scale Train/Test Decision Tree Confusion Matrix Hierarchical Clustering Logistic Regression Grid Search Categorical Data K-means Bootstrap Aggregation Cross Validation AUC - ROC Curve K-nearest neighbors

Python DSA

Python DSA Lists and Arrays Stacks Queues Linked Lists Hash Tables Trees Binary Trees Binary Search Trees AVL Trees Graphs Linear Search Binary Search Bubble Sort Selection Sort Insertion Sort Quick Sort Counting Sort Radix Sort Merge Sort

Python MySQL

MySQL Get Started MySQL Create Database MySQL Create Table MySQL Insert MySQL Select MySQL Where MySQL Order By MySQL Delete MySQL Drop Table MySQL Update MySQL Limit MySQL Join

Python MongoDB

MongoDB Get Started MongoDB Create DB MongoDB Collection MongoDB Insert MongoDB Find MongoDB Query MongoDB Sort MongoDB Delete MongoDB Drop Collection MongoDB Update MongoDB Limit

Python Cert

Python Certificate

Python How To

Remove List Duplicates Reverse a String Add Two Numbers

Python Examples

Python Examples Python Videos Python Compiler Python Exercises Python Quiz Python Challenges Python Practice Problems Python Server Python Syllabus Python Study Plan Python Interview Q&A Python Training

Python Reference

Python Overview Python Built-in Functions Python String Methods Python List Methods Python Dictionary Methods Python Tuple Methods Python Set Methods Python File Methods Python Keywords Python Exceptions Python Glossary

Module Reference

Built-in Modules Random Module Requests Module Statistics Module Math Module cMath Module

Python Tkinter


Share

What is Tkinter?

Tkinter is a Python module for making desktop apps with a graphical user interface (GUI).

The GUI is the part of an app that you see and click on: windows, buttons, text fields and check boxes.

Tkinter is part of the Python standard library, so it is included when you install Python.

With Tkinter, you can make apps like this little game:

The Guess the Number window, with 37 in the text field and the text Correct! Tries: 3

You will build this game in the Tkinter Project chapter.


Your First Window

It only takes three lines of code to make a window:

Example

Create a window:

import tkinter as tk

window = tk.Tk()
window.mainloop()

Result:

An empty window with the title tk

Run Example »

Example Explained

  • import tkinter as tk imports the tkinter module, with the short name tk.
  • window = tk.Tk() creates the main window of the app, and stores it in a variable named window.
  • window.mainloop() shows the window, and keeps the app running until the window is closed. While it runs, it waits for the user to do something, like click a button.

Put window.mainloop() at the end of your code. Code after it does not run until the window is closed.

Note: In other Tkinter code, you will often see the main window named root. It is just a variable name, and works the same way.



Window Title and Size

Use title() to set the text in the title bar, and geometry() to set the size of the window:

Example

Set the title and size of the window:

import tkinter as tk

window = tk.Tk()
window.title("My App")
window.geometry("300x200")

window.mainloop()

Result:

An empty window, 300 pixels wide and 200 pixels high, with the title My App

Run Example »

The size is written as a string: the width, an x, and the height, in pixels.

Without a title, the window is called "tk", like in the first example.


Run Tkinter on Your Computer

Tkinter opens windows on your screen, so the examples work best on your own computer:

  1. Save the code in a file, for example app.py
  2. Run the file from the command line: python app.py
  3. The window opens

Note: Do not name your file tkinter.py. Python will then import your own file instead of the tkinter module, and the code will not work.

Our online editor cannot open windows. When you click "Run Example", you will see the code together with a picture of the result.

The pictures show the windows as they look on Windows. On macOS and Linux they look a little different, but they work the same way.

Linux: On some Linux systems, tkinter is not installed by default. On Ubuntu and Debian, you can install it with sudo apt install python3-tk.


Widgets

The things you put in a window, like text, buttons and text fields, are called widgets.

In the next chapters, you will learn how to use the most common widgets, and how to place them in the window.

Tip: You can find a list of Tkinter widgets and methods in our Python tkinter Module Reference.




Free account

Track your progress

XP earned 0 Day streak 0 Spaces 0 League —

New

Learn in Adventure Mode W3Schools Adventure App

Coding fundamentals as bite-sized lessons and challenges.

×

Contact Sales

If you want to use W3Schools services as an educational institution, team or enterprise, send us an e-mail:
sales@w3schools.com

Report Error

If you want to report an error, or if you want to make a suggestion, send us an e-mail:
help@w3schools.com

W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookies and privacy policy.

Copyright 1999-2026 by W3Schools. All Rights Reserved. W3Schools is Powered by W3.CSS.