Icon and Bind test on macOS/Linux

[FedericoSpada]

I've just made some major changes to core features; I need to test them on macOS and Linux.
I don't think there will be problems, since I've just used standard tkinter commands, but maybe those OS have some quirks that break the behaviors I've experimented with on Windows.
@ajkessel, can I ask for your help again?

ctk.set_appearance_mode("light")
ctk.set_default_color_theme("blue")

class Temp(ctk.CTk):
    def __init__(self) -> None:
        super().__init__()
        self.geometry("500x300+800+200")

        IMAGE_PATH = r"path_to_any_image"

        self.wm_iconphoto(False, ctk.CTkImage(light_image=IMAGE_PATH))
        toplevel = ctk.CTkToplevel()

        btn = ctk.CTkButton(self, corner_radius=30, height=100, width=100,
                            image={"light_image": IMAGE_PATH,
                                    "width": 50})
        btn.pack(pady=5, padx=5)

        self.count = 0
        def printevent(event: ctk.Event) -> None:
            self.count+=1
            print(f"{self.count} printevent", event, event.widget)

        btn.bind("<Activate>", printevent)
        btn.bind("<Button-1>", printevent)
        btn.bind("<ButtonRelease-1>", printevent)
        btn.bind("<Configure>", printevent)
        btn.bind("<Deactivate>", printevent)
        btn.bind("<Destroy>", printevent)
        btn.bind("<Enter>", printevent)
        btn.bind("<Expose>", printevent)
        btn.bind("<FocusIn>", printevent)
        btn.bind("<FocusOut>", printevent)
        btn.bind("<KeyPress>", printevent)
        btn.bind("<KeyRelease>", printevent)
        btn.bind("<Leave>", printevent)
        btn.bind("<Map>", printevent)
        # btn.bind("<Motion>", printevent)
        btn.bind("<MouseWheel>", printevent)
        btn.bind("<Unmap>", printevent)
        btn.bind("<Visibility>", printevent)

        tt = ctk.CTkToolTip(btn, text="ToolTip")
        self.after(2000, lambda: tt.destroy())

app = Temp()
app.mainloop()

This is the small "app" I've used: you just have to replace "path_to_any_image".
I expect the CTk icon to be the new image, while the CTkTopLevel one to be the CustomTkinter logo.

Interacting with the button, many events will be printed:

• The most important ones to check are Enter and Leave: they should be printed just once when entering/existing the button and not while the mouse moves inside it.
• FocusIn should be printed after clicking in any part of the button (background, label, image).
• Map and Destroy should be invoked just once and not 3 times in a row as in the previous version.

No errors should be raised after the deletion of the CTkToolTip.

Many thanks in advance!!

[mattmull42]

Hi,

First, many thanks for working on this project!
I was able to test the code (Ubuntu 26.04, Python 3.14.4). So far all the bindings seem to work (cf log.txt), and the image is displayed in the button.
Only the TopLevel seems suspicious, I don't see any image and my typechecker (ty) complains with:
Argument to bound method CTk.wm_iconphoto is incorrect: Expected tuple[CTkImage, ...], found CTkImage

Replacing ctk.CTkImage(light_image=IMAGE_PATH) with (ctk.CTkImage(light_image=IMAGE_PATH),) in line 11 to make it a tuple crashes with:
_tkinter.TclError: can't use "{<customtkinter.windows.widgets.image.ctk_image.CTkImage object at 0x7438b0ccb8c0>}" as iconphoto: not a photo image

I hope this helps!

log.txt

[FedericoSpada]

Hi, many thanks for your help!
I don't see an icon in the top left corner of CTk either. Is it something that you usually see with CustomTkinter? Maybe on Linux it is not supported at all. Is it visible in the taskbar?

Regarding the typecheck error, try replacing *images: tuple[CTkImage, ...] with *images: CTkImage in the CTk.wm_iconphoto definition. I've added "tuple" because "images" becomes a tuple, but maybe it is implicit with the use of "*". If you confirm it solves the problem, I'll include this change in my next commit.

[mattmull42]

I never saw it with CustomTkinter, and it's probably more general: the following pure Tkinter code don't show it either (top left or taskbar).
I do believe it's a Tk/Tcl + Wayland caveat, we cannot really fight against it.

Regarding the typechecking detail, using *images: CTkImage solves the problem and is the right way to me. With the unpacking * we just have to provide the type of the elements.

Don't hesitate if you need more testing of the library, or have small issues I could help with!

import tkinter as tk
from PIL import Image, ImageTk

root = tk.Tk()

ico = Image.open('image.png')
photo = ImageTk.PhotoImage(ico)
root.wm_iconphoto(False, photo)

root.mainloop()