TETHER-GTK(1)

📦 version 0.2.37, in nixpkgs unstable

💅 TETHER-GTK(1) — like, the graphical one, bestie

okay so first things first: this is a page from the User Commands section of the manual, and the star of the show is tether-gtk(1) — the pretty face on top of Tether. let me tell you everything 🫶

✨ NAME ✨

tether-gtk — the Graphical interface for Tether. yes. a whole GUI. no more squinting at a terminal, we're in our windows era 🪟✨

🌸 SYNOPSIS 🌸

tether-gtk [--tray] [--devices | --messages | --notifications]
[--thread=KEY]

💖 DESCRIPTION 💖

tether-gtk is a GTK-based graphical application for managing Tether connections and devices — and honestly? it's giving main character energy. it gives you a user-friendly interface to do all this:

  • 💫 Monitor the status of the connection to the Tether daemon.
  • 🎀 Manage paired devices and accept new pairing requests.
  • 🦋 Send and receive files.
  • 🌈 View clipboard sync history and status.

and here's the iconic part: if the tetherd(8) daemon is not running, tether-gtk will attempt to start it automatically. self-sufficient queen behavior, we love to see it 👑

🔥 OPTIONS 🔥

  • --tray — start without showing the window. the app is reachable only from its tray icon until Open Tether is chosen. lowkey stealth mode bestie 🙈
  • --devices, --messages, --notifications — open on that tab. and if tether-gtk is already running? no cap, it raises the existing window and switches it instead of starting a second one. no duplicate windows here, we're monogamous about that 💀
  • --thread=KEY — open the messages tab straight on the conversation with this thread key, for example tel:+15551234567. this is literally what the Reply button on a message notification uses. iykyk 🔔

🎀 FILES 🎀

  • ~/.config/tether/gtk.json — interface preferences. here's what lives in there:
    • close_to_tray (boolean) — keeps the application running in the tray when the window is closed. ✨
    • tray_icon — selects the tray icon set: symbolic (default) is monochrome and recolored by the panel, color is the full-color application icon. pick your vibe 💅

🦋 SEE ALSO 🦋

tether(1), tetherd(8) — go read those too, bestie, they're the whole ecosystem 🫶

fr fr that's the whole page. nothing skipped, nothing invented. slay 💜

and a cute little sign-off before you go: this page is from Tether 0.2.37, dated January 1980 (yes really, iconic timestamp), and it's the TETHER-GTK(1) entry. periodt. 🌟

📦 where this page comes from