<h1 align="center">CTkMessagebox</h1>
<h3 align="center">A modern and fully customizable messagebox for CustomTkinter, A must-have extension pack!</h3>
<div align="center">
<a href="https://creativecommons.org/publicdomain/zero/1.0/"></a>
<a href="https://github.com/Akascape/CTkMessagebox/archive/refs/heads/main.zip"></a>
[](https://pypi.org/project/CTkMessagebox)
[](https://pepy.tech/project/ctkmessagebox)
</div>
<div align="center">
</div>
<br>
<h2 align="center"> Features </h2>
- Customize all elements inside the messagebox
- Add custom icons or images
- Add multiple options according to your wish
- No ugly looking header or borders
- Comes with **5 default icons**
- Spawns at center of the screen/app
- Draggable window
- Fade-in/Fade-out window effect
<br>
<h2 align="center"> Installation </h2>
<div align="center">
```
pip install CTkMessagebox
```
[<img alt="GitHub repo size" src="https://img.shields.io/github/repo-size/Akascape/CTkMessagebox?&color=green&label=Source%20Code&logo=Python&logoColor=yellow&style=for-the-badge" width="300">](https://github.com/Akascape/CTkMessagebox/archive/refs/heads/main.zip)
</div>
<br>
<h2 align="center"> How it looks? </h2>
<div align="center">
</div>
<br>
<h2 align="center"> Example </h2>
```python
from CTkMessagebox import CTkMessagebox
import customtkinter
def show_info():
# Default messagebox for showing some information
CTkMessagebox(title="Info", message="This is a CTkMessagebox!")
def show_checkmark():
# Show some positive message with the checkmark icon
CTkMessagebox(message="CTkMessagebox is successfully installed.",
icon="check", option_1="Thanks")
def show_error():
# Show some error message
CTkMessagebox(title="Error", message="Something went wrong!!!", icon="cancel")
def show_warning():
# Show some retry/cancel warnings
msg = CTkMessagebox(title="Warning Message!", message="Unable to connect!",
icon="warning", option_1="Cancel", option_2="Retry")
if msg.get()=="Retry":
show_warning()
def ask_question():
# get yes/no answers
msg = CTkMessagebox(title="Exit?", message="Do you want to close the program?",
icon="question", option_1="Cancel", option_2="No", option_3="Yes")
response = msg.get()
if response=="Yes":
app.destroy()
else:
print("Click 'Yes' to exit!")
app = customtkinter.CTk()
app.rowconfigure((0,1,2,3,4,5), weight=1)
app.columnconfigure(0, weight=1)
app.minsize(200,250)
customtkinter.CTkLabel(app, text="CTk Messagebox Examples").grid(padx=20)
customtkinter.CTkButton(app, text="Check CTkMessagebox", command=show_checkmark).grid(padx=20, pady=10, sticky="news")
customtkinter.CTkButton(app, text="Show Info", command=show_info).grid(padx=20, pady=10, sticky="news")
customtkinter.CTkButton(app, text="Show Error", command=show_error).grid(padx=20, pady=10, sticky="news")
customtkinter.CTkButton(app, text="Show Warning", command=show_warning).grid(padx=20, pady=10, sticky="news")
customtkinter.CTkButton(app, text="Ask Question", command=ask_question).grid(padx=20, pady=(10,20), sticky="news")
app.mainloop()
```
<br>
<h2 align="center"> OPTIONS </h2>
<div align="center">
| Parameters | Description |
| -------- | ----------- |
| _master_ | set parent window (optional), the box will spawn at center of the parent window |
| _width_ | width of the window in px (optional) |
| _height_ | height of the window in px (optional) |
| _fg_color_ | forground color of the messagebox [middle portion] |
| _bg_color_ | background color of the messagebox |
| **_title_** | title of the messagebox |
| **_message_** | main message of the messagebox which will be shown at the center |
| **_option_1_** | the text on the first button [Default is 'OK'] |
| **_option_2_** | the text on the second button |
| **_option_3_** | the text on the last button |
| _options_ | directly pass a list containing the options in order |
| _button_color_ | color of the buttons |
| _text_color_ | color of the message-text |
| _title_color_ | color of the title-text |
| _button_text_color_ | color of the button-text |
| _button_hover_color_ | hover color of the buttons |
| _button_width_ | width of the buttons in px |
| _button_height_ | height of the buttons in px |
| _border_width_ | width of the border around the main frame [Default is 1] |
| _border_color_ | color of the frame border |
| _cancel_button_ | define the cancel button type: **circle, cross or None** |
| _cancel_button_color_ | color of the **close** button, **set it to 'transparent' if you want to hide it** |
| **_icon_** | icon that will be shown in the messagebox [Default is the 'info' icon] |
| _icon_size_ | define the size of the icon image manually (tuple) |
| _corner_radius_ | corner roundness of the messagebox window [**not applicable in linux**] |
| _font_ | font of the messagebox text (tuple) |
| _header_ | add the original header back if you don't like **overrideredirect** (bool) |
| _topmost_ | disable the topmost window outside the app (bool) |
| _sound_ | enable the system bell sound when the window popups (bool) |
| _justify_ | position the buttons to center/right/left |
| _focus_option_ | select an option by default when `Enter` key is pressed |
| **_fade_in_duration_** | enable a fade-in and fade-out animation (int, default is 0) |
</div>
<br>
<h2 align="center"> Icons </h2>
<div align="center">
**Default icons:**
(*These icons are created using Paint.NET, free to use!*)
**For custom images, just use `icon="image_path.png"`**
## That's all, hope it will help in UI development!
</div>
Raw data
{
"_id": null,
"home_page": "https://github.com/Akascape/CTkMessagebox",
"name": "CTkMessagebox",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "customtkinter,customtkinter-dialog,customtkinter-messagebox,customtkinter-message-box,tkinter-messagebox,custom-messagebox,messagebox-widget,modern-tkinter-messagebox,ctkmessagebox,popup-window",
"author": "Akash Bora",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/36/4c/5430dac576c00f48e8ff5e8f39632783eb27678494853ecd3939c54dc097/CTkMessagebox-2.5.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">CTkMessagebox</h1>\r\n\r\n<h3 align=\"center\">A modern and fully customizable messagebox for CustomTkinter, A must-have extension pack!</h3>\r\n\r\n<div align=\"center\">\r\n \r\n <a href=\"https://creativecommons.org/publicdomain/zero/1.0/\"></a>\r\n <a href=\"https://github.com/Akascape/CTkMessagebox/archive/refs/heads/main.zip\"></a>\r\n [](https://pypi.org/project/CTkMessagebox)\r\n [](https://pepy.tech/project/ctkmessagebox)\r\n \r\n</div>\r\n\r\n\r\n<div align=\"center\">\r\n\r\n\r\n\r\n</div>\r\n\r\n<br>\r\n\r\n<h2 align=\"center\"> Features </h2>\r\n\r\n- Customize all elements inside the messagebox\r\n- Add custom icons or images\r\n- Add multiple options according to your wish\r\n- No ugly looking header or borders\r\n- Comes with **5 default icons**\r\n- Spawns at center of the screen/app\r\n- Draggable window\r\n- Fade-in/Fade-out window effect\r\n\r\n<br>\r\n\r\n<h2 align=\"center\"> Installation </h2>\r\n\r\n<div align=\"center\">\r\n\r\n```\r\npip install CTkMessagebox\r\n```\r\n\r\n[<img alt=\"GitHub repo size\" src=\"https://img.shields.io/github/repo-size/Akascape/CTkMessagebox?&color=green&label=Source%20Code&logo=Python&logoColor=yellow&style=for-the-badge\" width=\"300\">](https://github.com/Akascape/CTkMessagebox/archive/refs/heads/main.zip)\r\n\r\n\r\n</div>\r\n\r\n<br>\r\n\r\n<h2 align=\"center\"> How it looks? </h2>\r\n\r\n<div align=\"center\">\r\n\r\n\r\n\r\n</div>\r\n\r\n<br>\r\n\r\n<h2 align=\"center\"> Example </h2>\r\n\r\n```python\r\nfrom CTkMessagebox import CTkMessagebox\r\nimport customtkinter\r\n\r\ndef show_info():\r\n # Default messagebox for showing some information\r\n CTkMessagebox(title=\"Info\", message=\"This is a CTkMessagebox!\")\r\n\r\ndef show_checkmark():\r\n # Show some positive message with the checkmark icon\r\n CTkMessagebox(message=\"CTkMessagebox is successfully installed.\",\r\n icon=\"check\", option_1=\"Thanks\")\r\n \r\ndef show_error():\r\n # Show some error message\r\n CTkMessagebox(title=\"Error\", message=\"Something went wrong!!!\", icon=\"cancel\")\r\n \r\ndef show_warning():\r\n # Show some retry/cancel warnings\r\n msg = CTkMessagebox(title=\"Warning Message!\", message=\"Unable to connect!\",\r\n icon=\"warning\", option_1=\"Cancel\", option_2=\"Retry\")\r\n \r\n if msg.get()==\"Retry\":\r\n show_warning()\r\n \r\ndef ask_question():\r\n # get yes/no answers\r\n msg = CTkMessagebox(title=\"Exit?\", message=\"Do you want to close the program?\",\r\n icon=\"question\", option_1=\"Cancel\", option_2=\"No\", option_3=\"Yes\")\r\n response = msg.get()\r\n \r\n if response==\"Yes\":\r\n app.destroy() \r\n else:\r\n print(\"Click 'Yes' to exit!\")\r\n \r\napp = customtkinter.CTk()\r\napp.rowconfigure((0,1,2,3,4,5), weight=1)\r\napp.columnconfigure(0, weight=1)\r\napp.minsize(200,250)\r\n\r\ncustomtkinter.CTkLabel(app, text=\"CTk Messagebox Examples\").grid(padx=20)\r\ncustomtkinter.CTkButton(app, text=\"Check CTkMessagebox\", command=show_checkmark).grid(padx=20, pady=10, sticky=\"news\")\r\ncustomtkinter.CTkButton(app, text=\"Show Info\", command=show_info).grid(padx=20, pady=10, sticky=\"news\")\r\ncustomtkinter.CTkButton(app, text=\"Show Error\", command=show_error).grid(padx=20, pady=10, sticky=\"news\")\r\ncustomtkinter.CTkButton(app, text=\"Show Warning\", command=show_warning).grid(padx=20, pady=10, sticky=\"news\")\r\ncustomtkinter.CTkButton(app, text=\"Ask Question\", command=ask_question).grid(padx=20, pady=(10,20), sticky=\"news\")\r\n\r\napp.mainloop()\r\n\r\n```\r\n\r\n<br>\r\n\r\n<h2 align=\"center\"> OPTIONS </h2>\r\n\r\n<div align=\"center\">\r\n\r\n | Parameters | Description |\r\n | -------- | ----------- |\r\n | _master_ | set parent window (optional), the box will spawn at center of the parent window |\r\n | _width_ | width of the window in px (optional) |\r\n | _height_ | height of the window in px (optional) |\r\n | _fg_color_ | forground color of the messagebox [middle portion] |\r\n | _bg_color_ | background color of the messagebox |\r\n | **_title_** | title of the messagebox |\r\n | **_message_** | main message of the messagebox which will be shown at the center |\r\n | **_option_1_** | the text on the first button [Default is 'OK'] |\r\n | **_option_2_** | the text on the second button |\r\n | **_option_3_** | the text on the last button |\r\n | _options_ | directly pass a list containing the options in order |\r\n | _button_color_ | color of the buttons |\r\n | _text_color_ | color of the message-text |\r\n | _title_color_ | color of the title-text |\r\n | _button_text_color_ | color of the button-text |\r\n | _button_hover_color_ | hover color of the buttons |\r\n | _button_width_ | width of the buttons in px |\r\n | _button_height_ | height of the buttons in px |\r\n | _border_width_ | width of the border around the main frame [Default is 1] |\r\n | _border_color_ | color of the frame border |\r\n | _cancel_button_ | define the cancel button type: **circle, cross or None** |\r\n | _cancel_button_color_ | color of the **close** button, **set it to 'transparent' if you want to hide it** |\r\n | **_icon_** | icon that will be shown in the messagebox [Default is the 'info' icon] |\r\n | _icon_size_ | define the size of the icon image manually (tuple) |\r\n | _corner_radius_ | corner roundness of the messagebox window [**not applicable in linux**] |\r\n | _font_ | font of the messagebox text (tuple) |\r\n | _header_ | add the original header back if you don't like **overrideredirect** (bool) |\r\n | _topmost_ | disable the topmost window outside the app (bool) |\r\n | _sound_ | enable the system bell sound when the window popups (bool) |\r\n | _justify_ | position the buttons to center/right/left |\r\n | _focus_option_ | select an option by default when `Enter` key is pressed |\r\n | **_fade_in_duration_** | enable a fade-in and fade-out animation (int, default is 0) |\r\n \r\n\r\n</div>\r\n\r\n<br>\r\n\r\n<h2 align=\"center\"> Icons </h2>\r\n\r\n<div align=\"center\">\r\n\r\n**Default icons:**\r\n\r\n\r\n\r\n(*These icons are created using Paint.NET, free to use!*)\r\n\r\n**For custom images, just use `icon=\"image_path.png\"`**\r\n\r\n## That's all, hope it will help in UI development!\r\n\r\n</div>\r\n",
"bugtrack_url": null,
"license": "Creative Commons Zero v1.0 Universal",
"summary": "A modern messagebox for customtkinter",
"version": "2.5",
"project_urls": {
"Homepage": "https://github.com/Akascape/CTkMessagebox"
},
"split_keywords": [
"customtkinter",
"customtkinter-dialog",
"customtkinter-messagebox",
"customtkinter-message-box",
"tkinter-messagebox",
"custom-messagebox",
"messagebox-widget",
"modern-tkinter-messagebox",
"ctkmessagebox",
"popup-window"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3ca65398926f4db33ec8020f8ff5608ca61ced93493cff011d739d0d5826f292",
"md5": "0df3ed34bff37cba8f059b369cbf0ad3",
"sha256": "b3220c57bca16cec51d310e8d7cad9383dc36b30c943e5913f2e1f1644b6332e"
},
"downloads": -1,
"filename": "CTkMessagebox-2.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0df3ed34bff37cba8f059b369cbf0ad3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 125729,
"upload_time": "2023-08-22T10:31:51",
"upload_time_iso_8601": "2023-08-22T10:31:51.829754Z",
"url": "https://files.pythonhosted.org/packages/3c/a6/5398926f4db33ec8020f8ff5608ca61ced93493cff011d739d0d5826f292/CTkMessagebox-2.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "364c5430dac576c00f48e8ff5e8f39632783eb27678494853ecd3939c54dc097",
"md5": "74e8484d785651c5db485a4184a7a24f",
"sha256": "155c20e6ce0a1fd6ba43079db43e7f7bc124018f58141a15c993668aef6dae14"
},
"downloads": -1,
"filename": "CTkMessagebox-2.5.tar.gz",
"has_sig": false,
"md5_digest": "74e8484d785651c5db485a4184a7a24f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 126217,
"upload_time": "2023-08-22T10:31:53",
"upload_time_iso_8601": "2023-08-22T10:31:53.795333Z",
"url": "https://files.pythonhosted.org/packages/36/4c/5430dac576c00f48e8ff5e8f39632783eb27678494853ecd3939c54dc097/CTkMessagebox-2.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-22 10:31:53",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Akascape",
"github_project": "CTkMessagebox",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "ctkmessagebox"
}
JSON
