63

When I tried to change the window icon in the top left corner from the ugly red "TK" to my own favicon using the code below, Python threw an error:

from tkinter import *
root = Tk()

#some buttons, widgets, a lot of stuff

root.iconbitmap('favicon.ico')

This should set the icon to 'favicon.ico' (according to a lot of forum posts all over the web). But unfortunately, all this line does is throw the following error:

Traceback (most recent call last):
  File "d:\ladvclient\mainapp.py", line 85, in <module>
    root.iconbitmap(bitmap='favicon.ico')
  File "C:\Python33\lib\tkinter\__init__.py", line 1637, in wm_iconbitmap
    return self.tk.call('wm', 'iconbitmap', self._w, bitmap)
_tkinter.TclError: bitmap "favicon.ico" not defined

What I already did:

  • I checked the path - everything is 100% correct
  • I tried other file formats like .png or .bmp - none worked
  • I looked this problem up on many websites

And for the third point, effbot.org, my favorite site about Tkinter, told me that Windows ignores the iconbitmap function. But this doesn't explain why it throws an error!

There are some "hackish" ways to avoid that issue, but none of them are Written for Python 3.x.

So my final question is: Is there a way to get a custom icon using Python 3.x and Tkinter?

Also, don't tell me I should use another GUI Library. I want my program to work on every platform. I also want a coded version, not a py2exe or sth solution.

martineau
  • 119,623
  • 25
  • 170
  • 301
CrushedPixel
  • 1,152
  • 2
  • 13
  • 26
  • Is `favicon.ico` in the folder where you are running the script? Other wise you have to provide the full path. Also, when other thing you can do is change the format to a `.gif`, I think thats the only format tkinter accepts. –  Aug 30 '13 at 17:07
  • 4
    @enginefree - No. Tkinter accepts `.ico` as well. –  Aug 30 '13 at 17:30

14 Answers14

63

You need to have favicon.ico in the same folder or dictionary as your script because python only searches in the current dictionary or you could put in the full pathname. For example, this works:

from tkinter import *
root = Tk()

root.iconbitmap(r'c:\Python32\DLLs\py.ico')
root.mainloop()

But this blows up with your same error:

from tkinter import *
root = Tk()

root.iconbitmap('py.ico')
root.mainloop()
Jimmy Lin
  • 163
  • 1
  • 1
  • 10
  • 3
    Dude, you are great (or I am just a bit stupid). There is only one question left? is there an easy possibility of dynamically loading the path instead of having a fixed one? because this would give me more freedom at some point :) – CrushedPixel Aug 30 '13 at 17:36
  • @CrushedPixel - What you did wasn't stupid. In fact, it should have worked if `favicon.ico` was on the path. Anyways, I suppose you _could_ build something dynamic using the `os` module to walk certain directories looking for `.ico` files. However, this might cause you to load the wrong image, which would be embarrassing. My advice would be to pick the icon you want and then keep it with the script. –  Aug 30 '13 at 17:54
  • there is just one thing left that I need to know - which path does Python think is meant when I don't specify a path? Like where on my Computer did Python search for 'favicon.ico' before I told it where to search? – CrushedPixel Aug 30 '13 at 18:44
  • @CrushedPixel - I believe it only checks the directory that the script is in. If it can't find it, it blows up. –  Aug 30 '13 at 19:01
  • Note that if you want to be sure, you can get the directory of your script by doing os.path.dirname(os.path.abspath(__file__)) (thats underscore underscore file underscore underscore) – Foon Oct 11 '15 at 20:51
  • 7
    I've used `os.path` and functions contained therein to get the full path to the .ico icon file (which definitely exists), but it *still* gives me that traceback for an error: _tkinter.TclError: bitmap "/usr/local/src/py/project/media/Question-Shield.ico" not defined – Agi Hammerthief Jan 29 '16 at 20:26
  • Depending on who or what is calling or launching your script, you might need to use sys.path[0] instead of os.path to make it "portable". This works for me, when another tool (Scribus) is calling my scripts. – Martin Zaske Oct 18 '17 at 15:12
  • Ok dudes, here is the thing: My icon is right next to the script and I'm also running the script in the same folder. The icon file is readable by the user and I'm using python3. Still the same error. Using the full path dosen't work either. – Phillip May 11 '18 at 19:56
  • 2
    The dynamic path option works for me. I'm using Python 3.4.3. I wonder if you could bypass that bug by importing the OS module and using "root.iconbitmap(os.path.abspath('py.ico'))"? – SignatureSmileyfaceProductions Aug 10 '18 at 04:16
23

No way what is suggested here works - the error "bitmap xxx not defined" is ever present. And yes, I set the correct path to it.

What it did work is this:

imgicon = PhotoImage(file=os.path.join(sp,'myicon.gif'))
root.tk.call('wm', 'iconphoto', root._w, imgicon)  

where sp is the script path, and root the Tk root window.

It's hard to understand how it does work (I shamelessly copied it from fedoraforums) but it works

alessandro
  • 3,838
  • 8
  • 40
  • 59
  • This works on FreeBSD. From that I would guess that it works on all Xorg/X11 based systems. It does not set the icon on Native Tk under OS X. I have not tested it on Windows. – cshilton Jan 20 '18 at 17:59
  • What is your variable `sp`? – Artemis May 22 '18 at 14:30
  • sorry, a quick cut&paste of code... sp is simply my script path, where the icon lives – alessandro May 25 '18 at 06:26
  • @alessandro this worked for me! did you ever figure out how it works? – leonardo Jan 09 '20 at 11:33
  • @leonardo no, I didnt investigate it further. Looking back to it, I didnt notice that the original question mentioned python3: at the time of my answer I still used python2.7. But I transitioned to python3 now, and it still works – alessandro Jan 14 '20 at 14:55
  • @alessandro yes it's working on python3. This is what I've been using. I don't know the exact details either, but it's doing what's intended. – leonardo Jan 18 '20 at 10:21
  • Works for me on python 3 on Ubuntu – Self Dot Jan 09 '23 at 22:33
