• New Image Diff mode buttons in the toolbar:
  You can now compare your modified image against the original image using these handy new toolbar modes. The default is the current image (shortcut key 'a'), the next is the modified (shortcut key 'b'), then an animated diff (shortcut key 'd'), and finally a split view (shortcut key 's'). This is great if you want to see color changes, how compression works with the write node (with the “Read back encoded image” option enabled), or just generally how your image is changing.
• New Send Notification node, which allows you to send out system notifications for when a workflow starts, ends, or for each image processed.
• New PDF Rasterizer node to convert all vector and text components of a PDF to full page images (Pro only).
• The Auto Level node now has an option to trim out the transparent area that is introduced when rotating an image.
• The Write node now has options to make indexed PNG files. The Indexed PNG node is now deprecated.
• The Layer & Page Splitter node has a new Filename: field which you can enter the usual tokens and such to determine what the name of the split image is. You can also use the “$LayerName$” token in this field (without the quotes of course) to use the layer name as part of the fiel name.
• If you're reading in a CSV file and using a node such as the QR Code, the token dropdown will automatically populate with the titles of the CSV columns. This is awesome if you have a CSV file full of URLs that you'd like to use for QR Code generation.
• New option for the Write node, “Keep original and modified dates”. This will let Retrobatch know what you want your written images to use the original and modified dates of the read image.
• New scale option of “Max Dimensions” in the Scale node. When used, it will scale down your images proportionally so that it will never exceed the given width or height.
• New file sorting options as part of the Read Folder node: “Create date, ascending”, “Create date, descending”, and “Randomize”.
• The Read Files node now has sorting options (which mirror the same options in the Read Folder node).

• A little thing: Retrobatch will detect if you’ve moved a write folder to the trash and throw up a warning.
• The preview canvas will now render in 16 bits per component for deep color images when needed.
• When running Retrobatch from the Terminal, it no longer shows up in the Dock.
• Updated to the latest version of pngcrush.

• Minor speedups when previewing images with the Multi Scale node.
• Fixed a problem where the Extract Metadata node might fail.
• You can now open up Retrobatch droplets from the File ▸ Open… menu. (You can also open up a droplet by holding down the option key when launching it).
• Fixed a problem where the UI wasn't updating properly when files were being preprocessed.
• Retrobatch will now use less memory when preprocessing images, especially when the Rotate node is used.
• Made some tweaks to the Layer & Page Splitter node so that it works better with the “Source Folder Path” write token.
• Fixed a problem where the “Source Folder Name” token wasn’t correctly set when writing out a PDF generated from the PDF Maker node.
• The Prompt for Files node does a much better job at informing how many files will need to be processed.
• Fixed a problem where Adobe Illustrator files with PDF compatibility turned on were not being read correctly.

• The Rules node now has new options to detect if the Option, Command, Control, or Shift keys were pressed when the workflow started running.
• New File Rename node, which works like the File name: field in the Write node, but without actually writing anything. The previous “File Rename” node has been renamed to “File Name Search & Replace”.
• New: The Tile Chop node now has an option to splice up an image from the top down.
• New: The Grayscale Filter has extended the range of values for the RGB sliders from 0-100% to -200-200%. In addition to this, it now includes an Intensity slider which controls the blending of the grayscale filter. This allows for more creative channel mixing when making monochromatic images.
• New Javascript API for getting the top classifications in an asset: asset.topClassifications(10); You can find documentation on it in the Asset API, and a sample plugin using it is available via the sample plugins page.

• Minor tweaks to the pngcrush functionality for cases where it might lose it’s mind and write an uncompressed PNG.
• Tweaks to the Write node to make sure the output folder is always created if it's been removed after opening a workflow.
• Fixed some issues when trying to write WebP images to the clipboard.
• No longer showing a warning to add a write node when the “Extract Text” node is being used.

