Releases · ZEISS/czicompress

The 1.1.0 release of CziShrink is functionally identical to the 1.0.2 release.

It is built on and runs on .NET 8 (CziShrink 1.0.2 is on .NET 7).

Installation

An installer is not available yet but we plan to provide one in one of the coming releases.

Windows: Download CziShrink_1.1.0+1998995_win-x64.zip, unzip, and run CziShrink.exe
Linux: Download CziShrink_1.1.0+1998995_linux-x64.zip, unzip, chmod u+x ./CziShrink, and run ./CziShrink

Use nuget caching by @m-ringler in #24
Bump Microsoft.Extensions.Logging.Abstractions from 7.0.1 to 8.0.0 in /czishrink by @dependabot in #25
Switch to dotnet8 for compilation and target framework by @m-ringler in #28

Full Changelog: v1.0.2...v1.1.0

This is the first release of "CZI Shrink" which allows bulk-compression of large amounts of CZI files.

We release "CZI Shrink" on Windows and Linux.

CZI Shrink provides the following functionalities in this release:

selection of input and output folder
5 operation modes: 3 different compression modes (always compress to lossless ZSTD), decompress, dry run (just list all CZIs and their size in the CSV file)
option to compress files in sub-folders
option to copy files to the output folder that could not be compressed due to some issues in the CZI
option to change the compression level from the default level 1 in a range of 0 to 22 (recommendation to stay a level 1 or use a level of 4 to 5 at max)
option to use less threads to compress files in parallel - in case of bandwidth limited source or target locations (default: number of logical cores - 1)
display of current progress for compressed files
list of files that could not be compressed successfully for some reason
context menu for files with errors (open file in ZEN, open containing folder, copy file path (works also for multi-select))
display of current compression progress (files compressed, input data size, compressed data size, total duration, total compression ratio)
open resulting CSV file with all details when compression has finished
copy statistics to clipboard when operation is done (you might want to share it on social media)
application version info, license and links
ask user whether to stop compression when (accidently) closing the app

An installer is not available yet but we plan to provide one in one of the coming releases.

Windows: Download CziShrink_1.0.2+1987439_win-x64.zip, unzip, and run CziShrink.exe
Linux: Download CziShrink_1.0.2+1987439_linux-x64.zip, unzip, chmod u+x ./CziShrink, and run ./CziShrink

"CZI Shrink" will also be available via the ZEISS Microscopy Installer in the future.

FAQ's:

Is the compression lossless?
- Yes. More information can be found on the ZSTD wiki entry.
What should I do if I encounter an error during compression?
- Try opening the problematic file in ZEN by right-clicking it in the error section and selecting the appropriate option. If ZEN opens the file, it has minor defects and might be corrected by saving it in ZEN using the "Save As with Options" function. If ZEN can't open the file, it has a serious error and might be irreparable. For further investigations, use CZICheck.
How can I optimize the compression process?
- Several ways to optimize compression include adjusting the number of threads for parallel compression or modifying the compression level. However, keep in mind that higher compression levels could significantly increase compression time with minimal size reduction. It's recommended to use level 1 for regular compression, and level 4 or 5 for cold storage compression after testing on your data.
How can I share my ideas or issues?
- Please submit your ideas or issues as an issue in our GitHub repository: Issues · ZEISS/czicompress (github.com).