10

This works for me with Python3 on Linux:

import tkinter as tk

# Create Tk window
root = tk.Tk()

# Add icon from GIF file where my GIF is called 'icon.gif' and
# is in the same directory as this .py file
root.tk.call('wm', 'iconphoto', root._w, tk.PhotoImage(file='icon.gif'))
Steve Daulton
  • 176
  • 1
  • 4
2

Got stuck on that too...

Finally managed to set the icon i wanted using the following code:

from tkinter import *
root.tk.call('wm', 'iconphoto', root._w, PhotoImage(file='resources/icon.png'))
afterm3
  • 69
  • 1
  • 5
1
#!/usr/bin/env python
import tkinter as tk

class AppName(tk.Frame):
    def __init__(self, master=None):
        tk.Frame.__init__(self, master)
        self.grid()
        self.createWidgets()

    def createWidgets(self):
        self.quitButton = tk.Button(self, text='Quit', command=self.quit)
        self.quitButton.grid()

app = AppName()
app.master.title('Title here ...!')
app.master.iconbitmap('icon.ico')
app.mainloop()

it should work like this !

Malek B.
  • 1,104
  • 1
  • 12
  • 14
1

Make sure the .ico file isn't corrupted as well. I got the same error which went away when I tried a different .ico file.

Daniel
  • 3,344
  • 5
  • 27
  • 35
1

Both codes are working fine with me on python 3.7..... hope will work for u as well

import tkinter as tk
m=tk.Tk()
m.iconbitmap("myfavicon.ico")
m.title("SALAH Tutorials")
m.mainloop()

and do not forget to keep "myfavicon.ico" in the same folder where your project script file is present

Another method

from tkinter import *
m=Tk()
m.iconbitmap("myfavicon.ico")
m.title("SALAH Tutorials")
m.mainloop()

[*NOTE:- python version-3 works with tkinter and below version-3 i.e version-2 works with Tkinter]

Er M S Dandyan
  • 364
  • 3
  • 3
1

I had the same problem too, but I found a solution.

root.mainloop()

from tkinter import *
    
# must add
root = Tk()
root.title("Calculator")
root.iconbitmap(r"image/icon.ico")
    
root.mainloop()

In the example, what python needed is an icon file, so when you dowload an icon as .png it won't work cause it needs an .ico file. So you need to find converters to convert your icon from png to ico.

Community
  • 1
  • 1
chan hoyin
  • 41
  • 3
1

Try this:

from tkinter import *
import os
import sys

root = Tk()
root.iconbitmap(os.path.join(sys.path[0], '<your-ico-file>'))

root.mainloop()

Note: replace <your-ico-file> with the name of the ico file you are using otherwise it won't work.

I have tried this in Python 3. It worked.

0

So it looks like root.iconbitmap() only supports a fixed directory.
sys.argv[0] returns the directory that the file was read from so a simple code would work to create a fixed directory.

import sys
def get_dir(src):
    dir = sys.argv[0]
    dir = dir.split('/')
    dir.pop(-1)
    dir = '/'.join(dir)
    dir = dir+'/'+src
    return dir

This is the output

>>> get_dir('test.txt')
'C:/Users/Josua/Desktop/test.txt'

EDIT:
The only issue is that this method dosn't work on linux

josua@raspberrypi:~ $ python
Python 2.7.9 (default, Sep 17 2016, 20:26:04) [GCC 4.9.2] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys.argv[0]
''
>>>
Josua Robson
  • 35
  • 1
  • 7
  • 2
    This is a really horrible and platform dependent and still slightly broken way to operate on paths instead of using the functions from `os.path`. – BlackJack Feb 15 '18 at 12:27
  • Yes, you are right. It is kind of broken, just tested it on my raspberry pi and it dosn't work. – Josua Robson Jun 07 '18 at 04:24
0
from tkinter import *
from PIL import ImageTk, Image

Tk.call('wm', 'iconphoto', Tk._w, ImageTk.PhotoImage(Image.open('./resources/favicon.ico')))

The above worked for me.

Tarun Kolla
  • 917
  • 1
  • 10
  • 30
0

I recently ran into this problem and didn't find any of the answers very relevant so I decided to make a SO account for this.

Solution 1: Convert your .ico File online there are a lot of site out there

Solution 2: Convert .ico File in photoshop

If you or your Editor just renamed your image file to *.ico then it is not going to work.
If you see the image icon from your Windows/OS folder then it is working

Tom-Oliver Heidel
  • 1,011
  • 9
  • 25
0

I'm using Visual Studio Code. To make "favicon.ico" work, you need to specify in which folder you are working.

  • You press ctrl + shift + p to open the terminal cmd+shift+p on OSX.
  • In the terminal, you type: cd + the path where you are working. For example: cd C:\User\Desktop\MyProject
snakecharmerb
  • 47,570
  • 11
  • 100
  • 153
0

CONVERT YOUR IMAGE FILE INTO A PHOTO IMAGE FIRST

img = PhotoImage(file='your-icon')

victorkolis
  • 780
  • 13
  • 13