{"id":1237,"date":"2020-11-25T01:37:43","date_gmt":"2020-11-25T01:37:43","guid":{"rendered":"https:\/\/www.pythontutorial.net\/?page_id=1237"},"modified":"2025-04-03T08:31:49","modified_gmt":"2025-04-03T08:31:49","slug":"tkinter-hello-world","status":"publish","type":"page","link":"https:\/\/www.pythontutorial.net\/tkinter\/tkinter-hello-world\/","title":{"rendered":"Tkinter Hello, World!"},"content":{"rendered":"\r\n

Summary<\/strong>: in this tutorial, you’ll learn step-by-step how to develop the Tkinter<\/code> “Hello, World!” program.<\/p>\r\n\r\n\r\n\r\n

Creating a window #<\/a><\/h2>\r\n\r\n\r\n\r\n

The following program shows how to display a window<\/a> on the screen:<\/p>\r\n\r\n\r\n

import<\/span> tkinter as<\/span> tk\r\n\r\nroot = tk.Tk()\r\nroot.mainloop()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\r\n\r\n\r\n
If you execute the program, you’ll see the following window:<\/p>\r\n\r\n\r\n
\r\n
\"\"<\/figure>\r\n<\/div>\r\n\r\n\r\n
How it works.<\/p>\r\n\r\n\r\n\r\n
First, import the tkinter<\/code> module as tk<\/code> to the program:<\/p>\r\n\r\n\r\n
import<\/span> tkinter as<\/span> tk<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\r\n\r\n\r\n
Second, create an instance of the tk.Tk<\/code> class that will create the application window:<\/p>\r\n\r\n\r\n
root = tk.Tk()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\r\n\r\n\r\n
By convention, the main window in Tkinter is called root<\/code>. But you can use any other name like window<\/code>.<\/p>\r\n\r\n\r\n\r\n
Third, call the mainloop()<\/code> method of the main window object:<\/p>\r\n\r\n\r\n
root.mainloop()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\r\n\r\n\r\n
The mainloop()<\/code> method ensures the main window remains visible on the screen.<\/p>\r\n\r\n\r\n\r\n
If you don’t call the mainloop()<\/code> method, the main window will display and disappear almost instantly – too quickly to perceive its appearance.<\/p>\r\n\r\n\r\n\r\n
Additionally, the mainloop()<\/code> method ensures the main window continues to display and run until you close it.<\/p>\r\n\r\n\r\n\r\n
Typically, in a Tkinter program, you place the call to the mainloop()<\/code> method as the last statement after creating the widgets.<\/p>\r\n\r\n\r\n\r\n
Troubleshooting #<\/a><\/h2>\r\n\r\n\r\n\r\n
The tkinter<\/code> module is a built-in Python module. But sometimes, it is not the case. For example, on Ubuntu, you may encounter the following error:<\/p>\r\n\r\n\r\n
ImportError: No module<\/span> named Tkinter<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\r\n\r\n\r\n
In this case, you need to install tkinter<\/code> module using the following command line:<\/p>\r\n\r\n\r\n
sudo apt-get<\/span> install python3-tk<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\r\n\r\n\r\n
Displaying a label #<\/a><\/h2>\r\n\r\n\r\n\r\n
Now, let’s place a component on the window. In Tkinter, these components are referred to as widgets<\/strong>.<\/p>\r\n\r\n\r\n\r\n
The following code adds a label <\/a>widget to the main window:<\/p>\r\n\r\n\r\n
import<\/span> tkinter as<\/span> tk\r\n\r\n\r\nroot = tk.Tk()\r\n\r\n# place a label on the root window<\/span>\r\nmessage = tk.Label(root, text=\"Hello, World!\"<\/span>)\r\nmessage.pack()\r\n\r\n# keep the window displaying<\/span>\r\nroot.mainloop()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\r\n\r\n\r\n
If you run the program, you’ll see the following window:<\/p>\r\n\r\n\r\n
\r\n
\"Tkinter<\/figure>\r\n<\/div>\r\n\r\n\r\n
How it works:<\/p>\r\n\r\n\r\n\r\n
To create a widget that belongs to a window, you use the following syntax:<\/p>\r\n\r\n\r\n
widget = WidgetName(master, **kw)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\r\n\r\n\r\n
In this syntax:<\/p>\r\n\r\n\r\n\r\n
Keep in mind that you’ll learn more about the Label<\/code> widget<\/a> in the upcoming tutorial.<\/p>\r\n\r\n\r\n\r\n