File: pymailgui-products/unzipped/docetc/ICONS/_README.txt
Icons for use in windows, desktop shortcuts, launcher, and documentation. *Do not delete this folder*: the documentation and launcher use some of its files. Icon usage hints: Windows window-border icons Windows users: copy any "mb*.ico" to the top-level "PyMailGui-PP4E" folder to use it as an alternative window-border icon. The PP4E GUI tools imported and used by PyMailGUI pick up a local-dir Windows icon automatically if present (else the GUI tools folder's blue "PY" icon from the book is used by default). PyEdit always uses its own icons located in its own folder, whether run standalone or imported for PyMailGUI popups (see PyMailGui-PP4E/PP4E/Gui/TextEditor/icons). Linux app-bar (dock) icons Linux users: you can similarly copy a GIF file to the top-level "PyMailGui-PP4E" to be used as the Linux app-bar icon (else the window tools' default "PY" is used). In Pythons using Tk 8.6+ (such as Python 3.4+ on Windows), a PNG file can serve the same role (Pythons using older Tks require a Pillow install for non-GIF images). Windows desktop shortcut icons The "mb*.ico" files, or similar creations of your own, can also be used as desktop shortcut icons on Windows (and possibly elsewhere). On Windows, drag or copy the launcher script to a desktop shortcut, and set its icon to one of the "*.ico" files here via right-click/Properties. To fetch tools for making icons from your own images, see http://learning-python.com/iconify.html. Max OS X desktop alias icons On Mac OS X, you can similarly make an alias for launchers and drag them to the desktop for quick access. Mac supports setting icons from any image file, by copy-and-paste'ing the image's content into the icon at upper left in Get Info, but this may require disabling new security guards temporarily in recent OS X versions (via 'csrutil disable' in a Cmd+R recovery mode session). Though complex, you can assign icons this way to desktop aliases, and more. Mac OS X other icons You may assign icons manually to desktop aliases and other items as descibed above, but there is no other icon support in PyMailGui or PyEdit. This seems to be at odds with source-code distributions (and may require an app package bundle), but is a TBD. Per-window icons are not a standard paradigm on Macs. Linux other icons Like the Mac, per-window icons are not a standard paradigm on Linux (they seem to be largely a Windows model). Other automatic icon contexts on Linux for Python/Tk scripts remain TBDs.