• The Rules node now has an Orientation option for matching (or not) Square, Portrait, or Landscape images.
• The Write Node and Text Watermark nodes now have a “Clipboard” text token (located under the “Other” submenu in the Write node).

• Fixed a problem where metadata was not copied when writing as WebP images.
• Fixed a problem where RAW images from a Sony ILCE-1 camera was not loading correctly.
• Fixed a bug where the Set DPI Node wasn’t doing the right thing with PDF files.

• New CSV Reader node (Retrobatch Pro only). This fantastic node will read in a CSV file and produce an image for each row. You can then use that data to populate a template with text and images, and then even use the Write Images node to output the image to a specific file name. You can follow along with a quick little tutorial in our documentation to learn all about this node.
• New Dynamic Image node (Retrobatch Pro only). This is a fun node which will allow you to overlay images to templates using the above CSV reader node, or with custom JavaScript. Visit our technote on the topic (RBTN005) for more information.
• The Trim to Edges node now has a “Trim All Transparent Edges” option, which will prune out all transparent edges of your image, and not just to the first opaque pixel. So if you rotate an image, and then use this node after it, there will be no transparent pixels left along the edges of your image.

• Fixed a problem where JPEG-XL images might not be written correctly.
• Fixed a problem where 1 bit TIFF files might not being written correctly.
• Fixed a problem where SVG files were being allowed into workflows on MacOS 12 (SVG rendering is only on MacOS 13+).
• Fixed an issue with the Shell Script node where it wouldn’t always pass the image path as an argument to the script.
• The “Quit Retrobatch” node now waits a second before quitting the app if you have enabled the preference to play a sound when a workflow ends.
• Added a bunch more IPTC extension tags for the Set Specific Metadata node.
• Fixed an issue where there were scrollers always present on the canvas when you had the System Setting “Show scroll bars” set to always.

• A new Look up Table (LUT) node! The LUT node can be used to quickly and easily alter the color and tone of your images. LUTs can be used to create a wide range of effects, from subtle color adjustments to dramatic stylistic changes — it’s like a pre-programmed filter, but with more flexibility and control. Use one of Retrobatch’s LUT presets, or download additional LUTs that emulate film stocks, create specific moods (like warm, cool, or vintage), or simply enhance the natural colors in your image.
  You can also adjust the opacity and blending mode of the LUT. Use a grayscale LUT and then dial back the opacity to create some dramatic effects in your images.
  (Retrobatch Pro only)
• New “Tile Chop” node which will take an image and split it up into multiple images based on a width and height set in its properties.
• New “Camera Capture” node which uses your Mac’s built in camera to take a photo (Retrobatch Pro only).
• Photos Export now has an option to export the Current, Unadjusted, or Original versions of your Photos Library images.
• New “Auto Process” option in the RAW Import node. This lets you skip the fiddly options and just lets Retrobatch make the best guess at how the image should be processed.
• Two new nodes for renaming files. “File Rename” which will take one search string and replace it with another, and “Web Safe Rename” which will take a sequence of characters and then replace those with a given string. This is handy for tasks where you need to take out special characters or spaces from your images to make them easier for handling on the web.
• There’s a new Advanced tab in Preferences, with some new options:
  • A new “Default Write Folder” that will be used anytime you add a Write node.
  • A “Clear JavaScript console when a workflow runs” option, which is useful for plugin authors.
  • A “Allow unknown file types” option, which can be used to load ancient file types that MacOS no longer recognizes (Pro only). Find out more about this preference if you find it intriguing.

• The Multi-Scale node will now scroll its properties in the case of it getting overly large.
• The Super Resolution node now supports images with transparency.
• Fixed a problem where using Folder Actions + AppleScript might not work correctly with the App Store version of Retrobatch.
• Fixed a problem with the RAW Import node where images were being rendered much too dark because of some bad configurations.
• Fixed a problem where the Multi Scale node would give incorrect dimensions for the image width and height filename tokens.
• Fixed a problem reading RGB101010 HEIF images from Sony a7C images.
• Fixed a problem where the Multi Scale node would show a bit of nonsense in the filename tokens by default.

