var store = [{
        "title": "Batcher 0.1 Released",
        "excerpt":"     Initial release.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/0.1-released/",
        "teaser": null
      },{
        "title": "Batcher 0.2 Released",
        "excerpt":"     Updated Batcher to work with GIMP 2.99.18. Due to backwards incompatible changes, Batcher will no longer work with GIMP 2.99.16 and below.   Moved menu entries to the section containing Export... and Export As....   Fixed translations not working.   Fixed incorrect URLs to the help page when pressing the Help button.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/0.2-released/",
        "teaser": null
      },{
        "title": "Batcher 0.3 Released",
        "excerpt":"  Redesigned user interface:     Replaced the folder chooser widget with a folder chooser button.   Procedures and constraints are now aligned vertically.   Adjusting settings for procedures and constraints now immediately updates the preview for improved feedback and interactivity.   Multiple edit dialogs (one for each procedure/constraint) can now be displayed simultaneously.   Edit dialogs for procedures and constraints are no longer separate windows and are hidden/shown simultaneously with the main dialog.   Completely reworked the custom procedure browser. You may now preview and tinker with a procedure/plug-in/script directly from the browser dialog before adding it to the list of procedures permanently.   In edit dialogs, replaced PDB parameter names with human-readable descriptions where available. The names are displayed as tooltips in case a user wants to track down issues with a procedure.   Moved detailed information about a procedure/constraint from a tooltip to a button showing a popup.   Given the changes above, adjusted dialog dimensions, positions of separators and spacing/margins/border width.   Bug fixes:     Added executable bit to the main batcher.py file. This could otherwise prevent the plug-in from being registered (i.e. from appearing in GIMP) on Unix-like platforms.   Fixed a crash for PDB procedures containing GIMP resources (brushes, palettes, gradients, patterns) as settings.   Prevented errors for PDB procedures with array arguments requiring a non-zero number of elements (e.g. pencil).   Fixed an issue where color parameters for some PDB procedures could not be adjusted.   Fixed redundant preview updates when the main, edit or procedure browser dialogs (re)gained focus.   Other changes:     Renamed the Export Layers Now menu entry to Export Layers (Quick) for hopefully greater clarity.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/0.3-released/",
        "teaser": null
      },{
        "title": "Batcher 0.4 Released",
        "excerpt":"  New features:     Created separate dialogs and menu entries for batch-editing layers, named Edit Layers... and Edit Layers (Quick). Separate settings are provided for editing and exporting.   Added Export Selected Layers and Edit Selected Layers menu entries when right-clicking on selected layers in GIMP. These behave as Export Layers (Quick) and Edit Layers (Quick), respectively, except that only Layers and Selected in GIMP constraints apply.   Added a new layer name pattern called Full layer name which preserves the entire layer name, including characters beyond the last ‘.’. This is equivalent to [layer name, %e], only more convenient.   Changes to procedures and constraints:     Simplified the insertion of background and foreground. The Merge background/Merge foreground procedure is added automatically and is no longer available to be added manually. A constraint named Not background/Not foreground is also added automatically that ignores the background/foreground during processing. Updating the color tag in the Insert background/Insert foreground procedure also updates the color tag in the constraint.   Added back the Visible constraint displayed on the first run/after reset. This was removed in the previous version; this time, however, Also apply to parent folders is not checked by default.   User interface changes:     When Export Layers (Quick) is run for the first time, a small dialog with only export settings is now displayed. This reduces confusion as to where (output folder) and how (file extension, name pattern) the layers are exported. That dialog can be skipped by simply unchecking Show this dialog.   Dropdown menus are now consistently displayed below a GUI element and are left-aligned (e.g. menus displayed by pressing the Add Procedure... button or the Settings button).   Renamed Import Settings... to Load Settings from File... and Export Settings... to Save Settings to File... for clarity, respectively.   Moved Reset Settings menu entry under the Settings button to the bottom.   Closing the main dialog automatically can be turned on/off via the new Close when Done menu under the Settings button.   Bug fixes:     Fixed the Rename procedure not renaming layer groups when editing layers.   Fixed the Remove folder structure procedure not working when editing layers. A separate procedure with the same name was added for editing that also allows setting the visibility of child layers based on whether all its parents are visible.   Fixed the Scale procedure throwing errors if the resulting width or height would be 0 pixels. The new width and height will now always be at least 1 pixel.   Fixed the Selected in GIMP constraint applying only on a single layer when editing layers.   Fixed incorrect progress bar text if the user chose the new file to be renamed (to avoid overwriting a file with the same name).   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/0.4-released/",
        "teaser": null
      },{
        "title": "Batcher 0.5 Released",
        "excerpt":"  Changes to the export settings:     Added a button named Options... in the main dialog to adjust options previously only available when adding the Export procedure.   Rearranged export settings horizontally, both in Export Layers and Export Layers (Quick).   Renamed Save in Folder to Folder and Save As to Name for brevity.   The native file format dialog is no longer displayed by default. File format options are now adjusted in the export options (displayed by pressing the Options... button). This behavior can be toggled back if desired, particularly when you need to choose the image metadata to preserve (this can currently be adjusted only via native file format dialogs).   By default, when a file about to be exported already exists with the same name, the new file will be renamed. This was inconsistent previously (e.g. when running non-interactively, the default was to skip the new files).   The default export folder is now the Pictures user folder instead of Documents.   The file extension is now validated automatically. An invalid file extension is automatically reverted to the last valid value instead of displaying warnings.   The overwrite prompt is now displayed in Edit/Export Layers (Quick) if Show This Dialog is checked.   Changes to the Export procedure:     For Export Layers, the Export procedure now performs additional export instead of overriding the default export. The procedure name for Export Layers is now Also export as... to reflect this change. The name changes automatically as you modify the file extension (e.g. Also export as PNG if the file extension is png).   For Export Layers, when the Export procedure is added, values of the options are copied from the default export (e.g. the output folder will be identical to the one currently selected in the main dialog).   Add a new option If a file exists: that allows skipping the dialog asking the user to handle existing files and setting a fixed mode for all files.   Removed the Preserve layer name after export option. The layer name is now always preserved.   Other changes:     The Rename procedure for Export Layers now performs renaming on top of the default renaming (the text entry next to Name) instead of overriding it.   File load and file save procedures can no longer be added as custom procedures due to being redundant (loading a file would have no effect and file save procedures are already covered by the Export procedure).   The plug-in no longer crashes if the automatic update of plug-in settings to the latest version fails. Instead, the settings are reset.   Bug fixes:     Fixed unchangeable file extension in Export Layers (Quick).   Fixed overwrite prompt not being displayed for Export procedures for Edit Layers.   Fixed a crash when starting the plug-in if text layer(s) were selected in the preview and plug-in settings were saved.   Fixed a crash when in-dialog warning messages were displayed on plug-in startup (e.g. if the plug-in was saved with an ill-formatted file extension).   Removed the “Flatten” option from Merge Back-/Foreground as it was unsupported and caused merging to fail.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/0.5-released/",
        "teaser": null
      },{
        "title": "Batcher 0.6 Released",
        "excerpt":"     Updated Batcher to work with GIMP 3.0.0-RC1. Batcher now requires GIMP 3.0.0-RC1 or later. Earlier development versions of GIMP (2.99.x) will not work. Any future GIMP 3.x version will work unless stated otherwise.   Greatly optimized the preview when changing selection. The performance drop was noticeable for hundreds of items.   Fixed several bugs related to the preview when the selected item is changed.   Fixed Insert background and Insert foreground procedures inserting group layers twice.   Fixed occasional GIMP error messages when batch processing is finished.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/0.6-released/",
        "teaser": null
      },{
        "title": "Batcher 0.7 Released",
        "excerpt":"     Added Scale to fit and Keep aspect ratio options to the Scale procedure.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/0.7-released/",
        "teaser": null
      },{
        "title": "Batcher 0.8 Released",
        "excerpt":"  General changes:     Updated Batcher to work with GIMP 3.0.0-RC2. Due to backwards-incompatible changes, Batcher now requires GIMP 3.0.0-RC2 or later. Saved settings from previous versions will still work properly.   New features:     Non-destructive layer effects (filters, GEGL operations) can now be added as custom procedures. They can be found under the Filters, Effects category in the custom procedure browser. Beside parameters specific to each effect, you can adjust their blend mode, opacity, or they can optionally be merged into the layer (i.e. applied destructively).   You may now attempt to apply a procedure to multiple layers at once using the new All Layers option, if available for a particular procedure (usually those having the The input drawables argument). Note that a procedure may still fail even if this option is available as it may not support working with multiple layers at once.   Rename procedure: Added a new field named [output folder] that allows inserting the output folder selected in the plug-in dialog. You can adjust the path components to be inserted as well as the separator and wrapper around each component (in the same vein as [layer path]).   Rename procedure: Added %n option to the [layer name] and [layer path] fields acting as the inverse of %i.   Changes to procedures and constraints:     Removed the Selected in preview constraint. For Export Layers and Edit Layers, the Selected in GIMP and With color tags constraints already provide a good equivalent.   Rename procedure: For the [attributes] field, changed the layer attributes from %w, %h, %x and %y to %lw, %lh, %lx and %ly, respectively.   User interface changes:     Increased the width of the procedure browser so that there is more space to display labels for layer effects without the labels spanning too many lines.   Added a small delay to the image preview when the selected item changes. This prevents excessive changes when the selection changes rapidly.   Optimized the update of input items (when items are added/removed/renamed/updated upon changing procedures or constraints) if many items (hundreds and more) are present.   For Export Layers and Edit Layers, moved the “Preview” label directly above the image thumbnail and added a label named “Input Layers” above the list of layers.   Simplified how the preview is created internally, removing steps such as downscaling or merging layers.   Bug fixes:     Fixed Export/Edit Selected Layers not working for group layers.   Fixed export for procedures manipulating image dimensions, selection and other image-wide attributes (such as script-fu-addborder, script-fu-circuit or conversion to the indexed type).   Fixed occasional artifacts in the preview.   Fixed the preview not working correctly for group layers.   Fixed constraints incorrectly excluding items in the preview. The bug caused items e.g. matching the Matching File Extension constraint to be excluded from the preview as its name may have changed during processing.   Fixed occasional incorrect names in the preview under the image thumbnail.   Fixed the Rename procedure renaming folders after items if Rename folders is enabled.   Fixed the Rename procedure assigning incorrect descending numbers if Rename folders is enabled.   Fixed a crash on plug-in startup if a file format is no longer available.   Fixed loading settings related to layers (e.g. layers selected in the preview) whose names contain /.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/0.8-released/",
        "teaser": null
      },{
        "title": "Batcher 0.8.1 Released",
        "excerpt":"  User interface changes:     Dialogs for editing procedures, constraints and export settings are now scrollable if exceeding a certain height. Some custom procedures (e.g. gegl:styles) and file formats (e.g. DDS) have a large number of parameters, which previously made the dialogs too high to fit the screen.   Increased the minimum width of labels in dialogs. This makes particularly the procedure browser dialog more readable.   Bug fixes:     Fixed visually unappealing borders in the custom procedure browser appearing when switching to a procedure requiring scrolling.   For Export Layers, fixed the wrong name for the Cancel/Close button on plug-in startup if Close When Done is unchecked.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/0.8.1-released/",
        "teaser": null
      },{
        "title": "Batcher 0.8.2 Released",
        "excerpt":"     Fixed GIMP plug-ins being displayed in the wrong category in the custom procedure browser.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/0.8.2-released/",
        "teaser": null
      },{
        "title": "Batcher 1.0-RC1 Released",
        "excerpt":"  New major feature: Batch conversion of files. You can now batch-process image files and convert them to a different file format, optionally applying procedures (scale, insert background, …) and filtering the list of images to be processed via constraints (filenames having a particular file extension, beginning/ending with a prefix/suffix, …).   Changes to procedures and constraints:     Added a new procedure named Align and offset that allows aligning layer(s) with the image or another layer. You may also apply offsets with pixels or a percentage of image/layer width/height.   For the Scale procedure, you may now choose whether to scale a layer (the default for Export Layers and Edit Layers) or the entire image (a new option, the default for Batch Convert).   Renamed Use layer size to Resize to layer size and allowed customizing the layer. You may now resize the background layer, foreground layer or all layers (the latter effectively resizing the image to fit all layers).   Added Merge filters as a built-in procedure that merges all visible filters (layer effects) in the specified layer. This is equivalent to adding the gimp-drawable-merge-filters procedure, only more convenient.   Added a new constraint named Matching text... that allows filtering items that start with, contain or end with the specified text. You may also specify a Python regular expression or perform case-insensitive matching. The name of the constraint automatically changes as you adjust its options.   The Use file extension in layer name option for the Export procedure now uses the original layer name. This way, you no longer need to specify the [full layer name] field just to preserve the file extension. This also allows using different name patterns that do not include the layer name (such as image[001]).   Procedures and constraints causing errors are now automatically deactivated. This avoids spamming the user with warning dialogs.   User interface changes:     Replaced the placeholder icon in the image preview when there is no selection.   Labels describing procedure/constraint parameters are now insensitive (grayed out) if their corresponding GUI elements are insensitive.   Export settings are now insensitive while exporting.   Other changes:     When running Batcher non-interactively, the settings-file parameter is now a string rather than a GFile object for convenience.   Bug fixes:     Fixed warnings issued by GIMP when adding or applying layer effects as custom procedures.   Fixed the Rename procedure not working for Edit Layers.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.0-RC1-released/",
        "teaser": null
      },{
        "title": "Batcher 1.0-RC2 Released",
        "excerpt":"  General changes:     Updated Batcher to work with GIMP 3.0.0-RC3. Due to backwards-incompatible changes, Batcher now requires GIMP 3.0.0-RC3 or later. Saved settings from previous versions will still work properly.   You can now choose None for image and layer arguments in custom procedures if a procedure allows omitting them.   More appropriate GUI is displayed for settings and procedure arguments representing files or folders. You can also choose to omit these arguments if a procedure allows omitting them.   For Gimp.Unit procedure arguments, the pixel and/or percentage units are not shown if a procedure is set to hide them.   Bug fixes:     Fixed settings from version 0.8 not being updated to 1.0-RC1 and later.   Fixed a potential bug where arrays of images, layers and other GIMP objects as procedure or constraint arguments could not be edited.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.0-RC2-released/",
        "teaser": null
      },{
        "title": "Batcher 1.0-RC3 Released",
        "excerpt":"     Fixed Batcher not working when installed in a folder with elevated privileges (e.g. the system plug-ins folder containing built-in GIMP plug-ins instead of the user-specific plug-ins folder).   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.0-RC3-released/",
        "teaser": null
      },{
        "title": "Batcher 1.0-RC4 Released",
        "excerpt":"  New major feature: Export of images opened in GIMP. You can perform image export via File → Export Images... or File → Export Images (Quick). As with other plug-in procedures, you may make use of procedures and constraints (such as “only images with unsaved changes”). Note that this feature exports images to another file format, i.e. it does not mass-save XCF images in their original locations.   General changes:     When exporting each image/layer individually, layers are no longer automatically merged into one. This allows preserving layers when exporting to a multi-layer format such as PSD.   Batch Convert is now guaranteed to be accessible in GIMP even if no image is opened.   Changes to procedures:     The Rename procedure is now automatically renamed based on the specified pattern (e.g. Rename to \"image[001]\").   Bug fixes:     Fixed a crash on startup for macOS installation packages.   Fixed a crash in non-interactive mode if the settings file is not specified.   Fixed a warning message displayed when exporting or editing layers of an imported (i.e. non-XCF) image.   Fixed console warnings when opening the custom procedure browser.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.0-RC4-released/",
        "teaser": null
      },{
        "title": "Batcher 1.0 Released",
        "excerpt":"  User interface changes:     Batch Convert: If a file is not found, an appropriate label will be displayed below the preview rather than a popup.   Native file dialogs are displayed, if possible, when opening/saving settings files or adding files/folders for Batch Convert.   Bug fixes:     Fixed update of settings from 1.0-RC1 to later versions.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.0-released/",
        "teaser": null
      },{
        "title": "Batcher 1.0.1 Released",
        "excerpt":"     Updated German translation (thanks to @ChrisLauinger77).   Fixed a bug that caused the same custom procedure added multiple times to be saved only once.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.0.1-released/",
        "teaser": null
      },{
        "title": "Batcher 1.0.2 Released",
        "excerpt":"     Added Dutch translation (thanks to @DiGro).   Updated German translation (thanks to @ChrisLauinger77).   Fixed a crash when saving Export/Also export as... procedures (#37).   Fixed a crash on startup if the Pictures user folder as the default folder is not available (#41).   Fixed several typos in translatable strings.   Updated installation instructions for Flatpak users.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.0.2-released/",
        "teaser": null
      },{
        "title": "Batcher 1.1 Released",
        "excerpt":"  General changes:     Added Japanese translation (thanks to @re-unknown).   Added Spanish translation (thanks to @ikizgz).   Updated Dutch translation (thanks to @DiGro).   “Procedures” are now referred to as “actions”. “Action” is more intuitive.   “Constraints” are now referred to as “conditions”. “Condition” is more intuitive.   In Edit Layers, actions are no longer applied to copies of group layers (inserted as regular layers), but rather to their original counterparts. This was previously done to avoid plug-ins failing on group layers. However, many plug-ins in GIMP 3 were removed in place of layer effects (filters) achieving the same result, the latter of which can be applied on group layers. Thus, there is little need to work on group layer copies now. This change also fixes a bug where creating a layer copy would create extra entries in the undo history.   New features:     New major feature: Batch-editing and saving images opened in GIMP as XCF, available in File -&gt; Edit and Save Images and File -&gt; Edit and Save Images (Quick). Existing GIMP images are saved to their respective locations, while new images are saved to the specified output folder.   Added a new action named Color correction. You can adjust brightness, contrast, or apply levels or curves from a saved preset file. Both GIMP and Photoshop formats (.alv, .acv) for preset files are supported.   Added a new action named Crop. You may crop the entire image or a layer in a variety of ways - cropping from edges, from a fixed position (top left, center, …), to the specified aspect ratio, to the specified area (bounding box), or to remove empty borders.   Replaced Resize to layer size with a more generic action named Resize canvas that allows several more resize modes (add borders, resize from position/area, resize to aspect ratio, resize to image size) and filling the newly added space with a color.   Added a new action named Rotate and flip. You may rotate the entire image or a layer, along with several options such as the angle, or whether to rotate from the center or from a fixed point.   Added a new condition named XCF (native GIMP) file that applies only to opened images associated with a native XCF file.   Added a new condition named Not XCF (native GIMP) file acting as the inverse of XCF (native GIMP) file.   Changes to the user interface:     Batch Convert: Changed Add Files... and Add Folders... to menu entries displayed when clicking the new Add... button. Likewise, Remove Selected and Remove All were moved under the new Remove... button.   Batch Convert: Increased the initial preview height.   If the output directory no longer exists and Batcher is started, the output directory is set to the Pictures folder (or another folder that is guaranteed to exist). Previously, “(None)” was displayed, which was confusing.   Increased the default size of the main dialog.   Increased the default size of the preview. For historical reasons, the preview was kept small to be consistent with the GIMP’s Export menu. However, given that Batcher allows applying arbitrary filters, inspecting changes in a small preview can be difficult and the user is forced to manually resize the preview (this also assumes that the user is aware the preview size can be changed).   Changes to actions and conditions:     You can now apply actions to layers inserted by actions other than Insert background or Insert foreground, e.g. gimp-text-font (which renders a text layer), by selecting Layer Below (Background) or Layer Above (Foreground) (depending on whether the layer is inserted before or after the current layer).   Renamed Background Layer to Layer Below (Background) and Foreground Layer to Layer Above (Foreground) to make this feature more discoverable as per the change above.   Scale:            Merged Object to scale, Image and Layer to a single widget.       Units for width and height are moved next to the width and height widgets, respectively.       More units beside pixels and percentages can be chosen from (the same ones available in GIMP). These units are recalculated automatically.       Switching between pixels, percentages and other units will now restore the last value for that unit.       Merged Scale to fit, Keep aspect ratio and Dimension to keep to a single widget.       Added a new option Fit with padding under Aspect ratio that fits the image/layer to the specified dimensions and fills the empty space with the specified color (transparent by default).       Added a new option to change the image resolution.           Align and offset:            Merged Another layer to align layers with into Object to align layers with.       Units for x- and y-offsets are moved next to the x- and y-offset widgets, respectively.       More units beside pixels and percentages can be chosen from (the same ones available in GIMP). These units are recalculated automatically.           Rename: Removed the Rename images option in Export Images due to being redundant there.   Matching text...: Added Does not start with text, Does not contain text and Does not end with text options.   Edit Layers: The Selected in GIMP condition is now added on the first run/after reset.   File arguments can now be cleared (set to an empty value). This is useful if an action allows omitting a file.   Bug fixes:     Fixed preview and export of images with linear precision.   Fixed the Scale action always considering the layer size when keeping aspect ratio or scaling to fit dimensions.   Fixed the output folder button not filling the empty space when increasing the dialog width.   Fixed warnings when exporting layers or images opened in GIMP that are not native GIMP images (XCF).   Fixed a crash when adding a layer effect (GEGL operation) whose name contains / or . (#74).   Fixed URL to the Batcher user guide via the Help button (#73).   Fixed a crash when running Batch Convert non-interactively if the path to the text files containing inputs is not specified.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.1-released/",
        "teaser": null
      },{
        "title": "Batcher 1.1.1 Released",
        "excerpt":"     Fixed the former Resize to layer size action being incorrectly updated when upgrading Batcher to 1.1.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.1.1-released/",
        "teaser": null
      },{
        "title": "Batcher 1.2 Released",
        "excerpt":"  This release includes quality-of-life improvements, particularly to the user interface, and resolves most issues reported since the previous version.   General changes:     Added Brazilian Portuguese translation (thanks to @romrocha333).   Added Korean translation (thanks to @Maguk-Bong).   Added Polish translation (thanks to @jghosting764).   Updated Dutch translation (thanks to @DiGro).   Updated German translation (thanks to @ChrisLauinger77).   Updated Japanese translation (thanks to @re-unknown).   Removed filters (layer effects, GEGL operations) that were either redundant or had no effect. If you used these filters, they will be automatically removed (a warning message will appear, including a suggestion for an alternative filter if available).   Batch Convert: Loaded images will now have their orientation automatically corrected based on the Exif metadata if present.   Layers will now (again) be automatically merged before export to avoid exported images unexpectedly growing beyond their original boundaries. This can happen if layers contain filters (layer effects). You can switch this off by unchecking the new Merge visible layers and rasterize export option (#115).   Changed the order of buttons in the dialog handling conflicting files for safety, with the most dangerous choice (replacing an existing file) now being the rightmost one.   Adjusted installation instructions for macOS where the GIMP Preferences are located under a different menu.   If you use the latest revision of Batcher (i.e. download the source code rather than the release package), you will no longer receive errors when updating the plug-in to the latest revision.   New features:     Batch Convert: You can now adjust file format options when loading input files via the new Import Options... entry. Import options for file formats not recognized by Batcher (e.g. third-party file format plug-ins) cannot be adjusted and defaults will be used instead.   Added support for new features introduced between GIMP 3.1.2 and 3.2-RC2, including new file import/export formats, vector layers and link layers.   Batch Convert: You can now choose to export images to the same top-level folder as the input image using the new Match input folders option. You will be warned when choosing this option as you may permanently override the original images (#75).   Batch Convert, Export Images, Export Layers: The most recently used output folders for processing are now saved (max. 5). Each Batcher menu keeps a separate list of recent folders (#77).   Export Layers, Edit Layers: Replaced Apply opacity from group layers with a more generic Apply Group Layer Appearance, which now also applies layer effects, mode, masks and several other attributes (except color tags and locks) (#87).   Added an export option named Rotate or flip image based on Exif metadata. This allows correcting the orientation of images with Exif metadata before export if you choose to not save Exif metadata, e.g. for the JPEG format (#91).   Added filters (layer effects, GEGL operations) starting with gimp: as custom actions. For GIMP 3.1.4 and later, all of these filters are added. For GIMP 3.1.2 and below, only the following filters are added (others are unsupported or cause GIMP to crash): gimp:border, gimp:colorize, gimp:compose-crop, gimp:desaturate, gimp:flood, gimp:grow, gimp:posterize, gimp:scalar-multiply, gimp:semi-flatten, gimp:set-alpha, gimp:shrink, gimp:threshold, gimp:threshold-alpha (#85).   If G’MIC is installed as a GIMP plug-in, a built-in action G'MIC Filter will now be available that simplifies applying a filter from G’MIC non-interactively (#98).   If an action causes an error during processing or if a file does not exist, you may choose to skip the current image/layer and continue processing subsequent images/layers. This can be enabled permanently via Settings → Continue on Error. If you use Batcher non-interactively and you have a previous version of Batcher installed, you must remove Batcher, restart GIMP, install Batcher and restart GIMP again in order for the continue-on-error argument to be usable (#21).   Batch Convert: You can now move around individual files or folders by dragging and dropping them anywhere within the input list, or by pressing Alt + Up/Down. This is useful if, for example, you intend to rename the images with a numbered sequence.   Batch Convert: Files and folders can now be sorted by several criteria: original name, new name, creation date, modification date and file size. By default, sorting is performed in the ascending order, folders are always placed first and name-based sorting is case-sensitive. All these options can be switched off/on as needed.   You can now view message logs recorded during processing via Settings → View Logs and save them to a file.   User interface changes:     Export settings are now arranged vertically in the upper left part of the dialog. Clarified labels describing the settings.   Batch Convert: Buttons for adding and removing files and folders are moved to the top and changed them to icons.   The Show Original Names button shown in Batch Convert is now available for all plug-in procedures among the options at the top of the input list.   Replaced labels for action and condition parameters and export options with shorter text, just like in filter/plug-in dialogs in GIMP. A label for a parameter now contains the parameter name instead of the (often lengthy) description. The description is now included in the parameter tooltip, if available.   Adjusted the default size of the main dialog and its individual parts for each plug-in procedure.   Adjusted widths of action/condition argument names to avoid extra empty vertical space (most notably in the Export Options dialog).   Reduced the width of the quick dialogs given the vertical rearrangement of the export settings.   The message area at the bottom now only spans the left part of the dialog to make more room for the preview. Also, the message area no longer takes empty space if no message is displayed.   Error message dialogs issued by GIMP are now always redirected to the GIMP’s error console (https://docs.gimp.org/en/gimp-errors-dialog.html). This avoids spamming the same dialog when attempting to close the dialog and focusing back on the Batcher main dialog (#107).   Batch Convert: When loading a file fails (e.g. due to an unrecognized file format), the text below the preview now shows the message. You may still obtain warnings issued by GIMP (in the error console).   Batch Convert: Each row now displays the full path of an input image/folder as a tooltip.   Improved visual cues when reordering actions, conditions or array argument elements via drag-and-drop.   A simple summary message indicating the number of successfully processed images/layers is now displayed after the processing.   Marked names of common layer effect arguments as translatable.   The Export Options dialog is now closed before the start of processing.   Replaced the widget for choosing output folder with a custom widget. The folders previously available (such as the home user folder, disk drives, …) are no longer available.   Adjusted wording and icon in the dialog handling conflicting files for clarity.   An info icon is now displayed for skipped actions for clarity (e.g. actions trying to use foreground layers when there are none).   Changes to the custom action browser:            Adjusted the default width of the dialog and its individual parts.       Merged the Menu Name column into the Name column. The browser now only displays the menu name if available, or the internal name otherwise. If the menu name is available, the internal name is displayed for the currently selected action with a smaller font.       You can now search by multiple words. At least one matching word will yield a match. Whitespace characters are no longer considered when finding search results.       When searching and the first match is under a collapsed category, that category is expanded automatically.       Categories with no matching search results are now hidden.       Several minor UI tweaks (such as different expander arrow icons to be consistent with the GIMP plug-in browser, or the Add button being insensitive when no action is selected).       Optimized search and expanding/collapsing categories.       The expanded/collapsed state of each category is now preserved when saving/loading settings.       For GIMP 3.1.2 and below, moved the following filters under the Other category as there are alternative filters/plug-ins available in GIMP: gegl:gray, gegl:posterize, gegl:threshold, gegl:wavelet-blur.       For GIMP 3.1.4 and above, moved the following filters under the Other category as there are alternative filters available in GIMP: gegl:brightness-contrast, gegl:levels. These are not removed in case they are being used.           Changes to actions and conditions:     For filters that can only be applied destructively, Merge filter will always be checked and cannot be changed (#43).   Actions and conditions are now organized in submenus and have a fixed position in the submenus for easier navigation.   Actions and conditions will now display their description (if available) as a tooltip.   Changed names of built-in actions and conditions to title case for consistency with GIMP tools, plug-ins and filters.   Color Correction:            Split into separate actions and organized under the Color menu.       Reduced the range of allowed brightness and contrast values. The value range is now scaled to -127 to 127 for consistency with GIMP.       For GIMP 3.1.4 and later, you can choose a different filter responsible for adjusting brightness and contrast values. The default filter for GIMP 3.1.4 and later is equivalent to the Brightness-Contrast tool in GIMP. For earlier versions, gegl:brightness-contrast is the default (and the only option).       GIMP presets for levels or curves in modes other than the linear mode are no longer supported and yield a warning message. This avoids unexpected results as Batcher currently always applies the presets as if they were saved in the linear mode.       Added White Balance action equivalent to Colors → Auto → White Balance in GIMP (#85).           Rotate and Flip:            Split into separate actions - Flip Horizontally, Flip Vertically and Rotate.       The default angle for Rotate is now 90 degrees. Removed the None option.       Arguments not applicable are now hidden rather than made insensitive to reduce clutter.       Renamed arguments for brevity.           Save: Replaced Save existing XCF image to its original location with a folder chooser. This allows saving existing XCF images and new + non-XCF images to different folders if need be.   Plug-in procedures added by Batcher (e.g. plug-in-batch-export-layers) are not enabled in previews by default to avoid undesired file export or edits of existing images/layers.   Bug fixes:     Fixed Layer Below (Background) and Layer Above (Foreground) not working for Batch Convert, Export Images and Edit and Save Images.   In the custom action browser, fixed freezing frequently followed by a crash while typing a search query, which rendered the search almost unusable.   Fixed a crash when running Batch Convert non-interactively for AppImage installations (#101).   Fixed a crash when a widget used for choosing files or folders is not valid (#116).   Export Layers: Fixed incorrect image filenames when the [image name] field was used for non-XCF images (#108).   Fixed the popup containing action/condition details not appearing upon clicking the corresponding icon button in the custom action browser or the action/condition edit dialog.   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.2-released/",
        "teaser": null
      },{
        "title": "Batcher 1.2.1 Released",
        "excerpt":"     Updated translations: Dutch, German. Thanks to @DiGro and @ChrisLauinger77!   In the rare event that a folder with the same name exists during export, the overwrite dialog will no longer display the Replace this file option as it was causing an error. While the file to be exported could in theory replace the folder by removing the folder and its contents, this would likely not be anticipated by the user, rendering this choice unsafe. If Apply this choice to all remaining files is checked or processing is performed non-interactively, the Rename new file is used instead (but only if a folder exists rather than a file).   Fixed a crash when opening the custom action browser when certain custom layer effects are installed (#127).   Download at GitHub  ","categories": ["news"],
        "tags": [],
        "url": "/batcher/news/1.2.1-released/",
        "teaser": null
      },{
    "title": "Actions",
    "excerpt":"Actions allow you to apply image filters to each image/layer. Press the Add Action... button and select one of the available actions, or add a custom action.   For each action, you may:     enable/disable the action,   move the action up/down by dragging the action with mouse or by pressing Alt + Up/Down on your keyboard,   edit the action,   remove the action.   You can add the same action multiple times.   Built-in Actions   File and Naming   Rename   Renames images/layers according to the specified pattern.   This action uses the same text entry as the one in Batch Convert or Export Layers next to Filename, described in Renaming.   Additionally, this action allows customizing whether to rename both images/layers and folders (by checking Rename folders/Rename group layers) or rename folders only (by checking Rename folders/Rename group layers and unchecking Rename images/Rename layers).   For Batch Convert and Export Layers, this action performs renaming on top of the entry next to Filename.   For Edit and Save Images, renaming will have no effect unless the images are saved via the Save action.   Remove file extension from imported images   Only available for: Edit and Save Images   Removes the file extension from images opened in GIMP that were imported from a non-native file format (i.e. not XCF). Native XCF files and new images are kept intact.   Remove Folder Structure   Only available for: Batch Convert, Export Layers, Edit Layers   Exports all images to the output folder on the same level, i.e. subfolders are not created.   Options:     (Edit Layers only) Consider visibility of parent folders: If checked, a layer will become invisible if any of its parents are not visible (even if the layer itself is visible). Having this checked corresponds to how the layers are displayed in the image canvas.   Export/Also Export As…   Exports an image/layer to the specified file format.   For Batch Convert and Export Layers, this performs export to another file format.   You can add this action multiple times to export to multiple file formats at once.   Options:     Output folder: Folder to export the output image(s) to.   File extension: File extension of the output image(s).   All options specified in Export Options.   The name of the Export action is automatically updated as you modify the file extension.   For Batch Convert and Export Layers, when this action is added, the values of the options are copied from the default export options. For example, the output folder will be identical to the one currently selected in the main dialog. This simplifies setting up export to multiple file formats without the hassle of manually adjusting the export options in all added actions.   When exporting each image separately (the default, which can be changed via the Perform export option), it usually makes sense to apply the Export action as the last one since actions after Export would have no effect on the current image/layer being processed.   Save   Only available for: Edit and Save Images   Saves the images in the native GIMP (XCF) file format.   If the image already exists, it is overwritten.   Images that were imported or created within GIMP are renamed in the GIMP title bar to contain the .xcf file extension. The images are marked as having no unsaved changes.   To export the image in another file format, use the “Export Images” menu.   Options:     Output folder: Folder to save images to. By default, existing XCF images are saved to their original locations (the Use original location (override) option). You may instead specify a folder where all images will be saved, including new and non-XCF images.   Output folder for new and imported images: Folder where new images or non-XCF images are saved as XCF images.   Resize and Transform   Scale   Scales (resizes) the entire image or a layer.   Options:     Apply to (image or layer): Whether to scale the current image, current layer, or other objects (e.g. background/foreground).   New width: The new width, specified using an absolute unit (pixels, inches, …) or a percentage (of width of the current image, layer, …).   New height: The new height, specified using an absolute unit (pixels, inches, …) or a percentage (of width of the current image, layer, …).   Aspect ratio: Affects how scaling is performed, either preserving or ignoring the aspect ratio.            None (Stretch): The aspect ratio is ignored (i.e. the image/layer is stretched).       Keep, adjust width: The aspect ratio is preserved. You may adjust the width, while the height is calculated automatically.       Keep, adjust height: The aspect ratio is preserved. You may adjust the height, while the width is calculated automatically.       Fit: The aspect ratio is preserved. The image/layer will be scaled such that it fits New width or New height, whichever is smaller.       Fit with padding: The aspect ratio is preserved. The image/layer will be scaled such that it fits New width and New height, and any remaining empty space is filled with the specified padding color. You can customize where the padding is positioned relative to the image/layer (from the start, center, end or from a custom starting position).           Interpolation: Type of interpolation to use.   Use local origin: If checked and the object to scale is a layer, it will be scaled around its center. If not checked, the layer will be placed in the upper left corner of the image.   Set image resolution in DPI: Whether to set a new resolution for the current image.   X and Y: The new image resolution in DPI. Only applicable if Set image resolution in DPI is checked.   Resize Canvas   Resizes the image or layer extents, i.e. adds empty space from the edges. There are multiple ways you can perform resizing based on your needs. You may optionally fill the added space with a color.   Note that this action does not upscale/downscale the image/layer. For that purpose, use the Scale action.   Options:     How to resize:            Resize from edges (add borders): Adds the specified amount at each edge. The amount can be specified in a variety of units (pixels, percentages, inches, …). You can also remove content by specifying negative values.       Resize from position: Resizes to the specified width and height from the specified position, e.g. starting from the upper left corner, from the center, etc.       Resize to aspect ratio: Resizes to the specified aspect ratio (width:height), e.g. to 4:3 or 16:9 or any ratio of your choice. You can customize where the resizing starts (from the start, center, end or from a custom starting position).       Resize to area: Resizes to the area specified by offsets, width and height.       Resize to layer size: Resizes the image/layer to fit the specified layer(s).       Resize to image size: Resizes the image/layer to fit the specified image.           Fill added space with color: If checked the newly added space will be filled with the color specified by Color for added space.   Color for added space: The color to fill the newly added space with. If the image is resized, the currently processed layer is resized as well and is filled with this color.   For Export Layers, the Resize to layer size option is enabled by default. This means that the exported image will have the same dimensions as the layer to export. To keep the image canvas intact (thus keeping the layer position within the image), uncheck this action. Note that in that case the layers will be cut off if they are partially outside the image canvas.   Crop   Crops the specified image or layer. There are multiple ways you can perform cropping based on your needs.   Options:     How to crop:            Crop from edges: Removes the specified amount from each edge. The amount can be specified in a variety of units (pixels, percentages, inches, …).       Crop from position: Crops to the specified width and height from the specified position, e.g. starting from the upper left corner, from the center, etc.       Crop to aspect ratio: Crops to the specified aspect ratio (width:height), e.g. to 4:3 or 16:9 or any ratio of your choice. You can customize where the cropping starts (from the start, center, end or from a custom starting position).       Crop to area: Crops to the area bounded by the starting position (X, Y), width and height.       Remove empty borders: Automatically removes empty areas along the edges of the image/layer.           Align and Offset   Aligns layer(s) with the current image or another layer. You may specify additional offsets after the alignment is applied.   Options:     Layers to align: Layers to align. This can be a single layer (e.g. the current layer, background, foreground) or all layers inserted in the currently processed image.   Object to align layers with: Whether to align with the entire image or another layer.   Horizontal alignment: Left, center or right alignment, or Keep the horizontal position intact.   Vertical alignment: Top, center or bottom alignment, or Keep the vertical position intact.   Additional X-offset: Moves the layers horizontally by the specified amount, using an absolute unit (pixels, inches, …) or a percentage (of width of the current image, layer, …).   Additional Y-offset: Moves the layers vertically by the specified amount, using an absolute unit (pixels, inches, …) or a percentage (of width of the current image, layer, …).   Flip Horizontally   Flips the current image or layer horizontally around its center.   Flip Vertically   Flips the current image or layer vertically around its center.   Rotate   Rotates the current image or layer.   Options:     Apply to (image or layer): Whether to rotate the current image, current layer, or other objects (e.g. background/foreground).   Angle: Rotate by 90, 180 or 270 degrees, or use a Custom angle.   Custom angle: Rotation angle in degrees or radians. Applies only if Angle is set to Custom. If the custom angle is used on the image rather than a layer, all layers within the image are rotated around the image’s center.   How to handle boundaries: How to handle the extents of layers after rotation - resize the layer, clip or crop. If rotation is applied to an image, all layers are handled the same way. Note that resized layers will not cause the image to grow; to achieve that, add the Resize Canvas action and use Resize to layer size.   Interpolation: Interpolation for rotated layers. Has effect only if Angle is set to Custom.   Rotate around the center: If checked, the layer is rotated around their center.   Horizontal position of center: The X-coordinate of the point around which the layer is rotated. Applies only if Rotate around the center is unchecked.   Vertical position of center: The Y-coordinate of the point around which the layer is rotated. Applies only if Rotate around the center is unchecked.   Layers and Composition   Insert Background   Inserts a new layer behind the current layer.   For Batch Convert, specify an image file to be loaded as background.   For Export Layers and Edit Layers, mark layers in your opened image with a color tag. The blue color tag is used for background by default. You may set a different color tag by adjusting the Color tag option.   This action is inserted at the first position. This prevents potential confusion when other actions are applied that could affect the image/layer extents (e.g. Resize to layer size in Export Layers). You can always move this action lower as needed.   You can apply subsequent actions on the background using Layer Below (Background) instead of Current Layer (if available).   The background is merged automatically at the end of processing as the Merge Background action is automatically added. See Merge Background below for more information.   For Export Layers and Edit Layers, the background layers are excluded from processing by default as the Not Background condition is automatically added and enabled.   Insert Foreground   Inserts a new layer in front of the current layer.   For Export Layers and Edit Layers, the green color tag is used as foreground by default.   You can apply subsequent actions on the foreground using Layer Above (Foreground) instead of Current Layer (if available).   The Merge Foreground action is added automatically. For Export Layers and Edit Layers, the Not Foreground condition is added automatically.   For more information, see Insert Background above.   Merge Background   Only available if Insert Background is added   Merges already inserted background (via Insert Background, see above) into the current layer.   When exporting, the background is merged automatically. However, if needed, you can reorder this action to perform the merge earlier and then apply actions on the current layer, now merged with the background.   For Edit Layers, this action ensures that you have a single merged layer rather than having the background as a separate layer. If this is not what you desire, you may uncheck this action.   If there is no background layer inserted, this action has no effect.   Options:     Merge type: Indicates how to perform the merge. The available merge types are the same as for Merge Visible Layers, under the section Final, Merged Layer should be:.   Merge Foreground   Only available if Insert Foreground is added   Merges already inserted foreground (via Insert Foreground, see above) with the current layer.   For more information, see Merge Background above.   Apply Group Layer Appearance   Only available for: Export Layers, Edit Layers   Applies attributes (filters, opacity, mode, …) from all parent group layers to the current layer to match its appearance in GIMP.   You can switch off individual attributes to customize the appearance.   If Merge groups with layer is enabled, the groups are merged into the layer. Otherwise, the current layer is turned into a group layer. Subsequent actions may in that case fail if they attempt to perform operations not allowed on group layers, e.g. applying layer effects destructively.   Merge Filters   Merges all visible filters (layer effects) in the specified layer.   Merge Visible Layers   Only available for: Batch Convert, Export Images, Edit and Save Images   Merges all visible layers within the image into a single layer. Invisible layers are removed.   This is useful if the image contains multiple layers and you want to apply filters (layer effects) or other actions on the entire image.   Color   Brightness-Contrast   Adjusts brightness and contrast.   For GIMP 3.2 and later, you can choose between two different filters responsible for adjusting brightness and contrast: GEGL (uses the gegl:brightness-contrast filter) and GIMP (uses the gimp:brightness-contrast filter).   Levels   Applies levels from a saved preset file. Both GIMP and Photoshop (.alv) file formats are supported.   You can save a GIMP preset file by choosing Export Current Settings to File in the Levels tool.   At the moment, Batcher only supports preset files saved in the linear mode. If you saved your preset in a different mode (e.g. non-linear, perceptual), the action will fail with a warning dialog.   Curves   Applies curves from a saved preset file. Both GIMP and Photoshop (.acv) file formats are supported.   You can save a GIMP preset file by choosing Export Current Settings to File in the Curves tool.   At the moment, Batcher only supports preset files saved in the linear mode. If you saved your preset in a different mode (e.g. non-linear, perceptual), the action will fail with a warning dialog.   White Balance   Equivalent to Colors → Auto → White Balance in GIMP.   G’MIC Filter   Only available if G’MIC is installed as a GIMP plug-in   Applies a G’MIC filter non-interactively.   To apply a filter, select a filter in G’MIC and press Ctrl+C, or click the copy button. Then paste the text into the Command text field.   Adding Custom Actions   You can add any GIMP plug-in, layer effect (filter, GEGL operation) or GIMP action by pressing Add Action... and then selecting Add Custom Action.... Both built-in and any third-party plug-ins and layer effects are supported.      You can preview how the selected action affects the resulting image (by pressing Preview) and adjust action options.   Once you are settled on the action, press Add to permanently add it to the list of actions. You can edit the action anytime after adding it.   All layer effects (actions under the Filters, Effects category) have the following common parameters:     Blend mode - blend mode for the effect (default, dodge, burn, hard light, …).   Opacity - the opacity of the effect.   Merge filter - the effect will be applied destructively, i.e. will be merged into the layer.   Visible (displayed under More options) - if unchecked, the effect will be added, but will not be applied.   Filter name (displayed under More options) - a custom name for the effect. If empty, a default name is assigned by GIMP.  ","url": "http://localhost:4000/batcher/docs/actions/"
  },{
    "title": "Conditions",
    "excerpt":"To exclude certain images/layers from processing and export, press the Add Condition... button and select one of the available conditions.   Just like actions, you may enable/disable, reorder, edit or remove conditions.   Built-in Conditions   Layer   Layers   Only available for: Export Layers, Edit Layers   Processes only layers (i.e. group layers are not processed).   Group Layers   Only available for: Export Layers, Edit Layers   Processes only group layers.   You need to disable the Layers condition since having both enabled will result in no layer being processed.   Visible   Only available for: Export Layers, Edit Layers   Processes only visible layers.   Selected in GIMP   Only available for: Export Layers, Edit Layers   Processes only layers selected in GIMP.   With Color Tags   Only available for: Export Layers, Edit Layers   Processes only layers having a color tag.   By default, all layers without a color tag are excluded. To process only layers with specific color tags, edit this condition and add the color tags for the Color tags option. For example, by adding a blue tag, only layers containing the blue tag will be processed. Other tagged or untagged layers will be excluded.   Without Color Tags   Only available for: Export Layers, Edit Layers   Processes only layers without a color tag.   By default, all layers with a color tag are excluded. To exclude only specific color tags, edit this condition and add the color tags for the Color tags option. For example, by adding a blue tag, all layers except the ones containing the blue tag will be processed.   If a group layer has a color tag, it will normally not be excluded. To also exclude group layers with color tags, click on More options and check Also apply to parent folders.   Not Background   Only available for: Export Layers, Edit Layers   Only available if Insert Background is added   Processes only layers that are not inserted as background via Insert Background.   Not Foreground   Only available for: Export Layers, Edit Layers   Only available if Insert Foreground is added   Processes only layers that are not inserted as foreground via Insert Foreground.   Naming   Matching Text…   Processes only images/layers whose names match the specified text.   You can adjust how to perform matching - whether the image/layer name should start with, contain or end with the specified text to match. For example, with the “Ends with text” option, you can match against an arbitrary file extension instead of the one typed in the main dialog (via the Matching File Extension condition).   Matching can be made case-insensitive by checking the Ignore case sensitivity option.   You can also specify a regular expression pattern as defined in the re module for Python. Errors in the regular expression pattern will result in no matches.   Matching File Extension   Processes only images/layers whose names match the file extension typed in the main dialog.   Recognized File Format   Only available for: Batch Convert   Processes only images whose original file extension is supported by GIMP.   If you use third-party file load plug-ins with their own file extension, uncheck this condition so they can be processed.   File   Imported   Only available for: Export Images, Edit and Save Images   Processes only images imported from a non-native (XCF) file.   Not Imported   Only available for: Export Images, Edit and Save Images   Processes only images that are native (XCF) images or are unsaved images without a file.   Saved or Exported   Only available for: Export Images, Edit and Save Images   Processes only images that are saved as native (XCF) files or exported to another file format.   Not Saved or Exported   Only available for: Export Images, Edit and Save Images   Processes only images created in GIMP not yet saved to a file.   With Unsaved Changes   Only available for: Export Images, Edit and Save Images   Processes only images with unsaved changes (“dirty” images).   With No Unsaved Changes   Only available for: Export Images, Edit and Save Images   Processes only images with no unsaved changes (“clean” images).   XCF (Native GIMP) File   Only available for: Export Images, Edit and Save Images   Processes only images associated with an XCF file.   Not XCF (Native GIMP) File   Only available for: Export Images, Edit and Save Images   Processes only images not associated with an XCF file. This includes imported images or new images created in GIMP.   Top-Level   Only available for: Batch Convert, Export Layers, Edit Layers   Processes only top-level images/layers (i.e. images/layers inside any folder/group layer are excluded).  ","url": "http://localhost:4000/batcher/docs/conditions/"
  },{
    "title": "Customization",
    "excerpt":"Beyond the basic features, Batcher allows you to:     adjust image/layer names,   apply actions to each image/layer (scale down, insert background, layer effects, GIMP plug-ins, …) during batch processing,   filter image/layers by applying conditions (only filenames matching a suffix, only visible layers, …).   As the amount of customization may be overwhelming at first, you may want to take a look at a few examples to get started.  ","url": "http://localhost:4000/batcher/docs/customization/"
  },{
    "title": "Editing Actions and Conditions",
    "excerpt":"To edit an action or a condition, press the icon to the right of the action/condition name and adjust the options in the displayed dialog.   The dialog will be automatically displayed for most built-in actions and some built-in conditions when added.   Placeholder Values   If an action or condition contains an image or a layer argument, you will be offered to select a “placeholder” - a value that is determined during processing.   For image arguments, you may select one of the following:     Current Image (default): the currently processed image.   None: ignores the image. Only available if an action/condition allows omitting it (i.e. if the image is optional).   For layer/drawable/item arguments, you may select one of the following:     Current Layer (default): the currently processed layer. For Batch Convert, an input image usually contains a single layer, which will be considered the current layer. In case of multi-layer images, the first layer is considered, or the first selected layer if the stored image file contains information on the selected layers (e.g. XCF or PSD).   Layer Below (Background): a layer placed directly after Current Layer, representing background. This layer is inserted via the Insert Background action or by a custom action. If there is no such layer, the entire action/condition will be skipped.   Layer Above (Foreground): a layer placed directly before Current Layer, representing foreground. This layer is inserted via the Insert Foreground action or by a custom action (e.g. gimp-text-font which renders a text layer). If there is no such layer, the entire action/condition will be skipped.   None: ignores the layer. Only available if an action/condition allows omitting it (i.e. if the layer is optional).   All Layers: applies the action/condition to all layers within the currently processed image. This option is available usually only for actions/conditions having the The input drawables argument. Note that an action/condition may not work on multiple layers at once and thus may yield an error if this option is chosen.   For several built-in actions (such as Scale or Rotate), numeric arguments representing dimensions, coordinates, etc. can be specified in a variety of units, such as pixels, percentages (e.g. of width of the current image), inches and others. Percentages are converted to pixels. Inches and other units are converted to pixels based on the current image’s resolution (in case of Edit Layers and Export Layers, the image of the processed layer).   More Options   Expanding More options allows you to adjust the options below.   Enable for previews   If checked (the default), the action/condition is applied in the preview. Unchecking this can be useful if an action takes too long.   Also apply to parent folders   Only available for conditions   If checked, an image/layer will satisfy a condition if all of its parent folders/group layers also satisfy the condition. For example, if this option is checked for the Visible condition, a visible layer is excluded if any of its parent group layers are not visible.  ","url": "http://localhost:4000/batcher/docs/editing-actions-and-conditions/"
  },{
    "title": "Examples",
    "excerpt":"I don’t want to preserve folder hierarchy when exporting.   Add and check the Remove Folder Structure action if not already (Add Action... → Remove Folder Structure).   How do I rename the images to form a sequence of numbers, e.g. “image001”, “image002”, …?   Click on the text entry next to Filename and choose image001, or type image[001] in the entry.   I want to apply blurring to the image. Can this be done?   Absolutely! In fact, you may apply any GIMP filter or plug-in:     Select Add Action... → Add Custom Action...   In the action browser, type blur in the search bar and select one of the filters, such as Gaussian Blur.   Adjust the options as desired.   Select Add to add the action.   How can I insert watermarks?   You can think of watermarks as foreground, i.e. a layer added on top of your images.   For Batch Convert and Export Images:     Add the Insert Foreground action and specify an image file serving as the foreground.   (optional) You can adjust how the foreground is merged by setting the merge type in the Merge Foreground action that was added automatically.   For Export Layers and Edit Layers:     In GIMP, assign a color tag to the layer(s) you want to consider foreground (right-click on a layer → Color Tags → choose your color).   Add the Insert Foreground action and adjust the color tag as necessary.   (optional) For Export Layers, if you want the foreground to be offset to the current layer rather than the image canvas, place this action after Resize to layer size by dragging it onto Resize to layer size.   (optional) You can adjust how the foreground is merged by setting the merge type in the Merge Foreground action that was added automatically.   (optional) You can further adjust the watermark via subsequent actions (e.g. Rotate). Instead of Current Layer (if available), use Layer Above (Foreground).   I need every image to have the same background.   You can follow the same steps as in the example above, except that you add the Insert Background action (and adjust Merge Background as needed).   How can I add borders to an image?      Add the Resize Canvas action.   Set How to resize to Resize from edges (add borders) if not already.   Adjust the Amount (border thickness).   If you want the border to have a particular color, check Fill added space with color and adjust Color for added space as desired.   I want to create a single multipage PDF file.   While multipage PDF export is already possible in GIMP without any third-party plug-ins, Batcher allows you to apply custom actions before the export or export each folder/group layer as separate PDFs.      Select or type pdf as the file extension.   Press the Options... button and select an option in Perform export:. To export a single image, select As a single image.   If you selected As a single image, adjust Image filename pattern as seen fit.   For Export Layers, you may want to uncheck the Resize to layer size action to use the image size (since PDF pages have the same dimensions), otherwise you might obtain unexpected results.   I want to be able to export to multiple file formats at once.   You can achieve this by adding the Also Export As... (or Export) action.   Each time you add this action, adjust the file extension, file format options and other settings as needed.   I want to apply action(s) on image files (such as scaling), but I also want to export them using their original file format.      Press the Options... button and check Use original file extension.   Add and adjust your desired actions.   I want to export all layers using the image size, not the layer size.   Uncheck the Resize to layer size action if it exists.   I want to export only visible layers.   Check the Visible condition (or add one if not already via Add Condition... → Visible).   I want to export only visible layers. However, I also want to exclude those that have invisible parent group layers.      Check the Visible condition (or add one if not already).   Edit the Visible condition (press the icon to the right of the condition name). In the dialog, click on More options and then check Also apply to parent folders.   My layers contain a ‘.’. All characters after the ‘.’ are replaced with the file extension. How do I prevent this?   In the text entry next to Filename, choose Full layer name or type [layer name, %e]. This ensures that the resulting image name will be e.g. some.layer.png instead of some.png (the default behavior).   How do I export only group layers at the top level?      Uncheck the Layers condition.   Add the Group Layers condition.   Add the Top-Level condition.   How do I reverse the order of the exported images/layers?   In the text entry next to Filename, you can type e.g. image[000, %d]. This results in the exported image/layer names having a descending number.  ","url": "http://localhost:4000/batcher/docs/examples/"
  },{
    "title": "Export Options",
    "excerpt":"Export options are available upon pressing the Options... button (if available), or when adding the Export/Also Export As... action.      How to adjust file format options: If set to Interactively, a native file format dialog is displayed for the first image to be exported. If set to Use options below (the default), you can adjust file format options in place without showing a file format dialog.   File format options: A list of options specific to the file format typed in the main dialog.   If a file exists: If set to Ask (the default), the user is asked to choose how to handle existing files (replace, skip, rename, etc.). Setting this to a different value applies that mode to each file without asking the user (e.g. setting this to Replace will automatically replace all existing files with the same name).   Perform export: Whether to export each item separately (“For each image”/”For each layer”), each top-level item or folder separately (“For each top-level image or folder”/”For each top-level layer or group”), or a single image containing all items (“As a single image”). The latter two options provide multi-layer export. This allows exporting e.g. multipage PDFs or animated GIFs with additional custom actions applied before the export.   Image filename pattern: Filename pattern available when a single image is exported (the “Entire image at once” option is selected). The text entry next to Filename still applies to individual layer names (since some multi-layer file formats also store layer names, e.g. TIFF or PSD).   Use original file extension/Use file extension in layer name: If an image/layer name has a recognized file extension, use that file extension in place of the default file extension. Note that, currently, the only way to adjust file format options for each different file format is to set How to adjust file format options to Interactively.   Convert file extension to lowercase: File extensions in layer names are converted to lowercase.   Use original modification date (Batch Convert only): Preserves the original access and modification dates.   Rotate or flip image based on Exif metadata: If checked, images are rotated and/or flipped based on the orientation value in the Exif image metadata (if present). This is useful if you choose to not save Exif metadata on export and still wish to correct the image orientation. If this option is checked AND you also choose to save the Exif metadata (available only for a few file formats, such as JPEG), you will obtain unexpected results.   Merge visible layers and rasterize: If checked, layers in each image are merged into a single rasterized layer. Any filters (layer effects) are also merged. Vector layers are rasterized. This avoids surprising results as some filters may expand the image canvas. If you intend to export using a file format supporting layers and filters (such as XCF or PSD) or to a vector graphics format (such as SVG) and you want to preserve the layers/filters/vector graphics, uncheck this option.  ","url": "http://localhost:4000/batcher/docs/export-options/"
  },{
    "title": "Installation",
    "excerpt":"Requirements   Batcher requires GIMP 3.0.0 or later.   Download   Batcher can currently be installed only manually by copying files from a ZIP archive.   Download latest release (1.2.1, February 08, 2026)   Windows      If you downloaded GIMP 3 before March 19, 2025, you will need to update GIMP (or download and install GIMP again if GIMP does not offer an update). There was originally an issue that prevented several plug-ins, including Batcher, from working.   If you installed GIMP from gimp.org, make sure you enabled support for Python plug-ins (this is checked by default). The Microsoft Store version of GIMP enables Python support automatically.   Locate the folder containing GIMP plug-ins - open GIMP and go to Edit → Preferences → Folders → Plug-Ins. If you cannot locate any of the folders on your system, you can add a custom folder.   Copy the batcher folder from the downloaded archive to one of the folders chosen in the previous step. The folder hierarchy should look like this:      plug-ins/      ...other plug-in folders...      batcher/          ...other Batcher files and folders...          batcher.py           If you have GIMP opened, you must restart GIMP.   Linux   Flatpak      Copy the batcher folder from the downloaded archive to /home/&lt;your username&gt;/.config/GIMP/&lt;GIMP version&gt;/plug-ins, e.g. /home/username/.config/GIMP/3.0/plug-ins for GIMP 3.0.x versions. Create the folder if it does not exist. The folder hierarchy should look like this:      plug-ins/      ...other plug-in folders...      batcher/          ...other Batcher files and folders...          batcher.py           If you have GIMP opened, you must restart GIMP.   AppImage      Locate the folder containing GIMP plug-ins - open GIMP and go to Edit → Preferences → Folders → Plug-Ins. If you cannot locate any of the folders on your system, you can add a custom folder.   Copy the batcher folder from the downloaded archive to one of the folders chosen in the previous step. The folder hierarchy should look like this:      plug-ins/      ...other plug-in folders...      batcher/          ...other Batcher files and folders...          batcher.py           If you have GIMP opened, you must restart GIMP.   Snap   Currently not supported. 🥲 Any help providing a Snap package is appreciated.   Other installers or unofficial sources      If you installed GIMP and/or Batcher via a package manager, make sure the following dependencies are installed:            Python 3.7 or later       Pycairo library, i.e. Python bindings for the cairo library, including GObject bindings. For example, on Debian-based distributions, python3-gi-cairo is required.           Locate the folder containing GIMP plug-ins - open GIMP and go to Edit → Preferences → Folders → Plug-Ins. If you cannot locate any of the folders on your system, you can add a custom folder.   Copy the batcher folder from the downloaded archive to one of the folders chosen in the previous step. The folder hierarchy should look like this:      plug-ins/      ...other plug-in folders...      batcher/          ...other Batcher files and folders...          batcher.py           If you have GIMP opened, you must restart GIMP.   macOS      Locate the folder containing GIMP plug-ins - open GIMP and go to GIMP → Preferences (or Settings) → Folders → Plug-Ins. If you cannot locate any of the folders on your system, you can add a custom folder.   Copy the batcher folder from the downloaded archive to one of the folders chosen in the previous step. The folder hierarchy should look like this:      plug-ins/      ...other plug-in folders...      batcher/          ...other Batcher files and folders...          batcher.py           If you have GIMP opened, you must restart GIMP.  ","url": "http://localhost:4000/batcher/docs/installation/"
  },{
    "title": "Known Issues",
    "excerpt":"If the How to adjust file format options export option is set to Interactively, and you press the Export button, it may seem as though nothing happens. In that case, the file format dialog may be displayed behind GIMP. If so, select the dialog in the taskbar to bring it up.   For the Levels and Curves actions, Batcher currently supports applying preset files saved in the linear mode only. If you saved your preset in a different mode (e.g. non-linear or perceptual), the action will fail with a warning dialog.   For Batch Convert, import options for unrecognized file formats cannot be adjusted and default values will be used.   If some actions result in errors, notably layer effects, the error message provided by Batcher is rather generic or there is none. A more detailed error message, if any, can be displayed in GIMP via Windows → Dockable Dialogs → Error Console. In previous Batcher versions, these messages were displayed as separate popups - however, these popups were often displayed repeatedly and kept obscuring the Batcher dialog.   Images created by custom actions (e.g. via plug-in-decompose) are currently not usable in Batcher. This will be resolved in a future version.   If you run GIMP using the official AppImage, None will be displayed as an option for a Current Image/Current Layer parameter in an action, even if the parameter does not allow omitting an image/layer. This will be fixed in a future version of GIMP.   The C source and HTML file formats require displaying a file format dialog for each image to be exported. This will be fixed in a future version of GIMP.  ","url": "http://localhost:4000/batcher/docs/known-issues/"
  },{
    "title": "Renaming",
    "excerpt":"Batcher offers renaming each image/layer using several built-in fields. For example, image[001] renames the images/layers to image001, image002 and so on. You can combine multiple fields, for example [layer name]-[001].   Renaming is available via the text entry next to Filename or via the Rename action. Press the Down button or click anywhere on the entry to display the list of available fields. The text entry can show you examples of how each field is used if you place the text cursor inside a field (e.g. inside [001]).   The input list of images/layers automatically updates as you change the name pattern and so can greatly help you figure out how your specified pattern affects the image/layer names.   Fields must be enclosed in square brackets and must have a correct number of options. Options must be separated by commas (,). Invalid options result in the field being inserted literally.   Available fields   You can choose the fields from the dropdown list displayed when clicking on the text entry, or you can type the fields manually.   Number   A number incrementing for each image/layer. The numbering is separate for each folder/group layer.   Options:     %n: Continue numbering across folders/group layers.   %d&lt;number&gt;: Use descending numbers, optionally with the specified padding (number of digits). If the number is 0, the first number is the number of images/layers within a folder/group layer, or, if %n is also specified, the number of all images/layers.   Examples:     [1] → 1, 2, …   [001] → 001, 002, …, 009, 010, …, 999, 1000, …   [005] → 005, 006, …   [001, %n] → 001, 002, … (continues numbering across folders/group layers)   [000, %d] → 010, 009, … (if the number of images/layers is 10)   [10, %d2] → 10, 09, …   [image name]   The current image name.   Options:     file extension strip mode:            %e: Never strip the extension.       %i (Batch Convert only): Strip the extension only if the image has a file extension that does not match the entered file extension.       %n (Batch Convert only): Strip the extension only if the image has a file extension that matches the entered file extension (the inverse of %i).           Examples:     [image name] for an image named Frame → Frame   [layer name] for an image named Frame.png → Frame   [image name, %e] for an image named Frame.png if the file extension is png → Frame.png   [image name, %i] for an image named Frame.png if the file extension is png → Frame.png   [image name, %n] for an image named Frame.png if the file extension is png → Frame   [image name, %e] for an image named Frame.png if the file extension is jpg → Frame.jpg   [image name, %i] for an image named Frame.png if the file extension is jpg → Frame   [image name, %n] for an image named Frame.png if the file extension is jpg → Frame.jpg   [image path]   Only available for: Batch Convert   The “full path” of an image, from its topmost folder added as input to the image itself. This does not include folders above the folder added as input.   For example, if the folder named Body contains a subfolder named Hands which contains an image named Left, the image path will be Body-Hands-Left.   Options:     separator: A string separating the path components. Defaults to -.   wrapper: A string that wraps around each path component. The wrapper must contain %c denoting the path component. Defaults to %c.   file extension strip mode: See the \\[image name\\] field.   Examples:     [image path] → Body-Hands-Left   [image path, _] → Body_Hands_Left   [image path, _, (%c)] → (Body)_(Hands)_(Left)   [image path, _, (%c), %e] → Body-Hands-Left.png (if the image name is Left.png and the file extension is png)   If for the separator or the %c option you intend to use characters such as space, [ or ], these require special treatment.   [layer name]   Only available for: Export Layers, Edit Layers   The layer name.   Options:     file extension strip mode:            %e: Never strip the extension.       %i (does not apply to Edit Layers): Strip the extension only if the layer has a file extension that does not match the entered file extension.       %n (does not apply to Edit Layers): Strip the extension only if the layer has a file extension that matches the entered file extension (the inverse of %i).           Examples:     [layer name] for a layer named Frame → Frame   [layer name] for a layer named Frame.png → Frame   [layer name, %e] for a layer named Frame.png if the file extension is png → Frame.png   [layer name, %i] for a layer named Frame.png if the file extension is png → Frame.png   [layer name, %n] for a layer named Frame.png if the file extension is png → Frame   [layer name, %e] for a layer named Frame.png if the file extension is jpg → Frame.jpg   [layer name, %i] for a layer named Frame.png if the file extension is jpg → Frame   [layer name, %n] for a layer named Frame.png if the file extension is jpg → Frame.jpg   Full layer name   Only available for: Export Layers, Edit Layers   Equivalent to [layer name, %e].   [layer path]   Only available for: Export Layers, Edit Layers   The “full path” of a layer. For example, if the image has a group layer named Body containing a group layer named Hands containing a layer named Left, the layer path will be Body-Hands-Left.   Options:     separator: A string separating the path components. Defaults to -.   wrapper: A string that wraps around each path component. The wrapper must contain %c denoting the path component. Defaults to %c.   file extension strip mode: See the \\[layer name\\] field.   Examples:     [layer path] → Body-Hands-Left   [layer path, _] → Body_Hands_Left   [layer path, _, (%c)] → (Body)_(Hands)_(Left)   [layer path, _, (%c), %e] → Body-Hands-Left.png (if the layer name is Left.png and the file extension is png)   If for the separator or the %c option you intend to use characters such as space, [ or ], these require special treatment.   [output folder]   The output folder selected in the plug-in dialog.   Options:     path component strip mode (defaults to %b):            %b&lt;number&gt;: Keep only &lt;number&gt; path components from the end. %b is transformed to the last path component, i.e. the folder name.       %f&lt;number&gt;: Keep only &lt;number&gt; path components from the start.       any other value, such as %, will resolve to the full path.           separator: A string separating the path components. Defaults to -.   wrapper: A string that wraps around each path component. The wrapper must contain %c denoting the path component. Defaults to %c.   Examples for a folder with the path C:\\Users\\username\\Pictures:     [output folder] → Pictures   [output folder, %] → C-Users-username-Pictures   [output folder, %b2] → username-Pictures   [output folder, %b2, _] → username_Pictures   [output folder, %b2, _, (%c)] → (username)_(Pictures)   [output folder, %f2] → C-Users   If for the separator or the %c option you intend to use characters such as a space, [ or ], these require special treatment.   [replace]   Replaces a part of the specified field with another string using a regular expression. This essentially allows you to fine-tune any field.   Options:     field name: Any recognized field described in this section, except “Number”. The field can be specified with options; if so, enclose the field in square brackets ([ and ]).   pattern: Regular expression representing the part to be replaced. Use the same syntax as defined in the re module for Python.   replacement: Regular expression representing the replacement. Use the same syntax as defined in the re module for Python.   (optional) count: Number of replacements to perform if the pattern matches multiple parts. If 0, perform replacements for all parts.   (optional) flags: Flags further adjusting how the replacement should be performed. Flags are specified in the re module for Python. Use the name without the re. prefix. For example, to ignore case, type IGNORECASE or ignorecase. You can specify multiple flags separated by commas.   For the example below, suppose that an image is named Animal copy #1. While the square brackets ([ and ]) enclosing the first three field options are optional, they are necessary in case you need to specify an empty string ([]), leading spaces or commas.   Examples:     [replace, [image name], [a], [b] ] → Animbl copy #1   [replace, [image name], [a], [b], 1, ignorecase] → bnimal copy #1   [replace, [image name], [ copy(?: #[[0-9]]+)*$], [] ] → Animal   If you intend to use characters such as space, these require special treatment.   In case you need to replace literal [ or ] characters, you must, in addition to doubling the square brackets, also insert a \\ before the brackets. If the image is named [Animal, the following will remove the bracket:      [replace, [image name], [\\[[], [] ] → Animal   To remove both [ and ] given the image name [Animal]:      [replace, [image name], [[[\\[[\\]]]]], [] ] → Animal   The [[ preceding \\[[ and the ]] succeeding \\]] represent the special [ and ] characters in regular expressions, respectively, which must be doubled.   [tags]   Only available for: Export Layers, Edit Layers   Color tag assigned to a layer. For example, suppose that a layer has a green color tag assigned. Then (by default) the tag will be formatted as green.   Options:     wrapper: A string that wraps around each tag. The wrapper must contain %t denoting the tag.   color name, custom name, …: Color name in English followed by a custom name for the color. This allows you to map the color name to something else, e.g. green to background. You can specify multiple such pairs in case your image contains layers with different color tags.   Examples:     [tags] → green   [tags, %t, green, background] → background   [tags, (%t), green, background] → (background)   [tags, %t, blue, foreground] → (empty string)   [tags, %t, green, background, blue, foreground] → background   If for the %t option you intend to use characters such as space, [ or ], these require special treatment.   [current date]   The current date.   Options:     format: Date format as per the Python strftime function. Defaults to %Y-%m-%d (year-month-day).   Examples:     [current date] → 2019-01-28   [current date, %m.%d.%Y_%H-%M] → 28.01.2019_19-04   If for you intend to use characters such as space, these require special treatment.   [attributes]   Attributes of the current image and the current Layer.   Options:     pattern: A string formatting the attributes. Available attributes:            %iw: The image width.       %ih: The image height.       %lw: The layer width.       %lh: The layer height.       %lx: The layer x-offset.       %ly: The layer y-offset.           measure: The measure in which the attribute values are displayed. Applies to %lw, %lh, %lx and %ly only. Available measures:            %px (default): Display absolute values in pixels.       %pc: Display percentages relative to the image. A number may be included after %pc to specify the number of digits to round to (2 by default). For example, %pc1 displays percentages rounded to a single decimal digit.           Examples:     [attributes, %lw-%lh-%lx-%ly] → 1000-270-0-40   [attributes, %lw-%lh-%lx-%ly, %pc] → 1.0-0.54-0.0-0.08   [attributes, %lw-%lh-%lx-%ly, %pc1] → 1.0-0.5-0.0-0.1   [attributes, %iw-%ih] → 1000-500   If for you intend to use characters such as space, these require special treatment.   Inserting reserved characters in options   To insert a literal space ( ) or comma (,) in a field option, enclose the option with square brackets. To insert a literal square bracket ([ or ]), double the bracket and enclose the option with square brackets (e.g. [[[] to insert a literal [).   If the last option is enclosed in square brackets, leave a single space between the last and the second to last closing square bracket.   Examples:     [image path, [ ] ] → Body Hands Left   [image path, [,], [[[%c]]] ] → [Body],[Hands],[Left]  ","url": "http://localhost:4000/batcher/docs/renaming/"
  },{
    "title": "Running Batcher Without Dialog",
    "excerpt":"It is also possible to run Batcher without an interactive dialog, e.g. for automation purposes.   The plug-in-batch-convert procedure allows running Batch Convert non-interactively, using the supplied UTF-8-encoded file (the inputs parameter) containing files and folders on each line, plus other export parameters such as the output folder or file extension. If run-mode is Gimp.RunMode.WITH_LAST_VALS, all these parameters (including inputs) will be ignored and instead the settings last used interactively (in the main dialog) will be considered.   The plug-in-batch-export-layers procedure exports layers with the specified or the last used settings, depending on the value of the run-mode parameter. Likewise, plug-in-batch-edit-layers runs batch editing layers with the specified/last used settings.   Example using plug-in-batch-convert in Python (e.g. the Python console in GIMP):  ... procedure = Gimp.get_pdb().lookup_procedure('plug-in-batch-convert') config = procedure.create_config() config.set_property('inputs', Gio.file_new_for_path('/home/username/Pictures/list_of_images.txt')) config.set_property('file-extension', 'png') config.set_property('output-directory', Gio.file_new_for_path('/home/username/Pictures/Output'))  result = procedure.run(config) success = result.index(0) ...   You can also run plug-in-batch-convert, plug-in-batch-export-layers or plug-in-batch-edit-layers with settings imported from a file by specifying the settings-file parameter. In that case, the run-mode must be Gimp.RunMode.NONINTERACTIVE and all other procedure arguments will be ignored (since these arguments will be assigned values from the settings file). The exception is the inputs parameter for plug-in-batch-convert, which will always be considered and the saved input images in the settings file will be ignored.   The plug-in-batch-export-layers-quick and plug-in-batch-edit-layers-quick procedures perform layer export/editing with always the last used settings. The plug-in-batch-export-selected-layers and plug-in-batch-edit-selecetged-layers procedures perform export/editing of selected layers with always the last used settings.  ","url": "http://localhost:4000/batcher/docs/running-batcher-without-dialog/"
  },{
    "title": "Running via Command Line",
    "excerpt":"It is also possible to run Batcher without the interactive dialog, e.g. for automation purposes.   The plug-in-batch-convert procedure allows running Batch Convert non-interactively, using the supplied UTF-8-encoded file (the inputs parameter) containing files and folders on each line, plus other export parameters such as the output folder or file extension. If run-mode is Gimp.RunMode.WITH_LAST_VALS, all these parameters (including inputs) will be ignored and instead the settings last used interactively (in the main dialog) will be considered.   The plug-in-batch-export-layers procedure exports layers with the specified or the last used settings, depending on the value of the run-mode parameter. Likewise, plug-in-batch-edit-layers runs batch editing layers with the specified/last used settings.   You can also run plug-in-batch-convert, plug-in-batch-export-layers or plug-in-batch-edit-layers with settings imported from a file by specifying the settings-file parameter. In that case, the run-mode must be Gimp.RunMode.NONINTERACTIVE and all other procedure arguments will be ignored (since these arguments will be assigned values from the settings file). The exception is the inputs parameter for plug-in-batch-convert, which will always be considered and the saved input images in the settings file will be ignored.   The plug-in-batch-export-layers-quick and plug-in-batch-edit-layers-quick procedures perform layer export/editing with always the last used settings. The plug-in-batch-export-selected-layers and plug-in-batch-edit-selected-layers procedures perform export/editing of selected layers with always the last used settings.   Example using plug-in-batch-convert in Python (e.g. the Python console in GIMP):  procedure = Gimp.get_pdb().lookup_procedure('plug-in-batch-convert') config = procedure.create_config() config.set_property('inputs', Gio.file_new_for_path('/home/username/Pictures/list_of_images.txt')) config.set_property('file-extension', 'png') config.set_property('output-directory', Gio.file_new_for_path('/home/username/Pictures/Output'))  result = procedure.run(config) success = result.index(0)   Example using plug-in-batch-convert by running GIMP via command line (Unix shell) using a settings file:  gimp -nidfs --quit --batch-interpreter python-fu-eval -b \" procedure = Gimp.get_pdb().lookup_procedure('plug-in-batch-convert') config = procedure.create_config() config.set_property('run-mode', Gimp.RunMode.NONINTERACTIVE) config.set_property('inputs', Gio.file_new_for_path('/home/username/Pictures/list_of_images.txt')) config.set_property('file-extension', 'png') config.set_property('output-directory', Gio.file_new_for_path('/home/username/Pictures/Output')) config.set_property('settings-file', Gio.file_new_for_path('/home/username/Pictures/settings.json')) procedure.run(config) \"   On Windows Powershell, you would use a similar syntax:  gimp -nidfs --quit --batch-interpreter python-fu-eval -b @\" &lt;insert Python code here&gt; \"@   To use the special Match input folders value for the output-directory parameter:  # ... config.set_property('output-directory', Gio.file_new_for_uri('special:///match_input_folders')) # ...  ","url": "http://localhost:4000/batcher/docs/running-via-command-line/"
  },{
    "title": "Usage",
    "excerpt":"Batch Image Conversion   In GIMP, select File → Batch Convert....   A dialog appears that allows you to add input files and folders and adjust export settings, such as the output folder, filenames and the file extension.      To start batch conversion, press the Run button.   For information on the export settings, see Adjusting Export Settings below. Image names are used as filenames by default.   For information on actions and conditions, see Actions and Conditions below.   You can add files and folders in one of the following ways:     Drag and drop images and folders from a file explorer application to the area under Input Images.   Copy and paste images and folders from a file explorer application to the area under Input Images. Note that you must click on the area first.   Copy and paste images and folders from a text file, each on a separate line to the area under Input Images. Note that you must click on the area first. Any files and folders that do not exist are ignored.   Press the + button to add files or folders.   Files with a file extension not recognized by Batcher will be filtered by default. If you use a third-party file load plug-in, uncheck the Recognized File Format condition.   You will be warned if you add folder(s) containing too many files or e.g. an entire drive. This is a safeguard against accidentally adding an undesired folder.   You can remove input images and folders by selecting them and pressing Delete or by pressing - → Remove Selected. You can clear the entire input list by pressing - → Remove All or selecting everything with Ctrl + A and then pressing Delete.   You can adjust import options for each file format detected in the input list by pressing the arrow button and selecting Import Options....   By default, the renamed images (as they would be named on export) are displayed. To show their original names, press the arrow button and check Show Original Names.   You can move around individual files or folders by dragging and dropping them anywhere within the input list, or by pressing Alt + Up/Down. This is useful if, for example, you intend rename the images with a numbered sequence.   Files and folders can be sorted by several criteria: original name, new name, creation date, modification date and file size. By default, sorting is performed in the ascending order, folders are always placed first and name-based sorting is case-sensitive. All these options can be switched off/on as needed.   You can export images to the same parent folders as the added input files/folders using the Match input folders option in the output folder dropdown. You will be warned when selecting this option as you may inadvertently overwrite the original images (when the filenames and file extensions match).   You can view message logs recorded during processing via Settings → View Logs and save them to a file.   Exporting Layers   Open an image in GIMP and select File → Export Layers....   A dialog appears that allows you to adjust export settings, such as the output folder, filenames and the file extension.      To export layers, press the Export button.   For information on the export settings, see Adjusting Export Settings. For information on actions and conditions, see Actions and Conditions below.   Quick Export of Layers   If you made changes to your image, and you want to export again with the same settings, or you need a simple export without customization, you can run File → Export Layers (Quick).   For the first time, a small dialog with only export settings is displayed, where you can adjust the basic export settings.      This dialog can be skipped by unchecking Show this dialog.   Note that even actions and conditions set up in the Export Layers dialog will be applied for Export Layers (Quick), even if they are not shown.   Quick Export of Selected Layers   When you select multiple layers in GIMP, you can right-click and select Export Selected Layers to quickly export the selected layers.   In this case, any conditions set in the main dialog will be ignored.      Editing Layers   Open an image in GIMP and select File → Edit Layers....      To run batch editing, press the Run button. This will apply actions to each layer satisfying the activated conditions.   You can take a look at a few examples to get started with actions and conditions.   If the Layers condition is unchecked, group layers will also be processed.   Quick Layer Editing   You can quickly run batch editing via File → Edit Layers (Quick). This can be useful if you made changes to your image and you want to run batch editing again with the same settings.   Quick Editing of Selected Layers   When you select multiple layers in GIMP, you can right-click and select Edit Selected Layers to quickly edit the selected layers.   In this case, any conditions set in the main dialog will be ignored.      Exporting Images Opened in GIMP   If you have multiple images opened in GIMP, you can use File → Export Images... to export them to the specified file format.   A dialog appears that allows you to adjust export settings, such as the output folder, filenames and the file extension.      To export images, press the Export button.   Note that this feature exports images to another file format. If you intend to batch-save XCF images in their original locations, use File → Edit and Save Images... instead.   For information on the export settings, see Adjusting Export Settings. For information on actions and conditions, see Actions and Conditions below.   Quick Export of Images   If you made changes to your images, and you want to export them again with the same settings, or you need a simple export without customization, you can run File → Export Images (Quick).   For the first time, a small dialog with only export settings is displayed, where you can adjust the basic export settings.      This dialog can be skipped by unchecking Show this dialog.   Note that even actions and conditions set up in the Export Images dialog will be applied for Export Images (Quick), even if they are not shown.   Editing and Saving Images Opened in GIMP   File → Edit and Save Images... allows you to batch-edit and save all opened images in place.      Both editing and saving are optional, i.e. you can perform only saving, or only editing as needed. If you intend to edit images, you can take a look at a few examples to get started with actions and conditions.   To edit and/or save images, press the Run button.   If you intend to batch-export images to another file format, use File → Export Images... instead.   If you intend to edit each layer within an image individually instead of images as a whole, use File → Edit Layers... instead.   Quick Image Editing and Saving   You can quickly run batch editing and saving of images via File → Edit and Save Images (Quick). This can be useful if you e.g. made changes to your images and you want to save them all with the same settings.   Adjusting Export Settings   Filename Pattern   The text entry next to Filename lets you customize filenames. A popup offers you several components you can combine to create a filename pattern, such as a numbered sequence.   For details, see Renaming.   File Format   Type or choose your desired file extension next to File Format.   The dropdown list displays available file formats alongside their associated file extensions. If a file format contains multiple file extensions, the first is selected by default, but you may also choose a different extension (by clicking on it or pressing Tab).   For now, the dropdown only contains a fixed list of file formats provided by GIMP. However, you can still enter a file extension not in the list in case you use a third-party file export plug-in.   Export Options   Pressing the Export Options... button reveals additional export options, particularly file format options (compression for PNG, image quality for JPG, etc.).   If you need to adjust options for a file format not recognized by Batcher, set How to adjust file format options to Interactively. You will be prompted to set the file format options right after you start batch processing.   All options are described in Export Options.   Actions and Conditions   Before the start of batch processing, you can apply a multitude of actions to each image/layer, such as scaling, background insertion, any layer effect or GIMP plug-in.   You can exclude images/layers from being processed/exported based on one or more conditions (only filenames matching a suffix, only visible layers, …).   Actions and conditions can be a powerful way to adjust batch processing to your heart’s content. You can take a look at a few examples to get started.   The names under Input Images/Input Layers and the image preview are automatically updated as you adjust the actions and conditions.   For details, see Actions and Conditions.   Preview   The image preview displays the contents of the selected image/layer.   You can adjust the width of the entire pane containing the input list and the preview by dragging the separator between the preview and the actions/conditions. You can also adjust the height of the previewed image by dragging the separator above the image.   If the previewed image takes too long to render, the preview is no longer updated automatically. A refresh button above the image is displayed that allows you to manually update the image. To switch between automatic and manual update, press the arrow button and select Update Automatically.   Note that the preview is only an approximation of what the exported image will look like. For example, for the JPEG format, which does not support transparency and may result in visible compression artifacts, the preview will show a transparent image without artifacts.   Managing Settings   You can turn auto-closing the main dialog on/off by checking/unchecking Settings → Close when Done.   You can check Settings → Continue on Error to continue processing if you determine that error(s) occurring during processing are harmless.   Once batch processing is done successfully, your settings (output folder, file extension, dialog size, actions, conditions, etc.) are automatically saved. You can save settings manually anytime by selecting Settings → Save Settings or pressing Ctrl + S anywhere in the dialog. To reset settings to their default values, select Settings → Reset Settings.   You may also save settings to a custom file by selecting Settings → Save Settings to File.... This allows swapping between different plug-in configurations or sharing them. To load settings from a file, select Settings → Load Settings from File... and select the file.   For Batch Convert, you can optionally turn off saving input images by unchecking Settings → Keep Input Images. When this setting is checked, Reset Settings will not remove the input images. When loading settings from a file and this setting is checked, the input images will be preserved and any input images stored in the file will be ignored. If you want to load the input images from the file, uncheck this setting.  ","url": "http://localhost:4000/batcher/docs/usage/"
  },{
    "title": "News",
    "excerpt":"","url": "http://localhost:4000/batcher/news/"
  },{
    "title": "Batcher",
    "excerpt":"                                                                                                                     Convert Files                                                    Converts image files to another format. Supports any file format provided by GIMP and third-party plug-ins.                                                   Read More                                                                                                                                                    Export/Edit Layers                                                    Exports layers as separate images. Can apply in-place edits to each layer, such as renaming or color correction. Also handles group layers.                                                   Read More                                                                                                                                                    Export/Edit Images                                                    Exports images opened in GIMP to the specified file format. Also allows in-place editing and saving to the native GIMP format.                                                   Read More                                                                                                                                                            Highly customizable, too.                                                    Apply any filter to each image/layer during batch processing, including third-party plug-ins. Process only images/layers matching your criteria.                                                   Read More                                        Support   Feel free to ask questions related to Batcher.   Found a bug? You can report it on GitHub. Just make sure to check the GitHub issues and the known issues first.   To provide translations for Batcher, see the translation instructions.   Thank you for your contributions. 😊  ","url": "http://localhost:4000/batcher/"
  },{
    "title": "News",
    "excerpt":"","url": "http://localhost:4000/batcher/news/"
  },{
    "title": "News",
    "excerpt":"","url": "http://localhost:4000/batcher/news/"
  },{
    "title": "News",
    "excerpt":"","url": "http://localhost:4000/batcher/news/"
  },{
    "title": "News",
    "excerpt":"","url": "http://localhost:4000/batcher/news/"
  }]
