GIMPTOOL(1)

💖 GIMPTOOL(1) — the group chat manual 💖

okay so bestie, welcome to the General Commands Manual entry for gimptool. yes this is the one. sit down, hydrate, we're doing this. 🫶

---

✨ NAME ✨

gimptool — a script to perform various GIMPy functions 🎀

---

✨ SYNOPSIS ✨

gimptool [--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]

like, look at that. it's giving options. 💅

---

✨ DESCRIPTION ✨

gimptool is a tool that can, among other things, build plug-ins or scripts and install them if they are distributed in one source file. one file. that's the whole vibe. iconic. 🌸

gimptool can also be used by programs that need to know what libraries and include-paths GIMP was compiled with. and the way it does that? it uses pkg-config for this task. 🧚

ok real talk bestie: for use in Makefiles, it is recommended that you use pkg-config directly instead of calling gimptool. no cap. that's the move. 🙈

---

✨ OPTIONS ✨

gimptool accepts the following options:

• --version — prints the currently installed version of GIMP on the standard output. the "who even are you" check. 👑
• --help — prints out the help blurb, showing commonly used commandline options. your lil cheat sheet. 🎀
• --quiet — run quietly without echoing any of the build commands. no chatter, just results. 🤫
• --silent — run silently without echoing any of the build commands. same as --quiet. literally the same thing, just a different name. 💀
• -n — test mode. print the commands but don't actually execute them. useful for making dry runs for testing. main character energy: says it's gonna do it, does not do it. 😭
• --just-print — test mode. print the commands but don't actually execute them. same as -n. 💅
• --dry-run — test mode. print the commands but don't actually execute them. same as -n. 🌈
• --recon — test mode. print the commands but don't actually execute them. same as -n. (four options, one behaviour, and honestly? slay.) ✨
• --msvc-syntax — useful on Windows. outputs the compiler and linker flags in the syntax used by Microsoft's toolchain. this gets passed to the pkg-config command that does most of gimptool'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 were installed. the real one. the genuine article. 🔥
• --gimpplugindir — outputs the actual directory where the GIMP plug-ins were installed. 🎀
• --build plug-in.c — compile and link plug-in.c into a GIMP plug-in. ✨
• --build-strip plug-in.c — compile, link, and strip plug-in.c into a GIMP plug-in. less is more, babe. 💅
• --install plug-in.c — compile, link, and install plug-in.c into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/3.0/plug-ins). it's yours. 🫶
• --install-strip plug-in.c — compile, link, strip, and install plug-in.c into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/3.0/plug-ins). 🧚
• --install-admin plug-in.c — compile, link, and install plug-in.c into the system-wide GIMP plug-in directory (/usr/lib/x86_64-linux-gnu/gimp/3.0/plug-ins). big girl moves, system-wide. 👑
• --install-bin plug-in — install plug-in into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/3.0/plug-ins). already built? just drop it in. 🌸
• --install-admin-bin plug-in — install plug-in into the system-wide GIMP plug-in directory (/usr/lib/x86_64-linux-gnu/gimp/3.0/plug-ins). 💖
• --install-bin-strip plug-in — install stripped plug-in into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/3.0/plug-ins). 🌈
• --install-admin-bin-strip plug-in — install stripped plug-in into the system-wide GIMP plug-in directory (/usr/lib/x86_64-linux-gnu/gimp/3.0/plug-ins). ⭐
• --install-script script.scm — install script.scm into the user's personal GIMP script directory ($XDG_CONFIG_HOME/GIMP/3.0/scripts). script girlies rise. 🦋
• --install-admin-script script.scm — install script.scm into the system-wide GIMP script directory (/usr/share/gimp/3.0/scripts). 💜
• --uninstall-bin plug-in — uninstall plug-in from the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/3.0/plug-ins). breaking up is hard but we do it anyway. 😭
• --uninstall-admin-bin plug-in — uninstall plug-in from the system-wide GIMP plug-in directory (/usr/lib/x86_64-linux-gnu/gimp/3.0/plug-ins). 💀
• --uninstall-script script.scm — uninstall script.scm from the user's personal GIMP script directory ($XDG_CONFIG_HOME/GIMP/3.0/scripts). 🙈
• --uninstall-admin-script script.scm — uninstall script.scm from the system-wide GIMP script directory (/usr/share/gimp/3.0/scripts). ✨
• --libs — print the linker flags that are necessary to link a GIMP plug-in. the "what do i link against" tea. 🔥
• --libs-noui — print the linker flags that are necessary to link a GIMP plug-in, for plug-ins that do not require the GTK libraries. no GTK, no problem. 💅
• --cflags — print the compiler flags that are necessary to compile a GIMP plug-in. 🎀
• --clags-noui — print the compiler flags that are necessary to compile a GIMP plug-in for plug-ins that do not require the GTK libraries. (yes bestie, that's the spelling on the page, we don't touch it, we just respect it.) 🌸
• --prefix=PREFIX — if specified, use PREFIX instead of the installation prefix that GIMP was built with when computing the output for the --cflags and --libs options. this option is also used for the exec prefix if --exec-prefix was not specified. ⚠️ this option must be specified before any --libs or --cflags options. order matters, bestie, it always does. 👑
• --exec-prefix=PREFIX — if specified, 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. same rule, no exceptions. 🫶

---

✨ ENVIRONMENT ✨

the vibes your shell can hand over:

• CC — to get the name of the desired C compiler. 💖
• 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 may be needed in the build process. for example, LIBS=-lintl . 🦋
• PKG_CONFIG — to get the location of the pkg-config program that is used to determine details about your glib, pango, gtk and gimp installation. the behind-the-scenes bestie. 💅

---

✨ SEE ALSO ✨

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

---

✨ AUTHORS ✨

gimptool was written by Manish Singh (yosh@gimp.org) and is based on gtk-config by Owen Taylor (owen@gtk.org). 👑

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. GIMP Manual Pages, Version 3.0.4 — go build something cute, and remember: pkg-config directly in your Makefiles, iykyk. mwah. 💖✨🎀🦋🌸💅🫶👑🌈⭐💜