UVtools.Core 4.3.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package UVtools.Core --version 4.3.0
NuGet\Install-Package UVtools.Core -Version 4.3.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="UVtools.Core" Version="4.3.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add UVtools.Core --version 4.3.0
#r "nuget: UVtools.Core, 4.3.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install UVtools.Core as a Cake Addin
#addin nuget:?package=UVtools.Core&version=4.3.0

// Install UVtools.Core as a Cake Tool
#tool nuget:?package=UVtools.Core&version=4.3.0

UVtools

License GitHub repo size Code size Total code Nuget GitHub release (latest by date including pre-releases) Downloads Chocolatey GitHub Sponsors

Download the latest version at:

https://github.com/sn4k3/UVtools/releases/latest

To auto install on Windows (package manager):

  • Winget: winget install -e --id PTRTECH.UVtools
  • Chocolatey: choco install -y uvtools

Note: Winget is included on Windows 10 with recent updates and Windows 11 by default.

To auto install on Linux:

[ "$(command -v apt)" -a -z "$(command -v curl)" ] && sudo apt-get install -y curl 
[ "$(command -v dnf)" -a -z "$(command -v curl)" ] && sudo dnf install -y curl
[ "$(command -v pacman)" -a -z "$(command -v curl)" ] && sudo pacman -S curl
[ "$(command -v zypper)" -a -z "$(command -v curl)" ] && sudo zypper install -y curl
bash -c "$(curl -fsSL https://raw.githubusercontent.com/sn4k3/UVtools/master/Scripts/install-uvtools.sh)"

To auto install on MacOS:

bash -c "$(curl -fsSL https://raw.githubusercontent.com/sn4k3/UVtools/master/Scripts/install-uvtools.sh)"

To downgrade to a previous version:

# Replace x.x.x by the version you want to install
bash -c "$(curl -fsSL https://raw.githubusercontent.com/sn4k3/UVtools/master/Scripts/install-uvtools.sh)" -- x.x.x

MSLA/DLP, file analysis, calibration, repair, conversion and manipulation

This simple tool can give you insight of supports and find key failures.
Did you forget what resin or other settings you used on a project? This can also save you, check every setting that were used with or simply change them!

GUI Screenshot GUI Screenshot Islands

Why this project?

I don't own a Prusa SL1 or any other resin printer, for now I’m only a FDM user with Prusa MK3 and a Ender3. PrusaSlicer is my only choose, why? Because I think it's the best and feature more, at least for me, simple but powerful.

So why this project? Well in fact I’m looking for a resin printer and i like to study and learn first before buy, get good and don't regret, and while inspecting i found that resin printers firmwares are not as universal as FDM, too many file formats and there before each printer can use their own property file, this of course limit the software selection, for example, only PrusaSlicer can slice SL1 files. So with that in mind I'm preparing when I get a resin printer in future I can use PrusaSlicer instead of others. I've explored the other slicers and again, no one give me joy, and i feel them unstable, many users slice model on PrusaSlicer just to get those supports and export STL to load in another, that means again PrusaSlicer is on the win side, the problem is they can't slice directly on PrusaSlicer, so, in the end, my project aims to do almost that, configure a printer on PrusaSlicer, eg: EPAX X1, slice, export file, convert SL1 to native printer file and print.

Please note I don't own any resin printer! All my work is virtual and calculated, so, use experimental functions with care! Once things got confirmed a list will show. But also, I need victims for test subject. Proceed at your own risk!

Features

  • View, modify and extract layer by layer
  • View, modify and extract thumbnails
  • Export file to a folder
  • View and edit all used properties/settings
  • Many tools to mutate and filter layers
  • Check for issues and repair/remove them as possible:
    • Islands
    • Overhangs
    • Resin traps
    • Suction cups
    • Touching bounds
    • Print height
    • Empty layers
  • Suggestions and auto corrections:
    • Layer height
    • Bottom layer count
    • Wait time before cure
    • Wait time after cure
    • Transition layer count
    • Model position
  • Convert format to another format
  • Calibration tests
  • Portable (No installation needed)

