cogctl(1)

📦 version 0.18.4, in debian bookworm, debian trixie, opensuse-leap 16.0, ubuntu jammy

💖 cogctl — bestie's guide to bossing around Cog 💖

okay so real talk: this is the cogctl page from the General Commands Manual (section 1, obvs) and it's literally your remote control for a running Cog instance. not even joking. let's get into it 🫶

✨ NAME ✨

cogctl — a tool to control a running Cog instance

like. that's the whole job description. it's the tool. it controls Cog. the way that a running Cog instance just exists and cogctl is there to tell it what to do?? iconic behavior honestly 💅

🌸 SYNOPSIS 🌸

cogctl [options] <command> [command options]

so you give it some options if you want, then a command (mandatory bestie, can't skip that part), then that command's own options. simple. clean. slay ✨

🦋 DESCRIPTION 🦋

cogctl is a tool to control a running Cog instance.

that's it. that's the vibe. it pings it, it opens stuff in it, it tells it to quit. main character energy for a command-line utility ngl 😭

🎀 OPTIONS 🎀

these are the global options, the ones that go before your command. get them in the right order bestie, the shell does not care about your feelings 💀

  • -h, --help — show help options. when in doubt, ask for help. no shame in it fr fr 🙈
  • -A, --appid=ID — application identifier of the Cog instance you wanna control. ID is a placeholder, swap in the real one 🫶
  • -o, --object-path=PATH — object path implementing the org.gtk.Actions interface. yes it's a whole interface name, yes you need it exact, iykyk ✨
  • -y, --system — use the system bus instead of the session bus. lowkey important distinction, don't sleep on it 🌈

👑 COMMANDS 👑

here's the menu, the whole roster, every single one of them. no skipping, we're doing all of them 💖

  • help [command] — show a list of commands. and if you follow it with a command name, it shows you additional information about that command. so like, a help within a help. meta. obsessed 🎀
  • appid — display application ID being remotely controlled. look at it. that's the ID. right there. 👀
  • objpath — display the D-Bus object path being used. yes, the D-Bus path. it's giving very technical and we love that for it 💜
  • open <URL> — open a URL. URL is the placeholder, put your actual URL there bestie, don't literally type <URL> 😭
  • previous — navigate backward in the page view history. back. like the back button. but in your terminal. iconic 🦋
  • next — navigate forward in the page view history. and this one goes forward. they're a pair. they complete each other. periodt ✨
  • ping — check whether Cog is running. the "u up?" of commands. does exactly what it says 💅
  • quit — exit the application. bye bestie 👋💖
  • reload — reload the current page. refresh. rebirth. a little glow-up for the page you're on 🌸

🌈 SEE ALSO 🌈

the big sibling. the main event. go read that one too, it's giving lore ⭐

💜 AUTHOR 💜

this manual page was written by Alberto Garcia <berto@igalia.com> — thank you for your service, king 🫡👑

ngl this whole page is short and sweet and i respect that. go control your Cog. you got this. no cap 💅✨

okay so that's the whole thing — and before you go, this page is dated Jan 25, 2020, which is literally when it got written, so shoutout to that little timestamp 🎀 byeee bestie, go ping something 💖🦋

📦 where this page comes from