Skip to main content

Generates folder preview thumb

Project description


Generates folder thumbs using child files thumbs



aur: folderpreview


systems requirements:

$ pip install folderpreview
$ sudo -E folderpreview --install-thumbnailer


The thumbnailer will be automatically calling by thumnail service when file manager asks for folder thumbnail. For general usage all you need is installed thumnail service.

folderpreview --help for manual usage.

Tested with:

  • tumbler
  • thunar
  • nemo
  • pcmanfm (libfm-directory_thumbnails required)


$ journalctl -f -p debug -t folderpreview



size: 256                  # default thumb size, px
use_hidden: false          # generate thumbs for and use hidden files in preview
request_child_thumbs: true # request thumbs of supported child files
                           # in background scheduler and wait for their readiness
request_timeout: 5         # request timeout, s
priority:                  # priority of child's files for using on preview
- media                    # video/image files with thumbs/thumbnailer
- thumbs                   # other files with thumbs/thumbnailer
- icons                    # files without thumbs/thumbnailer
- subdirs                  # recursion in subdirs with the order
- files                    # all child files
locations:                 # enabled folders locations(including subdirs)
- /
- $HOME/videos
renderer: custom_renderer.CustomRenderer # renderer class name


For better integration with icon theme renderer can be customized using config.renderer option. It should be instance of folderpreview.renderer.ThumbRenderer class. Custom renderer can be stored in config folder.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

folderpreview-0.4.3.tar.gz (132.6 kB view hashes)

Uploaded Source

Built Distribution

folderpreview-0.4.3-py3-none-any.whl (16.2 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page