Known File Formats

  • SL1, SL1S (PrusaSlicer)
  • Photon, Photons, CBDDLP, CTB, PHZ, FDG, ZIP (Chitubox)
  • PWS, PW0, PWX, DLP, DL2P, PWMO, PWMA, PWMS, PWMX, PMX2, PWMB, PWSQ, PX6S, PM3, PM3N, PM3M, PM3R, PM5, PM5S, PWC (Photon Workshop)
  • JXS (GKone Slicer)
  • ZCode (UnizMaker)
  • ZCodex (Z-Suite)
  • CWS (NovaMaker), RGB.CWS (Nova Bene4 Mono / Elfin2 Mono SE)
  • XML.CWS (Wanhao Workshop)
  • MDLP (Makerbase MKS-DLP v1)
  • GR1 (GR1 Workshop)
  • CXDLP, CXDLPV4 (Creality Box)
  • GOO (Elegoo)
  • LGS (Longer Orange 10), LGS30 (Longer Orange 30), LGS120 (Longer Orange 120), LGS4K (Longer Orange 4K & mono)
  • Flashforge SVGX
  • Anet N4, Anet N7
  • QDT (Emake3D Galaxy 1)
  • OSLA (Open SLA universal binary file)
  • OSF (Vlare Open File Format)
  • NanoDLP (Zip)
  • UVJ (Vendor-neutral format for manual manipulation)
  • VDT (Voxeldance Tango), VDA.ZIP (Voxeldance Additive)
  • ZIP (Generic / Phrozen Zip)
  • Image files (png, jpg, jpeg, jp2, tif, bmp, pbm, pgm, ras, sr)

