A small GUI wrapper utility around imagemagick and pingo for image optimization.
Installation Tutorial: On the Wiki
Download the latest release here: https://github.com/DrWhoCares/imgdanke/releases.
Download the latest appropriate release of imagemagick and pingo and ensure they are either on your PATH, or that magick.exe and pingo.exe are in the same folder (or any subfolder) as imgdanke.exe.
You can run imgdanke without pingo if you want, or are unable to run pingo (such as on Unix where it may not be possible). Some options will be disabled.
Then simply run the .exe.
- Technical Details
- Documentation
imgdanke is a utility built using C# and the .NET Framework (v4.8).
It also makes use of these packages:
- System.Text.Json v5.0.1
- WindowsAPICodePack-Core v1.1.2
- WindowsAPICodePack-Shell v1.1.1
- Onova v2.6.2 (and its dependencies)
Using Onova, the program will automatically check for new releases on Github and prompt the user to install on startup.
Settings are stored in the config file located next to the .exe (after first startup) called imgdanke_UserConfig.json.
Opens the imgdanke User Config file in the default text editor.
Opens the path to the Source Folder Path in explorer, or nothing if Source Folder Path is invalid or empty.
Opens the path to the Output Folder Path in explorer, or nothing if Output Folder Path is invalid or empty.
Opens the path to where the imgdanke executable is currently stored in explorer.
Manually does a save of the current settings. Almost entirely redundant, since the config is saved after almost any config value is updated.
Opens up a new dialog box that allows you to edit the valid file extensions which will be parsed for populating the Files in Source Folder ListBox.
Opens up a new dialog box that allows you to edit the valid file extensions which will be selectable in the Output Extension ComboBox.
Closes the program.
If checked, the final output of the files will be a new folder in the Output Folder Path. The name of the folder is determined by the Output Setting's Folder Name TextBox. Additionally, if Should Add Tags To New Output Folder is checked, any selected tags will be added. Should Output To New Folder is a shortcut for this setting.
The base name of the newly created folder for the final location of the files to be output to. Default is _danke.
If checked, any selected tags will be appended to the final output filename(s). Add Tags To Filenames is a shortcut for this setting.
If checked, and Should Add Tags To Filenames is true, one of the following tags will be appended to the final output filename(s):
(NoPreset)(CustomPreset)(Gray1bpp)(Gray4bpp)(Gray8bpp)(PingoColor4bpp)(PingoColor8bpp)(MagickColor4bpp)(MagickColor8bpp)
If checked, and Should Add Tags To Filenames is true, the value of the magick options selected will be appended to the final output filename(s). Some of them have prepended values, or a static value, and are listed below:
- -dither is just the value, e.g.
(None) - -colorspace is just the value, e.g.
(Gray) - -colors is
colorsand the value, e.g.(colors16) - -depth is
depthand the value, e.g.(depth2) - -posterize is
posand the value, e.g.(pos16) - -normalize is just
(norm) - -contrast-stretch is just
(cs) - -auto-level is just
(al)
If checked, and Should Add Tags To Filenames is true, the value of the pingo options selected will be appended to the final output filename(s). Some of them have prepended values, or a static value, and are listed below:
- -pngpalette is
pngpaland the value, e.g.(pngpal24) - -nodithering is just
(nodither) - -s is
-sand the value, e.g.(-s9) - -strip is just
(-strip)
If checked, any selected tags will be appended to the newly created folder that files will be output to. Add Tags To New Folder is a shortcut for this setting.
If checked, and Should Add Tags To New Output Folder is true, one of the preset tags will be appended to the newly created folder that files will be output to. Tags work exactly the same as Filename Tags Include Preset.
If checked, and Should Add Tags To New Output Folder is true, then the value of magick options selected will be appended to the newly created folder that files will be output to. Tags work exactly the same as Filename Tags Include magick Settings.
If checked, and Should Add Tags To New Output Folder is true, then the value of pingo options selected will be appended to the newly created folder that files will be output to. Tags work exactly the same as Filename Tags Include pingo Settings.
If checked, the final output of the files will be a new folder in the Output Folder Path. The name of the folder is determined by the Output Setting's Folder Name TextBox. Additionally, if Should Add Tags To New Output Folder is checked, any selected tags will be appended. This is just a shortcut to the same option in the Output Settings dialog box.
If checked, Output Folder Path will be disabled, and the value of it will be replaced by Source Folder Path.
If checked, Should Add Tags To Filenames will be set to true. Any tags selected will be appended to the final filename(s). This is just a shortcut to the same option in the Output Settings dialog box.
If checked, Should Add Tags To New Output Folder will be set to true. Any tags selected will be appended to the newly created folder that files will be output to. This is just a shortcut to the same option in the Output Settings dialog box.
If checked, a check for any updates will be made once, after starting up the program.
If checked, disables the dialog box that appears if the check for new updates fails for any reason.
Performs a manual check for new updates.
Opens the link to the imgdanke GitHub page, https://github.com/DrWhoCares/imgdanke in the default web browser.
Opens the README.md file in the default text editor.
Opens the link to the imgdanke README.md file on the GitHub page, https://github.com/DrWhoCares/imgdanke/blob/master/README.md in the default web browser.
Opens a dialog box displaying some basic information about imgdanke.
Click the button and select a folder with images in it and/or a folder that contains subfolders which contain images. Supported filetypes are restricted by what imagemagick and/or pingo allow, but are defined by the list of Input Filetypes. Supports dragging and dropping a file onto the Source Folder Path's TextBox. Also supports dragging and dropping file(s) onto the Files in Source Folder ListBox, which will update your Source Folder Path and will additionally select the files.
Click the button and select a folder to output to. Choosing the same directory as the Source Folder Path will replace the original images, should the input and output be the same. Avoiding replacement can be done via changing the name with Prepend To Output, Append To Output, or Append Tags To Filenames. Or you can simply change the output directory, or use Output To New Folder.
If this is checked, the original files will be deleted after all processing is done except for the following cases:
- The original file is a .psd file.
- Replace Originals is checked and the original file has the same extension as the final file. In other words, if the file is replaced, it won't be deleted afterwards.
If this is checked, the file(s) selected will be replaced with the final file, ignoring the Output Folder Path (which is shown by being disabled when checked). However, the original file(s) selected will not be replaced if the Output Extension differs from the original extension.
This will only appear if Replace Originals is not checked, and Include Subfolders is checked.
If this is checked, the files output will appear in the Output Folder Path, while maintaining the subfolder structure (assuming you selected files within subfolders). This means that the subfolder paths will be created in the selected Output Folder Path. Should the Source Folder Path and the Output Folder Path be the same, then a new folder named _OUTPUT will be created. Any files selected that are not within a subfolder, will still end up in this new _OUTPUT folder, just at the root of it.
Selecting any preset setting other than Custom Preset will cause the current selections to be replaced.
Additionally, every preset will also set the following for the pingo command (this is lossless optimization):
-s9-strip
Selecting this preset will set nothing, other than the previously mentioned settings. This is lossless.
Selecting this preset will keep anything you currently have selected, and will save any changes you make, and reload them if you close and reopen the program. This is primarily for advanced usage, when you know what the settings do. You should likely set this before manually editing the commands.
These presets will discard all color information via -colorspace Gray.
Selecting one of these presets will always set the following (in addition to previously mentioned settings):
-dither None-colorspace Gray-posterize(with the value of colors listed in the preset, not used for 8bpp)-normalizeand-contrast-stretch 0%x0%or just-auto-levelfor 4bpp (Used to help make the blackest black color#000000and whitest white color#FFFFFF)
This sets -posterize 2 and will produce a 1bpp black and white image.
This sets -posterize 16 and will produce a 4bpp grayscale image.
This does not set -posterize 256 as it is redundant because -colorspace Gray will handle it.
Please note that the pingo options tend to produce a better result than the magick options for color images 8bpp and lower.
-pngpalette does not work past 256 colors.
Selecting this preset will set the following (in addition to previously mentioned settings):
-colorspace sRGB-normalize-pngpalette=24(16c option)
Selecting this preset will set the following (in addition to previously mentioned settings):
-colorspace sRGB-normalize-pngpalette=100(256c option)
Selecting this preset will set the following (in addition to previously mentioned settings):
-dither None-colorspace sRGB-colors 16-posterize 256-normalize-contrast-stretch 0%x0%
Selecting this preset will set the following (in addition to previously mentioned settings):
-dither None-colorspace sRGB-colors 256-posterize 256-normalize-contrast-stretch 0%x0%
Magick Command-line reference Changes the type of dithering magick will apply in cases where reduction occurs. The following values are currently possible (via the GUI):
-dither None-dither FloydSteinberg-dither Riemersma
Magick Command-line reference Changes the colorspace of the image. It's important that this value is set for grayscale images as it does a number of important things under the hood (of magick).
The following values are currently possible (via the GUI):
-colorspace Gray-colorspace sRGB
Magick Command-line reference Limits the amount of colors the image can have by setting the maximum bound to the provided value. The actual value of colors in the final result may be less than the provided amount (when possible), but will never exceed the value provided.
Magick Command-line reference Sets the bit-depth of the image. Currently unused by any presets.
Magick Command-line reference
Magick In-depth documentation/tutorial
Maximum value of 256. When -colorspace Gray is set, set this value to the amount of colors you want in the final image.
Magick Command-line reference Normalizes the colors of the images. Ensures blacks are #000000 and such. It's not recommended to apply this more than once, especially for color images. On grayscale images it will likely have no effect if applied twice, but that is not always the case.
Magick Command-line reference Performs a contrast stretch to help ensure blackest black color is #000000 and whitest white color is #FFFFFF. It's not recommended to apply this more than once, especially for color images. On grayscale images it will likely have no effect if applied twice, but that is not always the case.
Magick Command-line reference An alternative method to ensuring blackest black color is #000000 and whitest white color is #FFFFFF. I suggest reading the documentation, but in testing, it seems it produces slightly better results for 4bpp grayscale images. It is pointless to call this more than once on the same image.
Uses a set number of bins, so the options provided to you are the different bits (and the resulting colors). Applies dithering, and often produces a far better result than using magick for color images with 256 colors or less. NOTE: As of pingo v0.99 [rc3 16], the bug with the incorrect values has been fixed.
The following values are currently possible (via the GUI):
-pngpalette=9(2c)-pngpalette=14(4c)-pngpalette=19(8c)-pngpalette=24(16c)-pngpalette=29(24c)-pngpalette=34(32c)-pngpalette=39(40c)-pngpalette=44(48c)-pngpalette=49(64c)-pngpalette=54(88c)-pngpalette=59(112c)-pngpalette=64(124c)-pngpalette=69(136c)-pngpalette=74(160c)-pngpalette=79(184c)-pngpalette=84(208c)-pngpalette=89(232c)-pngpalette=100(256c)
Disables dithering when performing lossy operations. Can potentially produce a smaller, and more accurate result when using -pngpalette values of 75 (184c) or greater. More extensive testing needs to be done to find appropriate recommendations. Enabled by default for the 8bpp color, pingo preset.
Losslessly optimizes .png files. -s0 is the least optimal, and -s9 is the best general use-case. -sb is the best for pure filesize optimization.
-sa and -sb are experimental brute force options (unoptimized for speed). In most cases, -sb will produce the same results as -s9, but may take more time.
Overall, -sb will sometimes produce better results (never worse), but the overall savings will only be around ~5%.
This should essentially always be set, there's nothing to lose.
The following values are currently possible (via the GUI):
-s0-s1-s2-s3-s4-s5-s6-s7-s8-s9-sa-sb
Strips unnecessary metadata from the file. If you don't need metadata, ensure this is checked to reduce filesize slightly.
This will be the file extension that the final image will be converted to.
If checked, any subfolders will be parsed for supported filetypes and included in the list of files with their subpath prepended to their name (to differentiate files with the same name, this does not affect the output name).
NOTE: This setting requires that the PSD file is saved with the "Maximize Compatibility" setting checked. This saves the rasterized version along with the normal layers.
If checked, PSD files will also be parsed and included in the list of files. If any PSD files are selected, they will be converted to the Output Extension before any processing is done via magick mogrify "inputFilename.ext[0]" "outputFilename.ouputExt". You can freely mix PSD files and normal image files.
The checkbox is just a shortcut to adding or removing .psd from the list of valid input extensions.
The commands will be applied to the selected files. All files are automatically selected by default. The list is refreshed every time you finish a command, or press the "Refresh List" button. You can drag and drop files onto this list and it will update the Source Folder Path and select the file(s) you dropped onto it. Additionally, you can right-click any file in the list to get a context menu that allows you to either open the file in your default image viewer, or open the path to the file in explorer.
The magick command will always happen before the pingo command.
Imagemagick command-line processing tutorial Uses mogrify to vastly improve processing speed by making use of multithreading. It's important to note that the order of arguments does matter, in some cases. The magick command will be skipped in the following situations:
- The command is empty.
- The command is
mogrify -format {outputExt} -path "%1/__danketmp/" -quality 10 *.{outputExt}(The default command, same as selecting No Preset). - The command is
mogrify -format {outputExt} -path "%1/__danketmp/" *.{outputExt}(The default command, same as selecting No Preset, and manually turn off the pingo-s*option).
pingo, unlike magick, does not allow for specifying output at this time (v0.99 [rc4 14]). It modifies the images directly, so ensure a copy is made via setting a separate output folder, or adding a prefix, suffix, or tags to the output filename(s), if doing a lossy operation and you're unsure of the results.
The string entered here will be prepended to the output filename(s). As expected, any characters which are defined as being illegal in filenames cannot appear in the string.
The string entered here will be appended to the output filename(s). As expected, any characters which are defined as being illegal in filenames cannot appear in the string.
Displays the total filesize (not the size on disk) of the files (after any PSD conversion) before either of the commands are performed.
Displays the total filesize (not the size on disk) of the files after the commands are performed.
Displays the total amount of savings and the percent saved.
Displays information to the user about issues or the current status of processing. When processing is finished, it will display the total time elapsed via C#'s Stopwatch class (so it may not be 100% accurate).
Currently two command line arguments are supported. You can pass up to two arguments, with the first being assigned to the SourceFolderPath, and the second being assigned to the OutputFolderPath. This functionality will likely be expanded in the future.
Any questions, feel free to contact me or create an issue (which is really helpful for keeping track of things to change or add).