• When a preflight is interrupted, the file counts in the nodes could be off. Retrobatch will now prepend a ~ to the total when this happens. (You’ll generally see this with nodes which take a long time to work, such as the “Classify Images” ML node.
• The “Fix EXIF Rotation” node is a bit more efficient.

• The Super Resolution node now has an option to scale your image by 2x, 3x, or 4x.
• The Photos Export node how has an option (turned on by default) to embed any assigned location information as GPS location metadata in the image.
• The Rules node has a new “File Extension” rule you can match on.

• Fixed a problem where Retrobatch would show a warning that you didn’t have a Write Node, but you did have a Write Back to Photos or Import to Photos node, which should count. The same goes for writing to the clipboard.
• Fixed a problem where the Super Resolution node was accidentally only scaling images 3x instead of the advertised 4x.
• Fixed a problem where the Image Watermark node was blowing out some alpha channels when it was scaled.
• Fixed a problem where the Photos Import node might import incorrect image data.
• Fixed a problem when using the Photos Export node where Retrobatch could ignore any metadata change nodes.
• Fixed a problem where the old Photos Library node was still showing up (it was replaced by the “Photos Export” node).

• The Photos Export node will now show a little warning if access to the Photos Library is denied.
• The Clipboard node is also under the Write category now, with a default of “Write to clipboard” when it’s selected.

• Fixed a problem where Retrobatch would close an already open workflow if it was used in a Shortcuts action. Now Retrobatch will keep it open if it’s already up, and close if it had to be opened to run the action.
• Fixed a problem where Shortcuts would show an error when running workflows with a Quit Retrobatch node.
• Fixed a problem where you were unable to copy and paste certain nodes on the canvas.
• Fixed a problem where writing of WebP images would not work (App Store only).
• Fixed a problem where manually entering GPS coordinates wouldn’t always work correctly.
• Fixed a problem where Retrobatch could crash when adding the Photos Export node on MacOS 13.
• Fixed a problem where the properties for the Trim to Edges node wouldn’t show correctly after dismissing it’s popover and bringing it back.
• Fixed a problem where the image orientation flag could be lost when setting the GPS coordinates, DPI, or other meta-data only operations.
• Tweaks to the Indexed PNG node.

# New Nodes

• New “Super Resolution” node, which uses machine learning to scale up your image 4x its size.
• New “Film Grain” node. Does what you think it does. Combine it with a Vignette to make your photos look older and analog!
• New “Get Selected Finder Images” node, which will use any selected images in the Finder for your processing (not available in App Store version).
• New GPS node, which will allow you to assign a specific location to your images using the GPS image metadata fields.
• New “Photos Export” node which replaces the “Photos Library” node (which Apple has deprecated libraries it uses). This new node will download from iCloud as well as export the unmodified originals from Photos, including RAW photos.
• New “Photos Library Import” where you can send images to a specific album in your Photos library.
• New “Photos Library Modify” which will send an image back to the Photos Library from which it came. If you want to modify a set of images all the same way, this is a good way to go.
• New “1Bit” node which turns your images into 1bit images.
• New “Finder Icon Writer” which will use the processed image to write back an icon in the Finder for the original image being processed. If you’ve ever wanted custom thumbnails for an image, this is the way.
• New “Quit Retrobatch” node which will quit Retrobatch when a workflow is done. This is useful for droplets when you want to make sure Retrobatch is dead and gone after it runs.
• New “PDF Quartz Filter” which gives you access to the various PDF filters in ColorSync Utility. You can apply filters to a whole PDF like “Reduce File Size” or Sepia Tone“.
• New ”Contrast Stretch“ node which will improve the contrast for your image by stretching the intensity of the image to cover a larger range.
• New ”Image Equalization“ node which will spread out the histogram peaks of your image, making certain areas less intense (or at least more even).
• New ”Download“ node which you can plug a URL into and Retrobatch will download it for you.
• New ”Replace Color“ node which finds a specific color in your image and replaces it with another.
• New ”Acorn Maker“ node which will make a layered Acorn image (similar to the PSD Maker node). You can combine this with the Screenshot and Windows node to make a new Acorn image of all your visible windows, with a layer for each window.

# New Retrobatch Pro Nodes

• New ”Auto Level (Straighten) node which will rotate your image a bit if it looks like it might not be very level .
• New “Recognized text” option for the Rules node which you can use to filter out images based on character recognition in the image.
• New “Clipboard Watcher” node which will look at your clipboard every second and if there’s a new image on there, it’ll run the workflow using that image as input.
• New “Periodic” node which will run the chain of nodes it has attached to it after a certain number of configurable seconds.
• New “Extract Text” node that will scan your images for text and write it out to a file.
• New “Image Diff” node which will compute the difference in colors between every other image.
• New “Extract Metadata” node that can write out the metadata from an image in either plain text or JSON formats.

# Improvements & New Features

• The preview window has been enhanced so that you get a list of selected nodes on the left, and larger preview of the images you’re processing on the right. You can bring up the sheet by pressing the space bar, then tweak your nodes to get them exactly how you’d like them to be, and then pressing the spacebar (or escape key) to dismiss the preview.
• Shortcuts support! You can now make a Shortcut which points to workflow, allowing you to pass in images, or folders of images. You can also use this to setup Quick Actions in the Finder.
• Retrobatch can now read SVG files, which is awesome if you want to convert a bunch of them into JPEG or PNG files (MacOS 13+).
• Retrobatch can now read and write JPEG-XL files. Visit https://jpeg.org/jpegxl/ for more info.
• WebP (and JPEG-XL) now have options for lossless encoding.
• The Write node now has compression options for the TGA image format.
• The Write node has a new option to embed a thumbnail for JPEG and HEIC images.
• The Write node now has a “Read back encoded image”, which is handy if you want to write your image out as a specific type and then throw it on the clipboard as the newly encoded type.
• The Image Watermark and Text Watermark can now have negative values for the offsets.
• The Windows & Screenshots node now has an option to exclude the shadow from windows.
• You can change the color accent of a node by control clicking on it and choosing “Change Node Accent Color…” or selecting a couple of nodes and using the View ▸ Change Node Accent Color… menu item.
• You can now set the working color profile for workflows. This is for cases where you want certain filters to work more closely to certain image editors, or if you’re using something like the Custom Convolution node and you want to tightly control how pixels are processed.
• New option to the Clipboard node which allows you to write the native type of an image to the clipboard. If you have a compressed JPEG, it’ll write that exact data to the clipboard if that option is selected. Otherwise it’ll write PNG and TIFF data by default.
• A new Document Settings sheet (under the View menu) which allows you to have per-document settings for the following things:
  • Manual node connections.
  • Wether or not a preflight is automatically run.
  • A pixel processing profile to use for various filters (mostly Core Image based).
• The Animated Image node now has a token field for setting the name of the image it produces.
• There’s a new token in the Write node for the album name when pulling images out of Photos.
• The Drop Shadow node now has an option to keep the original dimensions of an image, for cases where you’re processing images with transparent cutouts and you want the shadow to appear inside the image only.
• The Border node now has an option to have a corner radius.
• The Scale node now offers the Lanczos and Bicubic scaling algorithms for resizing images.
• The Delay node can now specify when the delay should happen: Preflight, Every image (the default), or Postflight.
• Open in App node: Dragging an app icon from the Finder onto the Open in App node will use that app to open the images.
• Open in App node: Dragging an app icon from the Finder with the option key held down will now add an Open in App node to your workflow.
• Open in App node will now remember the last app you picked, and use it for newly created nodes.
• New option in the Write node to encode your JPEG files using the MozJPEG encoder.
• The Screenshot node now has text field you can use to filter which screenshots are used in a workflow. For instance, if you only want to capture windows from Safari, you would enter “Safari”.
• Nodes on canvas have a new contextual menu to enable/disable the node, as well as bring up the properties.
• Shell Script node improvements: It’ll now show a warning if the shell script you choose isn’t executable, and even offer a recovery solution. It also includes a link to online documentation about what you can do with it.
• A new Retrobatch setting to only show properties when double clicking on a node.

# Differences between App Store / Sandboxed and Direct versions.

• The AppleScript, Shell Script, and Get Selected Finder Items nodes are not available in the App Store / Sandboxed version of Retrobatch.
• Using Retrobatch as a command line tool will run into file reading problems in the App Store / Sandboxed version of Retrobatch.
• For more information on the differences, visit the following URL: https://flyingmeat.com/retrobatch/docs-2.0/provsregular/

# Changes

• The “Set Finder Tags” will decide when to write the tags in based on if you have a write node behind it or not. If there is no “Write” node farther down the chain from the “Set Finder Tags” node, then the “Set Finder Tags” node will apply tags to the last read/written place an asset has occupied. So you can have a workflow with two nodes in it: A “Read Folder” → “Set Finder Tags” node, the tags will be written to the original location (this is the original behavior). But if you have a “Read Folder” → “Set Finder Tags” → “Write Images” workflow, then the tags will be added to the images where they were written via the “Write Images” node.
• The Rules node will now take float values for the “Megapixels” rule.
• The “Photos Library” node has been deprecated (since it’s using APIs Apple wants to get rid of). Instead, use the updated Photos Export node.
• When using Retrobatch 1.x from the shell, passing a folder as an argument would search through that folder for all image files and synthesize a “Read Files” node and the path hierarchy information would be tossed out. In Retrobatch 2, when a folder is given as an argument Retrobatch will now synthesize a “Read Folder” node for each folder argument it comes across and preserve the folder hierarchy for any images found.

# Fixes

• Fixed a problem where the $SourceFolderPath$ token working correctly with the Indexed PNG and Animated Image nodes.

# Other

• When running Retrobatch from the Terminal with the --workflow option, it will now print out information about what node is currently working on a file.
• The “PDF Image Extractor” node does a better job at finding images, is faster, and will not re-encode image data if not necessary.
• The Write node will now open up multiple folders if options like “Write back to original image” or the “Source Folder Path” options are enabled (and it’s cases like these where output might be to multiple folders!)
• Retrobatch will now offer to move itself to the Applications folder if it isn’t already there.
• Did you know you can pull out meta from IPTC tags without a token in the Write node? Just use “$assetMeta.{IPTC}.City$” to grab the city from the IPTC metadata.
• Retrobatch is a bit smarter at figuring out what type of images it’s loading up if MacOS can’t figure it out on its own.
• The Shell Script node will now always append the (last saved) path to the image being worked on when “Every Process” is set for the Run at: option. Previously, Retrobatch would only append the path if no argument options were supplied.
• The “Quality” slider in the Write node has been changed to “Quality / Comp.” as an indicator that it effects compression as well.
• Double clicking on a node connection will reverse the direction of the connection.
• Retrobatch now gives you a little bit of play when single or double clicking on a node to bring up the properties. So if you’re using a trackpad or have unstable hands and move the pointer a little bit (no more than 5pt), RB will just assume you meant to bring up the properties.
• If you hold down the option + command keys in the Feedback window, you are given the option to email the report using your preferred email client.

# I’m not sure why I’m listing this, but I am anyway

• Some new debugging prefs for the droplets:
  defaults write com.flyingmeat.retrobatch.RBDroplet keepAlive 1
defaults write com.flyingmeat.retrobatch.RBDroplet showLogWindow 1
  This will require making a new droplet for these prefs to work.