Elegoo Neptune Thumbnails Plugin For Cura
Sponsored by \
Support This Project
If you like this plugin, consider supporting me :)
General Info
You are a printer manufacturer and want your printer to be supported?\ Feel free to contact me via email:
realmolodos@gmail.com(Manufacturers only - else open an issue here on GitHub)
Cura 5.X (Cura 4.X is not supported) plugin for adding gcode thumbnail images for Elegoo Neptune printers. The following models are supported (for other models, see FAQ):
- Elegoo Neptune 4
- Elegoo Neptune 4 Pro
- Elegoo Neptune 4 Plus
- Elegoo Neptune 4 Max
- Elegoo Neptune 3 Pro
- Elegoo Neptune 3 Plus
- Elegoo Neptune 3 Max
- Elegoo Neptune 2
- Elegoo Neptune 2S
- Elegoo Neptune 2D
- Elegoo Neptune X
- Artillery Sidewinder X3 Pro (beta)
- Elegoo OrangeStorm Giga (beta)
Additional features:
- Display more information about the sliced model on the thumbnail
- Use a graphical user interface for thumbnail configuration
- Thumbnail preview in graphical user interface
- Add thumbnails for Klipper (to display in the Neptune 4 (Pro) web interface)
Note: If you have some idea on how to improve the plugin or found a bug, feel free to create a GitHub issue for that
Installation
From GitHub (better option)
Note: You need to use the
ElegooNeptuneThumbnails.curapackagefrom the latest release, that is linked below. Not thebase.curapackage(that one is just for development and build purposes)
1) Download the
plugin here
and drag the .curapackage file into the Cura window (like onto the build
plate) 
2) Restart Cura
3) Configure the plugin as shown in Usage
4) If it isn't working, check the FAQ
From Cura Marketplace (not always the latest version)
Note: As review by Ultimaker takes pretty long (almost a whole month), the plugin could be outdated when installing it that way. For latest releases, checkout the installation from GitHub above
1) Install the plugin from Cura marketplace 2) Restart Cura 3) Configure the plugin as shown in Usage 4) If it isn't working, check the FAQ
Usage
Note: Settings are per printer, so if you switch the printer, you have to reconfigure the settings
1) Open the thumbnail settings menu \
2) Configure thumbnail settings as you wish \
Thumbnail Settings Overview
| Setting | Description |
|---|---|
Enable thumbnails |
Includes a thumbnail of the object to the gcode |
Printer model |
The printer model to generate thumbnails for (different models user different algorithms for generation) |
Top left corner |
Information display option (see below) for the top left corner |
Top right corner |
Information display option (see below) for the top right corner |
Bottom left corner |
Information display option (see below) for the bottom left corner |
Bottom right corner |
Information display option (see below) for the bottom right corner |
Send anonymous usage statistics |
Enables the collection of anonymous usage statistics |
Use current model(s) |
Use the current model(s) in the preview thumbnail |
Information Display Options
| Setting | Description |
|---|---|
Time Estimate |
Includes the estimated print time in the thumbnail |
Filament Grams Estimate |
Includes the estimated filament usage in grams in the thumbnail |
Layer Height |
Includes the layer height in the thumbnail |
Model Height |
Includes the model height in the thumbnail |
Filament Cost Estimate |
Includes the estimated filament cost (based on cost in filaments settings) in the thumbnail |
Filament Meters Estimate |
Includes the estimated filament usage in meters in the thumbnail |
Line Width |
Includes the line width (of the firs extruder) in the thumbnail |
FAQ
Does my printer support this plugin?
If your printer is in the settings dropdown, it should be supported. If your printer does support thumbnails, but it is not available in the dropdown, don't hesitate to open a GitHub issue and I will see what I can do.
Note: The "normal" Neptune 3 doesn't support displaying thumbnails, I have talked with Elegoo as there were many people asking for it.
Thumbnails are not generated. What to do?
1) Make sure, that the plugin is installed correctly. Click "Marketplace" on the top right and then the settings gear on the top right. The plugin should be displayed under "Installed Plugins" 2) Make sure, that thumbnails are enabled in the settings and the correct printer is selected
Why do thumbnails not change when printing another gcode file?
There seems to be a bug in older printer firmware versions which causes the thumbnail to not update if you start a print right after the last one ended. Restarting the printer in between prints seems to fix that. If this is the case for you, check your printer for firmware updates, which might fix the bug.
Is there PrusaSlicer support?
Yes, but only as a lite version because PrusaSlicer does not have enough possibilities for complex plugins. Check it out here
Development Guide
1) Install requirements pip install -r requirements.txt
2) Add cura folder from https://github.com/Ultimaker/Cura to base directory (needed as lib)
3) Add UM folder from https://github.com/Ultimaker/Uranium to base directory (needed as lib)
4) Develop
5) Create package python -m package_plugin (package will be
under package_plugin/ElegooNeptuneThumbnails.curapackage)
Note: For some reason, QPainter will not accept all pngs. Usually, re-saving pngs with paint will fix problems (at least for non-transparent images)
Usage Statistics
The plugin will collect some anonymous usage statistics in order to make improvements easier. You can opt out of usage statistics by removing the checkbox in the thumbnail settings at any time.
Usage statistics are only related to an anonymous statistics id that is generated randomly when you install the plugin. No personal data is being collected. The statistics data, that is collected, is limited to the following:
- Name of this plugin
- Version of this plugin
- The anonymous statistics id
- The printer model from profile (e.g. "Elegoo Neptune 3 Pro")
- The printer model selected (e.g. "Elegoo Neptune 3 Pro")
- The information display options you are using (e.g.
Layer Height) - Version of Cura
- Operating system (e.g.
Windows 10.0.22621) - Enabled state of thumbnails
- Enabled state of Klipper thumbnails
Note: This list might change at some time, so keep an eye on it if you update the plugin. Be aware, that personal data will never be added to this list.
License
This repository uses code snippets from the Artillery Cura MKSWiFiPlugin and is therefore released under the AGPL v3 license.