PrusaSlicer

  • Installation: https://github.com/sn4k3/UVtools/wiki/Setup-PrusaSlicer
  • Available printers: https://github.com/sn4k3/UVtools/tree/master/PrusaSlicer/printer
  • Available profiles:
    • From 0.01mm to 0.20mm
    • Light, Medium and Heavy Supports
  • Custom "Material Notes" and "Printer Notes" keywords:
    • TransitionLayerCount_xxx: Sets the number of transition layers
    • BottomLightOffDelay_xxx: Sets the bottom light off delay time in seconds
    • LightOffDelay_xxx: Sets the light off delay time in seconds
    • BottomWaitTimeBeforeCure_xxx: Sets the bottom wait time before cure in seconds
    • WaitTimeBeforeCure_xxx: Sets the wait time before cure in seconds
    • BottomWaitTimeAfterCure_xxx: Sets the bottom wait time after cure in seconds
    • WaitTimeAfterCure_xxx: Sets the wait time after cure in seconds
    • BottomLiftHeight_xxx: Sets the bottom lift height in millimeters
    • BottomLiftSpeed_xxx: Sets the bottom lift speed in millimeters/minute
    • BottomLiftHeight2_xxx: Sets the second bottom lift height in millimeters
    • BottomLiftSpeed2_xxx: Sets the second bottom lift speed in millimeters/minute
    • LiftHeight_xxx: Sets the lift height in millimeters
    • LiftSpeed_xxx: Sets the lift speed in millimeters/minute
    • LiftHeight2_xxx: Sets the second lift height in millimeters
    • LiftSpeed2_xxx: Sets the second lift speed in millimeters/minute
    • BottomWaitTimeAfterLift_xxx: Sets the bottom wait time after lift in seconds
    • WaitTimeAfterLift_xxx: Sets the wait time after lift in seconds
    • BottomRetractSpeed_xxx: Sets the bottom retract speed in millimeters/minute
    • BottomRetractHeight2_xxx: Sets the second bottom retract height in millimeters
    • BottomRetractSpeed2_xxx: Sets the second bottom retract speed in millimeters/minute
    • RetractSpeed_xxx: Sets the retract speed in millimeters/minute
    • RetractHeight2_xxx: Sets the second retract height in millimeters
    • RetractSpeed2_xxx: Sets the second retract speed in millimeters/minute
    • BottomLightPWM_xxx: Sets the bottom LED light power (0-255)
    • LightPWM_xxx: Sets the LED light power (0-255)
    • FILEVERSION_n: Sets the output file format version/revision
    • FILEFORMAT_xxx: Sets the output file format extension to be auto converted once open on UVtools
    • LAYERIMAGEFORMAT_xxx: Sets the layer image format required for the converted file if the format have multiple options (For Archives with PNG's)

Note that some variables will only work if the target format supports them, otherwise they will be ignored.
Replace the "xxx" by your desired value in the correct units

Command-line

UVtoolsCmd (Console) executable

Usage:
  UVtoolsCmd [command] [options]

Options:
  -q, --quiet     Make output silent but exceptions error will still show
  --no-progress   Show no progress
  --dummy         Do not save alterations to file
  --core-version  Show core version information
  --version       Show version information
  -?, -h, --help  Show help and usage information

Commands:
  set-properties <input-file> <property=value>                                            Set properties in a file or to it layers with new values
  run <input-file> <classes/files>                                                        Run operations, suggestions and/or scripts
  convert <input-file> <target-type/ext> <output-file>                                    Convert input file into a output file format by a known type or extension []
  extract <input-file> <output-folder>                                                    Extract file contents to a folder []
  copy-parameters <input-file> <target-files>                                             Copy print parameters from one file to another
  set-preview, set-thumbnail <input-file> <file path|layer index|:random-layer|:heatmap>  Sets and replace thumbnail(s) in the file [default: :heatmap]
  compare <input-file-a> <input-file-b>                                                   Compare two files and output the differences
  print-issues <input-file>                                                               Detect and print issues
  print-properties <input-file>                                                           Prints available properties
  print-gcode <input-file>                                                                Prints the gcode of the file if available
  print-machines                                                                          Prints machine settings
  print-formats                                                                           Prints the available formats

Note: On each command you can use -? to see specific command help and extra options

UVtools (UI) executable

  • Open file(s):
    • Syntax: UVtools <file1> [file2] [file3] ...
    • Example 1: UVtools C:\model.osla
    • Example 2: UVtools C:\model.zip D:\other_model.osla
    • Note: When a invalid file is pass, the program will open as default.
  • Redirect a command to UVtoolsCmd:
    • Syntax: UVtools --cmd <commands ...>
    • Example 1: UVtools --cmd convert C:\model.osla zip
    • Note: This can be used when UVtoolsCmd is not directly exposed, for example if you are running via a .AppImage.
      All commands will be redirected to UVtoolsCmd and the UI will not run. It still shows the terminal window.

Legacy

The following commands are the old way and commands under the UI executable, they will be removed in near future, try to not use them, please prefer UVtoolsCmd.

  • Convert a file into another type(s)
    • Syntax: UVtools -c/--convert <input_file> <output_file1_or_ext> [output_file2_or_ext] ...
    • Example 1: UVtools -c model.zip osla
    • Example 2: UVtools -c model.zip model_converted.osla
    • Example 3: UVtools --convert model.zip model_converted.osla model_converted.zcode
    • Note: Nothing happen when providing wrong files, will quit.
  • Extract a file to a folder
    • Syntax: UVtools -e/--extract <input_file> [output_folder]
    • Example 1: UVtools -e model.zip
    • Example 2: UVtools -e model.zip mymodel
    • Example 3: UVtools --extract model.zip .
    • Note: Nothing happen when providing wrong files/folder, will quit.
  • Export a file to a 3D mesh
    • Syntax: UVtools --export-mesh <input_file> [output_mesh_file]
    • Example 1: UVtools --export-mesh model.zip
    • Example 2: UVtools --export-mesh model.zip model_exported.stl
    • Note: Nothing happen when providing wrong files, will quit.
  • Run a operation and save the file
    • Syntax: UVtools --run-operation <input_file> <operation_file.uvtop>
    • Example 1: UVtools --run-operation model.zip MyMorph.uvtop
    • Note: Nothing happen when providing wrong files, will quit.
  • Run a script and save the file
    • Syntax: UVtools --run-script <input_file> <script_file.cs>
    • Example 1: UVtools --run-script model.zip myScript.cs
    • Note: Nothing happen when providing wrong files, will quit.
  • Copy print parameters from one file to another
    • Syntax: UVtools --copy-parameters <from_file> <to_file>
    • Example 1: UVtools --copy-parameters model.zip otherfile.zip
    • Note: Nothing happen when providing wrong files, will quit.

Requirements

Windows

  1. Windows 7 SP1 or greater

    1. If on Windows 10/11 N or NK:
      • Media Feature Pack must be installed
      • Press Windows + R
      • Type: appwiz.cpl (and press Enter key)
      • Click on: Turn Windows features on or off
      • Check the "Media Extensions" and click Ok
  2. 8GB RAM or higher + 512MB per CPU core

  3. 64 bit System

  4. 1920 x 1080 @ 100% scale as minimum resolution

Linux

  1. 8GB RAM or higher + 512MB per CPU core
  2. 64 bit System
  3. 1920 x 1080 @ 100% scale as minimum resolution

Installing the dependencies

Copy the following script, paste and run on a terminal:
(Required if you didn't use the auto installer or if it failed to detect and install dependencies)

[ "$(command -v apt-get)" -a -z "$(command -v curl)" ] && sudo apt-get install -y curl 
[ "$(command -v pacman)" -a -z "$(command -v curl)" ] && sudo pacman -S curl
[ "$(command -v dnf)" -a -z "$(command -v curl)" ] && sudo dnf install -y curl
[ "$(command -v zypper)" -a -z "$(command -v curl)" ] && sudo zypper install -y curl
sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/sn4k3/UVtools/master/Scripts/install-dependencies.sh)"

To run UVtools open it folder on a terminal and call one of:

  • Double-click UVtools file
  • ./UVtools
  • bash UVtools.sh
  • dotnet UVtools.dll [For universal package only, requires dotnet-runtime]
  • As a practical alternative you can create a shortcut on Desktop

If you downloaded the .AppImage package variant you must set run permissions to it before attempt to run it:
AppImage permissions

Mac

  1. macOS 10.15 Catalina or higher
  2. 8GB RAM or higher + 512MB per CPU core
  3. For Mac M1/M2 (ARM):
    1. Install via the auto installer

To run UVtools open it folder on a terminal and call one of:

  • Double-click UVtools file
  • ./UVtools.app/Contents/MacOS/UVtools
  • bash UVtools.app/Contents/MacOS/UVtools.sh
  • As a practical alternative you can create a shortcut on Desktop

How to use

There are multiple ways to open your file in UVtools:

  1. Open UVtools and load your file (CTRL + O) (File → Open)
  2. Open UVtools and drag and drop your file inside window
  3. Drag and drop file into UVtools.exe
  4. Set UVtools the default program to open your files

Library → Developers

Are you a developer? This project include a .NET 6.0 library (UVtools.Core) that can be referenced in your application to make use of my work. Easy to use calls that allow you work with the formats. For more information navigate main code to see some calls.

Nuget package: https://www.nuget.org/packages/UVtools.Core

Nuget

dotnet add package UVtools.Core

Scripting:

Develop and build from Source

Build directions
The fastest way to compile the project is by run the build/compile.bat, however if you wish to develop with visual studio follow the following steps:

  1. Install Visual Studio and include .NET development support
  2. Install the .NET 6.0 SDK if not included on previous installation
  3. Install the Avalonia for Visual Studio:
  4. Install the Wix Toolset: (Required only for MSI build, optional)
  5. Open UVtools.sln
  6. Build

TODO

  • More file formats
  • Clean up & performance (always)
  • See features request under GitHub

Support my work / Donate

All my work here is given for free (OpenSource), it took some hours to build, test and polish the program. If you're happy to contribute for a better program and for my work i will appreciate the tip.
Use one of the following methods:

GitHub Sponsors Donate PayPal

Contributors

GitHub contributors
Contributors

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
4.3.2 90 4/19/2024
4.3.1 75 4/19/2024
4.3.0 91 4/6/2024
4.2.5 91 3/14/2024
4.2.4 81 3/2/2024
4.2.2 104 2/17/2024
4.2.1 87 2/10/2024
4.2.0 79 1/29/2024
4.1.0 82 1/19/2024
4.0.6 103 12/24/2023
4.0.5 93 12/12/2023
4.0.4 146 11/9/2023
4.0.3 137 10/19/2023
4.0.2 113 10/2/2023
4.0.1 103 9/18/2023
4.0.0 111 9/17/2023
3.15.1 127 6/30/2023
3.15.0 97 6/26/2023
3.14.4 154 6/21/2023
3.14.3 149 6/11/2023
3.14.2 158 6/7/2023
3.14.1 142 6/3/2023
3.14.0 174 5/31/2023
3.13.4 187 5/21/2023
3.13.3 153 5/8/2023
3.13.2 146 5/6/2023
3.13.1 214 4/27/2023
3.13.0 205 4/23/2023
3.12.3 253 3/31/2023
3.12.1 257 3/22/2023
3.12.0 295 2/27/2023
3.11.2 304 2/1/2023
3.11.1 282 1/31/2023
3.11.0 344 1/16/2023
3.10.0 338 1/3/2023
3.9.5 321 12/31/2022
3.9.4 321 12/29/2022
3.9.3 338 12/14/2022
3.9.2 323 12/11/2022
3.9.1 350 12/3/2022
3.9.0 372 12/1/2022
3.8.3 358 11/10/2022
3.8.2 395 11/5/2022
3.8.1 368 11/2/2022
3.8.0 397 10/29/2022
3.7.2 451 10/20/2022
3.7.1 412 10/17/2022
3.7.0 441 10/12/2022
3.6.8 459 10/4/2022
3.6.7 490 10/1/2022
3.6.6 473 9/20/2022
3.6.5 564 9/18/2022
3.6.4 521 9/15/2022
3.6.3 479 8/30/2022
3.6.2 482 8/22/2022
3.6.1 504 8/19/2022
3.6.0 492 8/17/2022
3.5.6 505 7/29/2022
3.5.5 510 7/19/2022
3.5.4 558 7/14/2022
3.5.3 564 7/7/2022
3.5.2 543 6/25/2022
3.5.1 526 6/24/2022
3.5.0 527 6/19/2022
3.4.3 578 5/21/2022
3.4.2 533 5/16/2022
3.4.1 550 5/2/2022
3.4.0 584 5/2/2022
3.3.2 603 4/14/2022
3.3.1 566 4/11/2022
3.3.0 595 4/10/2022
3.2.2 584 4/6/2022
3.2.1 606 4/2/2022
3.2.0 619 3/26/2022
3.1.1 473 3/21/2022
3.1.0 485 3/17/2022
3.0.0 463 3/12/2022
2.29.0 151 2/21/2022
2.28.1 135 2/15/2022
2.28.0 135 2/13/2022
2.27.7 161 1/27/2022
2.27.6 158 1/7/2022
2.27.5 150 1/5/2022
2.27.4 150 12/26/2021
2.27.3 166 12/24/2021
2.27.2 147 12/23/2021
2.27.1 157 12/22/2021
2.27.0 165 12/18/2021
2.26.0 176 12/6/2021
2.25.3 172 12/2/2021
2.25.2 2,871 11/25/2021
2.25.1 356 11/23/2021
2.25.0 405 11/18/2021
2.24.4 405 11/14/2021
2.24.3 434 11/13/2021
2.24.2 202 11/5/2021
2.24.1 175 11/3/2021
2.24.0 190 11/3/2021
2.23.6 175 10/12/2021
2.23.5 223 10/7/2021
2.23.4 204 10/4/2021
2.23.3 147 10/4/2021
2.23.2 230 10/2/2021
2.23.1 191 9/23/2021
2.23.0 180 9/21/2021
2.22.0 191 9/16/2021
2.21.1 183 9/6/2021
2.21.0 161 9/3/2021
2.20.5 163 8/31/2021
2.20.4 183 8/29/2021
2.20.3 168 8/28/2021
2.20.2 191 8/27/2021
2.20.1 165 8/26/2021
2.20.0 179 8/24/2021
2.19.5 190 8/22/2021
2.19.4 168 8/22/2021
2.19.3 171 8/22/2021
2.19.2 171 8/21/2021
2.19.1 183 8/19/2021
2.19.0 170 8/17/2021
2.18.0 178 8/12/2021
2.17.0 184 8/8/2021
2.16.0 180 8/1/2021
2.15.1 304 7/24/2021
2.15.0 280 7/16/2021
2.14.3 226 7/12/2021
2.14.2 343 7/11/2021
2.14.1 226 7/7/2021
2.14.0 243 7/3/2021
2.13.4 310 6/25/2021
2.13.3 195 6/12/2021

- **File formats:**
- (Add) nanoDLP file format
- (Add) SL1 printer note keyword: `LAYERIMAGEFORMAT_xxx` sets the layer image format required for the converted file if the format have multiple options (For Archives with PNG's)
- (Fix) Anycubic file format: Model Min/Max(X/Y) was not properly calculated
- (Fix) Photon Mono M5s Pro incorrect display height and width (fixes #854)
- **PrusaSlicer:**
- (Add) Concepts3D Athena 8K & 12K
- (Change) Wanhao D7: Add `LAYERIMAGEFORMAT_Png32` to printer notes
- (Change) Nova3D Bene4 Mono, Bene5, Elfin2 Mono SE, Whale, Whale2: Add `LAYERIMAGEFORMAT_Png24BgrAA` to printer notes
- **UI:**
- (Add) Settings - Automations - Events: After file load, before file save and after file save. Events are fired upon an action and execute a defined script.
If the script is written with the UVtools scripting structure, it will run under an operation and within the Core context.
Otherwise, if plain C# code is used, it will run under the Terminal and in the UI context.
- (Add) Show a message of congratulations on the software birthday (Trigger only once per year)
- (Add) Menu - Help: Add "Community forums" submenu, move Facebook group into it and add GitHub, Reddit, Twitter and Youtube
- (Change) Window title: Move version near software name and add the system arch to it
- (Change) About window: Move version near software name and add "Age" label
- (Change) Benchmark tool: Add a thin border to the result panels
- (Improvement) On the status bar, hide the " @ mm/min" from lift speed label if file is not able to use lift speed parameters
- (Improvement) Re-style the new version button
- (Fix) Show print times correctly when larger than a day (#854)
- (Upgrade) .NET from 6.0.27 to 6.0.28
- (Upgrade) Wix from 4.0.4 to 5.0.0