Skip to content
Thumbnail generator for STL files
Branch: master
Clone or download
Latest commit 2d77216 Mar 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.cargo Platform specific objcopy commands Feb 25, 2019
benches Implement Default for Config{} Mar 17, 2019
src Move model*view multiplication from GPU to CPU Mar 17, 2019
test_data Automatic camera positioning Apr 8, 2018
.travis.yml Disable test for other platforms Feb 25, 2019
Cargo.lock Revert "Update glium to 0.23 and use new glutin API for headless" Feb 23, 2019
Cargo.toml Bump version Mar 17, 2019
LICENSE Create LICENSE May 25, 2018 Update Mar 18, 2019
stl-thumb-mime.xml Added mime info for older Debian systems Jul 25, 2018
stl-thumb.thumbnailer Specify PNG format in thumbnailer file Jan 29, 2019


Build Status Build Status

Stl-thumb is a fast lightweight thumbnail generator for STL files. It can show previews for STL files in your file manager on Linux and Windows. It is written in Rust and uses OpenGL.




Stl-thumb requires 64 bit Windows 7 or later. Download the installer .exe for the latest release and run it.

The installer will tell the Windows shell to refresh the thumbnail cache, however this does not always seem to work. If your icons do not change then try using the Disk Cleanup utility to clear the thumbnail cache.


Make sure that your file manager is set to generate previews for files larger than 1 MB. Most file managers have this setting under the Preview tab in their Preferences.


A package is available in the AUR. Install it manually or using your favorite AUR helper.

$ yay -S stl-thumb

Debian / Ubuntu

Download the .deb package for your platform (usually amd64) and install it. Packages are also available for armhf (Raspberry Pi) and arm64 (Pinebook and other SBCs).

$ sudo dpkg -i stl-thumb_0.3.0_amd64.deb

Command Line Usage

$ stl-thumb <STL_FILE> [IMG_FILE]


Option Description
<STL_FILE> The STL file you want a picture of.
[IMG_FILE] The thumbnail image file that will be created. If this is omitted, the image data will be dumped to stdout.
-s, --size <size> Specify width of the image. It will always be a square.
-f, --format <format> The format of the image file. If not specified it will be determined from the file extension, or default to PNG if there is no extension. Supported formats: PNG, JPEG, GIF, ICO, BMP
-m, --material <ambient> <diffuse> <specular> Colors for rendering the mesh using the Phong reflection model. Requires 3 colors as rgb hex values: ambient, diffuse, and specular. Defaults to blue.
-b, --backround <color> The background color with transparency (rgba). Default is ffffff00.
-x Display the image in a window.
-h, --help Prints help information.
-V, --version Prints version information.
-v[v][v] Increase message verbosity. Levels: Errors, Warnings, Info, Debugging
You can’t perform that action at this time.