Skip to content
Create a gist now

Instantly share code, notes, and snippets.

@zed / secret

Embed URL


Subversion checkout URL

You can clone with
Download ZIP
Tkinter: Show slideshow for images in a given directory (recursively) in cycle
#!/usr/bin/env python
"""Show slideshow for images in a given directory (recursively) in cycle.
If no directory is specified, it uses the current directory.
import logging
import os
import platform
import sys
from collections import deque
from itertools import cycle
import Tkinter as tk
import Image
import ImageTk
psutil = None # avoid "redefinition of unused 'psutil'" warning
import psutil
except ImportError:
debug = logging.debug
class Slideshow(object):
def __init__(self, parent, filenames, slideshow_delay=2, history_size=100): = parent.winfo_toplevel()
self.filenames = cycle(filenames) # loop forever
self._files = deque(maxlen=history_size) # for prev/next files
self._photo_image = None # must hold reference to PhotoImage
self._id = None # used to cancel pending show_image() callbacks
self.imglbl = tk.Label(parent) # it contains current image
# label occupies all available space
self.imglbl.pack(fill=tk.BOTH, expand=True)
# start slideshow on the next tick
self.imglbl.after(1, self._slideshow, slideshow_delay * 1000)
def _slideshow(self, delay_milliseconds):
self._slideshow, delay_milliseconds)
def show_image(self):
filename = self._files[-1]
debug("load %r", filename)
image = # note: let OS manage file cache
# shrink image inplace to fit in the application window
w, h =,
if image.size[0] > w or image.size[1] > h:
# note: copies image
# preserve aspect ratio
image.thumbnail((w - 2, h - 2), Image.ANTIALIAS)
debug("resized: win %s >= img %s", (w, h), image.size)
# note: pasting into an RGBA image that is displayed might be slow
# create new image instead
self._photo_image = ImageTk.PhotoImage(image)
# set application window title
def _show_image_on_next_tick(self):
# cancel previous callback schedule a new one
if self._id is not None:
self._id = self.imglbl.after(1, self.show_image)
def next_image(self, event_unused=None):
def prev_image(self, event_unused=None):
def fit_image(self, event=None, _last=[None] * 2):
"""Fit image inside application window on resize."""
if event is not None and event.widget is and (
_last[0] != event.width or _last[1] != event.height):
# size changed; update image
_last[:] = event.width, event.height
def get_image_files(rootdir):
for path, dirs, files in os.walk(rootdir):
dirs.sort() # traverse directory in sorted order (by name)
files.sort() # show images in sorted order
for filename in files:
if filename.lower().endswith('.jpg'):
yield os.path.join(path, filename)
def main():
logging.basicConfig(format="%(asctime)-15s %(message)s", datefmt="%F %T",
root = tk.Tk()
if logging.getLogger().isEnabledFor(logging.DEBUG) and psutil is not None:
def report_usage(prev_meminfo=None, p=psutil.Process(os.getpid())):
# find max memory
if p.is_running():
meminfo = p.get_memory_info()
if meminfo != prev_meminfo and (
prev_meminfo is None or meminfo.rss > prev_meminfo.rss):
prev_meminfo = meminfo
root.after(500, report_usage, prev_meminfo) # report in 0.5s
# get image filenames
imagedir = sys.argv[1] if len(sys.argv) > 1 else '.'
image_filenames = get_image_files(imagedir)
# configure initial size
if platform.system() == "Windows":
root.wm_state('zoomed') # start maximized
width, height, xoffset, yoffset = 400, 300, 0, 0
# double-click the title bar to maximize the app
# or uncomment:
# # remove title bar
# root.overrideredirect(True) # <- this makes it hard to kill
# width, height = root.winfo_screenwidth(), root.winfo_screenheight()
root.geometry("%dx%d%+d%+d" % (width, height, xoffset, yoffset))
try: # start slideshow
app = Slideshow(root, image_filenames, slideshow_delay=2)
except StopIteration:
sys.exit("no image files found in %r" % (imagedir,))
# configure keybindings
root.bind("<Escape>", lambda _: root.destroy()) # exit on Esc
root.bind('<Prior>', app.prev_image)
root.bind('<Up>', app.prev_image)
root.bind('<Left>', app.prev_image)
root.bind('<Next>', app.next_image)
root.bind('<Down>', app.next_image)
root.bind('<Right>', app.next_image)
root.bind("<Configure>", app.fit_image) # fit image on resize
if __name__ == '__main__':
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Something went wrong with that request. Please try again.