Skip to main content

Generates folder preview thumb

Project description

FOLDERPREVIEW

Generates folder thumbs using child files thumbs

demo

Installation

aur: folderpreview

pip:

systems requirements:

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

Usage

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)

Debugging:

$ journalctl -f -p debug -t folderpreview

Configuration

XDG_CONFIG_HOME/folderpreview/config.yaml:

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

Customization

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.

Links

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.2.tar.gz (132.6 kB view hashes)

Uploaded Source

Built Distribution

folderpreview-0.4.2-py3-none-any.whl (16.3 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