TkinterEP
diff --git a/‎README.md
Lines changed: 91 additions & 2 deletions b/‎README.md
Lines changed: 91 additions & 2 deletions
diff --git a/‎example.py
Lines changed: 23 additions & 1 deletion b/‎example.py
Lines changed: 23 additions & 1 deletion
diff --git a/‎screenshots/adwaita.png
10.3 KB b/‎screenshots/adwaita.png
10.3 KB
diff --git a/‎screenshots/yaru.png
9.81 KB b/‎screenshots/yaru.png
9.81 KB
@@ -1,2 +1,91 @@
-# python-gttk: Gtk Themeing for Tkinter/ttk
-![](https://api.travis-ci.com/RedFantom/python-gttk.svg?branch=master)
+# GTK Theme for Python's tkinter/ttk
+![Build Status](https://api.travis-ci.com/RedFantom/python-gttk.svg?branch=master)
+
+Would you like to have a more native look for your Tkinter application?
+Are the themes provided in [ttkthemes](https://github.com/TkinterEP/ttkthemes)
+not to your liking?
+
+This package provides a version of [`gtkTtk`](https://github.com/Geballin/gtkTtk),
+formerly [`tilegtk`](https://github.com/xiaq/tile-gtk) packaged for
+usage with Python. Simply follow the installation instructions and all
+required files are installed to the site package directory.
+
+## Installation
+These instructions are for Ubuntu, Python 3.5 or higher. Any lower 
+version may work, but is not supported. On other distributions, package 
+names may be different.
+```bash
+# Build Tools
+sudo apt install build-essential cmake
+# Required Libraries
+sudo apt install libgtk2.0-dev libglib2.0-dev tcl-dev tk-dev
+# Required Python packages
+python -m pip install scikit-build
+
+python setup.py install 
+``` 
+
+## Usage
+Simply import the package, and the theme is loaded automatically.
+```python
+import tkinter as tk
+from tkinter import ttk
+import gttk
+
+window = tk.Tk()
+style = ttk.Style()
+style.theme_use("gttk")
+ttk.Button(window, text="Destroy", command=window.destroy).pack()
+
+window.mainloop()
+```
+
+If you encounter an error because you are running in the repository, 
+directory, make sure to disallow imports from the working directory
+before importing `gttk`:
+```python
+import sys
+sys.path = sys.path[2:]
+import gttk
+```
+
+## Screenshots
+`gttk` should work with any GTK theme you can throw at it, but below
+are the themes Yaru and Adwaita as examples.
+
+![Yaru Example](https://raw.githubusercontent.com/RedFantom/python-gttk/master/screenshots/yaru.png)
+![Adapta Example](https://raw.githubusercontent.com/RedFantom/python-gttk/master/screenshots/adwaita.png)
+
+## License and Copyright
+This repository provides a wrapper around `gttk`, which is a renamed 
+version of `gtkTtk`, which in turn is a renamed version of `tile-gtk`.
+The original `tile-gtk` is available under hte MIT License. This version
+is available only under GNU GPLv3.
+
+```
+    python-gttk 
+    Copyright (c) 2008-2012 Georgios Petasis
+    Copyright (c) 2012 Cheer Xiao
+    Copyright (c) 2019-2020 Geballin
+    Copyright (c) 2020 RedFantom
+    
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+    
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+    
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
+```
+
+## Project State
+`tile-gtk`, `gtkTtk` and hence also `gttk` are far from perfect. You may
+encounter various graphical artifacts when using particular themes,
+while others work without flaws.
+
+You are welcome to report any issues, and pull requests are even better.
@@ -1,8 +1,9 @@
 """
 Author: RedFantom
 License: GNU GPLv3
-Copyright (c) 2018 RedFantom
+Copyright (c) 2018-2020 RedFantom
 """
+import os
 import sys
 import tkinter as tk
 from tkinter import ttk
@@ -30,6 +31,7 @@ def __init__(self):
         self.tree = ttk.Treeview(self, height=4, show=("tree", "headings"))
         self.setup_tree()
         self.progress = ttk.Progressbar(self, maximum=100, value=50)
+        self.bind("<F10>", self.screenshot)
         # Grid widgets
         self.grid_widgets()
 
@@ -55,6 +57,26 @@ def grid_widgets(self):
         self.tree.grid(row=6, column=1, columnspan=2, **sticky)
         self.progress.grid(row=9, column=1, columnspan=2, padx=5, pady=5, **sticky)
 
+    def screenshot(self, *args):
+        """Take a screenshot, crop and save"""
+        try:
+            from PIL import Image
+            from mss import mss
+        except ImportError:
+            print("Taking a screenshot requires additional packages: 'pillow' and 'mss'")
+            raise
+        if not os.path.exists("screenshots"):
+            os.makedirs("screenshots")
+        box = {
+            "top": self.winfo_y(),
+            "left": self.winfo_x(),
+            "width": self.winfo_width(),
+            "height": self.winfo_height()
+        }
+        screenshot = mss().grab(box)
+        screenshot = Image.frombytes("RGB", screenshot.size, screenshot.rgb)
+        screenshot.save("screenshots/{}.png".format(ttk.Style(self).theme_use()))
+
 
 if __name__ == '__main__':
     sys.path = sys.path[2:]