Circular Progress

CircularProgress

Ring-shaped progress indicator with an optional centered percent readout. Custom widget — not part of CustomTkinter; exported as inlined runtime source.

Properties

Groups appear in the panel in Content → Layout → Visual order.

Group	Properties
Progress	initial_percent (0–100)
Text	show_text, text_format, text_color, font_size, font_bold
Geometry	x, y, width, height
Ring	thickness
Main Colors	fg_color (track), progress_color (fill)

The text_format string supports {percent} as a placeholder — e.g. {percent}% or Loading {percent}….

Live updates

The runtime class exposes set(percent) — call it from a handler to update the value:

self.circular_progress_1.set(75)

Square or oval

Default is square (W = H = 120). Editing W and H independently produces an oval.

Export

The exporter inlines the CircularProgress class source into the generated .py (no extra dependency). The widget participates in CTk's DPI-aware scaling, so on hi-DPI displays it renders at the same proportions as its CTk siblings.

Exact set comes from the descriptor in app/widgets/circular_progress.py.

---

See also — Widgets · CTkProgressBar · CTkSlider