GIMPTOOL-2.0(1)

📦
version 2.10.36 · 3 versions
, in ubuntu noble

🎀 NAME 🎀

gimptool-2.0 — the little script that does a whole bunch of GIMPy things for you, no cap 💖

✨ SYNOPSIS ✨

gimptool-2.0 [--prefix[=DIR]] [--exec-prefix[=DIR]] [--version] [--help]
[--quiet] [--silent] [-n] [--just-print] [--dry-run] [--recon] [--msvc-
syntax] [--bindir] [--sbindir] [--libexecdir] [--datadir] [--sysconfdir]
[--sharedstatedir] [--localstatedir] [--libdir] [--infodir] [--mandir]
[--includedir] [--gimpplugindir] [--gimpdatadir] [--libs] [--libs-noui]
[--cflags] [--cflags-noi] [--build plug-in.c] [--build-strip plug-in.c]
[--install plug-in.c] [--install-strip plug-in.c] [--install-admin plug-
in.c] [--install-bin plug-in] [--install-admin-strip plug-in.c]
[--install-bin-strip plug-in] [--install-admin-bin plug-in]
[--install-script script.scm] [--install-admin-script script.scm]
[--uninstall-bin plug-in] [--uninstall-admin-bin plug-in]
[--uninstall-script script.scm] [--uninstall-admin-script script.scm]

🦋 DESCRIPTION 🦋

Okay bestie, listen. gimptool-2.0 is that girl who can, among other things, build plug-ins or scripts for you and install them — as long as they're shipped as one single source file. One file. That's the vibe. 🫶

She's also the one your other programs call when they need to know what libraries and include-paths GIMP was compiled with. To pull that off, gimptool-2.0 uses pkg-config. ✨

Real talk though: if you're writing a Makefile, please just call pkg-config directly instead of calling gimptool-2.0. That's the recommended move, fr fr. 💅

💅 OPTIONS 💅

