https://github.com/rcarmo/gnome-thumbnailers

My personal set of file thumbnailing utilities for GNOME 42+
https://github.com/rcarmo/gnome-thumbnailers

3dprinting gnome nautilus

Last synced: 3 months ago
JSON representation

My personal set of file thumbnailing utilities for GNOME 42+

• Host: GitHub
• URL: https://github.com/rcarmo/gnome-thumbnailers
• Owner: rcarmo
• License: mit
• Created: 2022-12-13T14:39:32.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2022-12-13T23:32:18.000Z (over 2 years ago)
• Last Synced: 2024-10-12T02:06:13.464Z (8 months ago)
• Topics: 3dprinting, gnome, nautilus
• Language: Python
• Homepage:
• Size: 348 KB
• Stars: 16
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# gnome-thumbnailers

This is a small set of custom thumbnailer scripts (mostly for 3D printing formats) that I crafted based on various samples floating about on the Internet, and which work in GNOME 42+.

In short, these will render pretty little file previews in your file manager (not just Nautilus, but that is what I tested with):

![](demo/demo.png)

## Supported Formats

* `.3mf` (Cura, PrusaSlicer, SuperSlicer, etc.)

* `.gcode` with embedded thumbnails

* `.scad` (OpenSCAD, will blindly render the default object)

* `.stl` (Actually uses OpenSCAD to render as well)

* `.blend` (uses the built-in `blender-thumbnailer` that comes with Blender)

## Installation

* put `.thumbnailer` files in `/usr/share/thumbnailers`

* put the other files in `/usr/local/bin`, marked as executable

* remove all the cached thumbnails in `~/.cache/thumbnails`

* restart Nautilus with `nautilus -q`

The `Makefile` does that for you.

## Dependencies

* `3mf.thumbnailer` and `gcode.thumbnailer` require nothing but Python 3 installed, because they cheat and use the thumbnail the slicer inserts into the file.

* `stlscad.thumbnailer` requires `Xvfb`, `openscad` and `ImageMagick` installed to render and convert files.

* `blender.thumbnailer` requires Blender to be installed.

## FAQ

> But isn't `openscad` prevented from accessing X because of `bwrap` thumbnail generation sandboxing in modern GNOME?

Yes. But it works _perfectly_ with `xvfb-run` and software rendering, so I'd rather take the performance hit rather than spend hours trying to persuade `bwrap` to do weird stuff like `--bind /tmp/.X11-unix/X0 /tmp/.X11-unix/X0 --setenv DISPLAY :0`. 

Sometimes brute force is the simplest, more maintainable (and more secure) approach.

> I have a `.3mf` or `.gcode` file without thumbnail, is the thumbnailer broken?

No. It's quite likely that the slicer you used to create it did not include a thumbnail, or that it is in a weird format. There are limits to these things.

> My OpenSCAD thumbnails are blank!

This usually happens when it's either a library file (that would render nothing on its own) or a customizer file that is missing some default (and hence renders nothing as well).

> My Blender thumbnails are blank!

That usually happens when you either don't have a camera defined or it's pointing towards literally nothing.