tkface 0.0.4

A comprehensive multilingual GUI extension library for Tkinter with enhanced message boxes, and Windows-specific features

Tkface

Restore the "face" to your Tkinter!

A multilingual GUI extension library for Tkinter (tkinter) - bringing back the "face" (interface) that Tkinter left behind.

---

📖 Overview

Tkface is a Python library designed to restore and enhance the "face" (user interface) of Tkinter. While Tkinter is a powerful toolkit, its dialogs and user-facing components are minimal and lack friendly interfaces. Tkface fills this gap with multilingual dialogs, advanced message boxes, and Windows-specific features.

• Completing the Interface: Tkinter stands for "Tk interface," providing a powerful core for building GUIs. Tkface is designed to complement it by providing the user-facing components—the "face"—that are essential for a polished user experience but not built into the standard library. It extends Tkinter with ready-to-use, multilingual dialogs and widgets, letting you build sophisticated, user-friendly applications with less effort.
• Vibe Coding: Developed with a "Vibe Coding" approach-prioritizing developer joy, rapid prototyping, and a sense of fun. The codebase is hackable, readable, and easy to extend—and so is this document.

---

🔧 Requirements

• Python 3.7+
• Tkinter (included with Python)
• No additional dependencies

---

📦 Installation

Install the latest version from PyPI:

pip install tkface

Or install from the GitHub repository for the latest changes:

pip install git+https://github.com/mashu3/tkface.git

---

🚀 Usage

Message Boxes

from tkface import messagebox

# Simple information dialog
messagebox.showinfo("Success", "Operation completed successfully!")

# Multilingual support
messagebox.showerror("Error", "An error has occurred!", language="ja")

# With system sound (Windows only)
messagebox.showerror("Error", "An error has occurred!", bell=True)

# Confirmation dialog
if messagebox.askyesno("Confirm", "Do you want to save?"):
    save_file()

Screenshots

Dialog Type	Windows Environment
Warning
Error
Information
Question

Input Dialogs

from tkface import simpledialog

# String input
name = simpledialog.askstring("Name", "Enter your name:")

# Integer input with validation
age = simpledialog.askinteger("Age", "Enter your age:", minvalue=0, maxvalue=120)

# List selection dialog
color = simpledialog.askfromlistbox("Choose a color:", choices=["Red", "Green", "Blue"])

# Multiple selection dialog
colors = simpledialog.askfromlistbox("Choose colors:", choices=["Red", "Green", "Blue"], multiple=True)

Windows-Specific Features

import tkinter as tk
import tkface

root = tk.Tk()
tkface.win.dpi()         # Enable DPI awareness (Windows only)
tkface.win.unround(root) # Disable corner rounding (Windows 11 only)
tkface.win.bell("error") # Play Windows system sound (Windows only)

# Windows-specific flat button styling
button = tkface.Button(root, text="Flat Button", command=callback)  # No shadow on Windows
root.mainloop()

Note: All Windows-specific features gracefully degrade on non-Windows platforms.

Language Management

from tkface import lang
import tkinter as tk

root = tk.Tk()
lang.set("ja", root)  # Set language manually
lang.set("auto", root)  # Auto-detect system language

# Register custom translations
custom_translations = {
    "ja": {
        "Custom Message": "カスタムメッセージ",
        "Custom Button": "カスタムボタン"
    }
}
from tkface import simpledialog
simpledialog.askfromlistbox(
    "Choose an option:",
    choices=["Option 1", "Option 2", "Option 3"],
    custom_translations=custom_translations,
    language="ja"
)

---

🧩 Features

• Multilingual Support: Automatic language detection, English/Japanese built-in, custom dictionaries
• Enhanced Message Boxes: All standard and advanced dialogs, custom positioning, keyboard shortcuts, tab navigation
• Enhanced Input Dialogs: String/integer/float input, validation, password input, list selection, custom positioning
• Windows Features: DPI awareness, Windows 11 corner rounding control, Windows system sounds, flat button styling (gracefully degrade on other OS)

---

📁 Examples

See the examples/ directory for complete working examples:

• demo_messagebox.py - Message box demonstrations
• demo_simpledialog.py - Input dialog demonstrations

Note: Test files are not included in the public release. For testing, see the development repository.

---

🌐 Supported Languages

• English (en): Default, comprehensive translations
• Japanese (ja): Complete Japanese translations

You can add support for any language by providing translation dictionaries:

custom_translations = {
    "fr": {
        "ok": "OK",
        "cancel": "Annuler",
        "yes": "Oui",
        "no": "Non",
        "Error": "Erreur",
        "Warning": "Avertissement"
    }
}

---

📝 License

This project is licensed under the MIT License. See the LICENSE file for details.

---

👨‍💻 Author

mashu3