gexport

Make-like export tool for GIMP

Write a simple YAML file that tells gexport how to export, scale and crop multiple images from your complex GIMP projects.

Check out the examples

Install

$ git clone https://github.com/petersuttondev/gexport.git
$ cd gexport
$ pip install .

Get Started

$ cd /path/to/project
$ gexport json-schema > gexport-schema.json

Create a file called gexport.yaml

# yaml-language-server: $schema=./gexport-schema.json
database: gexport.sqlite3
xcfs: {}

Add GIMP projects:

# yaml-language-server: $schema=./gexport-schema.json
database: gexport.sqlite3
xcfs:
  project-a.xcf:
    exports:
      project-a.png: {}
  project-b.xcf:
    exports:
        project-b.png: {}

Export images:

$ gexport export
$ ls *.png
project-a.png project-b.png

Documentation

This describes the structure of gexport's YAML schema All paths are relative to

Top-level

Key	Type	Required	Description
database	string	Yes	Path to a SQLite database where gexport should save export metadata

# yaml-language-server: $schema=./gexport-schema.json
database: gexport.sqlite3
xcfs:
  # Path to your .xcf file, relative to this file
  project-a.xcf:
    exports:
      # Export path, relative to this file.
      image-a.png: {}

      # Show all layers
      image-b.png:
        default: show
          
      # Hide by default and show one layer
      image-c.png:
        default: hide
        show: Layer A

      # Show multiple layers
      image-d.png:
        default: hide
        show:
          - Layer A
          - Layer B

      # Show all layers in a group
      image-e.png:
        default: hide
        show:
          group: Group A
          default: show

      # Show some layers in a group
      image-f.png:
        default: hide
        show:
          group: Group A
          show:
            - Layer A
            - Layer B