Skip to content

Latest commit

 

History

History
100 lines (72 loc) · 2.61 KB

README.md

File metadata and controls

100 lines (72 loc) · 2.61 KB
Raw

Linux thumbnails generator for 3D files

Linux thumbnail generation scripts for various files when using file managers.

linux-thumbnails

Features

  • stl - render via OpenScad
  • 3mf - extract thumbnail file
  • gcode - extract thumbnail

Known limitations

  • Ubuntu 22.04 tested only

  • Works with XFCE4 Thunar and sends requests to generate thumbnails to thumbler.

  • Probably does not work over network shares (file manager restrictions)

  • Tested in user install only (I was lazy)

  • no .bgcode support yet

  • 3mf files must have Metadata/thumbnail.png inside to have a preview

  • gcode must have thumbnail embedded to be extracted (PrusaSlicer does that)

Requirements

  • git
  • imagemagick to convert images
  • make (apt install -y build-essential package)
  • openscad to convert certain files to images (apt install -y openscad)
  • python3

Installation

Install system packages, Ubuntu example:

sudo apt-get update
sudo apt get install -y build-essential openscad python3-pip git imagemagick python3-zipp

Install python packages, can be as user ( no need for sudo, but then it will be working only for given user that installed it)

pip3 install -r requirements.txt

Install thumbnail generators

mkdir ~/src
cd ~/src
git clone https://github.com/nvtkaszpir/3d-print.git
cd 3d-print/linux-thumbnails
make install

Testing if it works

thunar -q
killall tumblerd
/usr/lib/x86_64-linux-gnu/tumbler-1/tumblerd

and then open Thunar and go to directory to see if it gets thumbnails or other messages in the console:

gcode: Thumbnail saved: /tmp/tumbler-XJR2SF2.png
3mf: Processing "/home/kaszpir/.local/bin/3mf-thumbnailer.py", "/home/kaszpir/prusa/gridfinity/Gridfinity Pressure Fit Jig - Tight Tolerance.3mf", "/tmp/tumbler-XPH32F2.png"
3mf: File 'Metadata/thumbnail.png' doesn't exist inside the archive

You can also run scripts directly.

3mf-thumbnailer.py empty.3mf empty.png
3mf: Processing "/home/kaszpir/.local/bin/3mf-thumbnailer.py", "empty.3mf", "empty.png"
3mf: File extracted successfully

Todo

  • 3mf extract models and generate preview from it, PrusaSlicer can extract it but have to deal with multiple models somehow
  • bgcode
    • install bgcode binary (need co compile it, though)
    • copy .bgcode to temp dir
    • invoke bgcode file.bgcode, this will generate file.gcode
    • run thumbnail extraction on file.gcode
  • pass extracted gcode via gcode2png if thumbnail is missing