GOBBLE(1)

📦 version 1.3, in nixos 26.05, nixpkgs unstable

🦋 gobble(1) · General Commands Manual · hide your current window while using an external program 🦋

okay bestie, this is the manual for gobble, and it is literally the “hide my window while I run a thing” icon. no cap.

🎀 NAME 🎀

gobble — hide your current window while using an external program

✨ SYNOPSIS ✨

gobble [OPTIONS] CMD ...

💖 DESCRIPTION 💖

okay so gobble uses libxcb to find the currently focused window, then unmaps it. whatever arguments (other than flags) are passed to it will be interpreted as a command & its arguments and will execute it. when that finishes (or fails), the original window will be remapped. fr fr, that’s the whole vibe.

💅 OPTIONS 💅

  • -h — Displays a friendly help message.
  • -v — Displays the software version.
  • -o — Uses overlap mode which overlays the new window ontop of the old one instead of unmapping it (useful in floating window managers).

🌈 EXAMPLES 🌈

  • gobble mpv test.mp4 — Hides the terminal and opens test.mp4 in mpv (video player program).
  • gobble -o mpv test.mp4 — Opens test.mp4 in mpv and positions it ontop of the terminal.
  • gobble -v — Displays the software version and exits.
  • gobble -h — Displays the friendly help message and exits.

⭐ EXIT VALUES ⭐

Gobble will exit with whatever code the passed command exited with, or if nothing is passed then 0. periodt.

💀 ISSUES 💀

Only works when using the X11 display server.
Programs that fork immediately (for example as part of a daemon) don’t behave right with gobble.

Copyright © 2021-2023 Sebastien MacDougall-Landry. License GPLv3+: GNU GPL version 3 or later . This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

🫶 AUTHORS 🫶

Sebastien MacDougall-Landry.

💖 sign-off: gobble 1.3 · August 2023 · byeeee bestie 💖

📦 where this page comes from