The tray icon doesn't appear on Linux

You launched TYO Reach (or it started at login), tyoreach is running, but there's no icon in the panel to click.

What it means

Reach's Linux tray is a native StatusNotifierItem — it needs no extra libraries, but the desktop panel has to support that protocol. KDE Plasma, XFCE, Cinnamon, MATE and most others do. Stock GNOME removed tray support years ago, so it shows nothing until an AppIndicator/StatusNotifier extension is installed.

Fixes, in order

  1. On GNOME, install the AppIndicator extension. On Ubuntu it's the gnome-shell-extension-appindicator package (often pre-installed on Ubuntu's own session, not on vanilla GNOME); on Fedora and others install AppIndicator and KStatusNotifierItem Support from extensions.gnome.org. Log out and back in, then relaunch Reach.
  2. Check Reach is actually running. pgrep -a tyoreach — if nothing's listed, launch it from your app menu or run tyoreach. Autostart is set up by the package and by the installer script.
  3. Give the panel a nudge. Reach re-registers its icon when the theme or panel changes; toggling the extension off and on, or restarting the panel, is enough on most desktops.
  4. Use the CLI meanwhile. Nothing about routing depends on the icon. Sessions and the local proxy work regardless — see the CLI reference and Use Reach with any app.

Common questions

The icon appears but is blank or the wrong colour

Icons refresh automatically when the desktop theme changes; if one gets stuck, quit Reach from the menu (or pkill tyoreach) and relaunch.

Wayland or X11?

Both — StatusNotifierItem is a D-Bus protocol, not tied to the display server.

Did the install fail?

If tyoreach isn't on your PATH after the repo install, check the package installed (apt list --installed | grep tyoreach or rpm -q tyoreach). Per-distro steps are in Install on Linux.

Still stuck?

Get in touch with your distribution and desktop environment.