gimptool-2.0 accepts the following options:

  • --version — Prints out the version of GIMP you currently have installed, straight to standard output. 👑
  • --help — Prints the help blurb, showing you the commandline options people actually use the most.
  • --quiet — Runs quietly, no echoing any of the build commands. Shhh. 🙈
  • --silent — Runs silently, no echoing any of the build commands. Literally the same thing as --quiet.
  • -n — Test mode. It prints the commands but does not actually execute them. Perfect for dry runs when you're just testing. 🧚
  • --just-print — Test mode. Prints the commands but doesn't actually execute them. Same as -n.
  • --dry-run — Test mode. Prints the commands but doesn't actually execute them. Same as -n.
  • --recon — Test mode. Prints the commands but doesn't actually execute them. Same as -n.
  • --msvc-syntax — Useful on Windows 🪟. Outputs the compiler and linker flags in the syntax that Microsoft's toolchain wants. It gets passed along to the pkg-config command that does most of gimptool-2.0's work.
  • --bindir — Outputs the bindir used to install the GIMP.
  • --sbindir — Outputs the sbindir used to install the GIMP.
  • --libexecdir — Outputs the libexecdir used to install the GIMP.
  • --datadir — Outputs the datadir used to install the GIMP.
  • --sysconfdir — Outputs the sysconfdir used to install the GIMP.
  • --sharedstatedir — Outputs the sharedstatedir used to install the GIMP.
  • --localstatedir — Outputs the localstatedir used to install the GIMP.
  • --libdir — Outputs the libdir used to install the GIMP.
  • --infodir — Outputs the infodir used to install the GIMP.
  • --mandir — Outputs the mandir used to install the GIMP.
  • --includedir — Outputs the includedir used to install the GIMP.
  • --gimpdatadir — Outputs the actual directory where the GIMP data files got installed. 📁
  • --gimpplugindir — Outputs the actual directory where the GIMP plug-ins got installed. 🔌
  • --build plug-in.c — Compiles and links plug-in.c into a GIMP plug-in. 🔥
  • --build-strip plug-in.c — Compiles, links, and strips plug-in.c into a GIMP plug-in.
  • --install plug-in.c — Compiles, links, and installs plug-in.c into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins).
  • --install-strip plug-in.c — Compiles, links, strips, and installs plug-in.c into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins).
  • --install-admin plug-in.c — Compiles, links, and installs plug-in.c into the system-wide GIMP plug-in directory (/usr/lib/gimp/2.0/plug-ins). Big admin energy 👑
  • --install-bin plug-in — Installs plug-in into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins).
  • --install-admin-bin plug-in — Installs plug-in into the system-wide GIMP plug-in directory (/usr/lib/gimp/2.0/plug-ins).
  • --install-bin-strip plug-in — Installs a stripped plug-in into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins).
  • --install-admin-bin-strip plug-in — Installs a stripped plug-in into the system-wide GIMP plug-in directory (/usr/lib/gimp/2.0/plug-ins).
  • --install-script script.scm — Installs script.scm into the user's personal GIMP script directory ($XDG_CONFIG_HOME/GIMP/2.10/scripts).
  • --install-admin-script script.scm — Installs script.scm into the system-wide GIMP script directory (${datarootdir}/gimp/2.0/scripts).
  • --uninstall-bin plug-in — Uninstalls plug-in from the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/2.10/plug-ins). Bye bestie 😭
  • --uninstall-admin-bin plug-in — Uninstalls plug-in from the system-wide GIMP plug-in directory (/usr/lib/gimp/2.0/plug-ins).
  • --uninstall-script script.scm — Uninstalls script.scm from the user's personal GIMP script directory ($XDG_CONFIG_HOME/GIMP/2.10/scripts).
  • --uninstall-admin-script script.scm — Uninstalls script.scm from the system-wide GIMP script directory (${datarootdir}/gimp/2.0/scripts).
  • --libs — Prints the linker flags you need to link a GIMP plug-in. 🔗
  • --libs-noui — Prints the linker flags you need to link a GIMP plug-in, for plug-ins that don't need the GTK+ libraries.
  • --cflags — Prints the compiler flags you need to compile a GIMP plug-in.
  • --clags-noui — Prints the compiler flags you need to compile a GIMP plug-in, for plug-ins that don't need the GTK+ libraries.
  • --prefix=PREFIX — If you specify it, use PREFIX instead of the installation prefix that GIMP was built with when computing the output for the --cflags and --libs options. This option also gets used for the exec prefix if --exec-prefix wasn't specified. ⚠️ It must be specified before any --libs or --cflags options.
  • --exec-prefix=PREFIX — If you specify it, use PREFIX instead of the installation exec prefix that GIMP was built with when computing the output for the --cflags and --libs options. ⚠️ This option must be specified before any --libs or --cflags options.

🌸 ENVIRONMENT 🌸

  • CC — to get the name of the C compiler you want. 🛠️
  • CFLAGS — to get the preferred flags to pass to the C compiler for plug-in building.
  • LDFLAGS — to get the preferred flags for passing to the linker.
  • LIBS — for passing extra libs that might be needed in the build process. For example, LIBS=-lintl.
  • PKG_CONFIG — to get the location of the pkg-config program that's used to determine details about your glib, pango, gtk+ and gimp installation. 🧚

🌈 SEE ALSO 🌈

gimp(1), gimprc(5), pkg-config(1)

💜 AUTHORS 💜

gimptool was written by Manish Singh (yosh@gimp.org), and it's based on gtk-config by Owen Taylor (owen@gtk.org). Iconic lineage honestly. ✨

This man page was written by Ben Gertzfield (che@debian.org), and tweaked by Manish Singh (yosh@gimp.org), Adrian Likins (adrian@gimp.org) and Marc Lehmann (pcg@goof.com>).

And that's the whole page bestie — brought to you by the GIMP Manual Pages, Version 2.10.36, and this absolute queen of a manual entry: GIMPTOOL-2.0(1). Go build something cute. 💖✨🎀

📦 where this page comes from