XX-net/XX-Net · warning

load gi fail:%r, SysTray will not show.

Error message

load gi fail:%r, SysTray will not show.

What it means

sys_platform.has_gi tries to import PyGObject (gi) with Gtk 3.0 to decide whether a Linux system tray can be shown. Any failure (module missing, wrong Gtk version, dynamic-linker errors) is caught and logged, and the function returns False so the launcher falls back to another tray backend or no tray.

Solutions

1. Install PyGObject and GTK3 introspection data: sudo apt install python3-gi gir1.2-gtk-3.0 libgtk-3-0
2. If on a headless machine, ignore the warning — the launcher will use a fallback (no tray) backend
3. Check python3 -c 'import gi; gi.require_version("Gtk","3.0")' to reproduce and see the real error
4. Verify the same python interpreter the launcher uses has gi installed (pip vs apt python)

def has_gi():
    try:
        import gi
        gi.require_version('Gtk', '3.0')
        from gi.repository import Gtk  # noqa
        return True
    except Exception:
        return False
if not has_gi():
    print('install: sudo apt install python3-gi gir1.2-gtk-3.0')

def has_gi() -> bool:
    try:
        import gi; gi.require_version('Gtk', '3.0'); from gi.repository import Gtk
        return True
    except Exception:
        return False

When it happens

Trigger: Calling has_gi() on Linux when python3-gi is not installed, gi.require_version('Gtk','3.0') fails because only Gtk 4 is available, or libgtk-3 shared libraries cannot be loaded.

Common situations: Minimal/headless Linux or container without GTK; Debian/Ubuntu systems missing python3-gi and gir1.2-gtk-3.0 packages; GTK 4-only distributions.

Related errors

• detect platform fail
• Enable auto start, create path
• get ip address e:%r
• import mac_tray except:%r, Please try run 'sudo pip3…
• please install *libnss3-tools* package to import GoAgent…

AI-assisted analysis of XX-net/XX-Net@cfa5bc17b6 (2026-08-27). Data as JSON: /api/errors/909f81b44d19f143. Report an issue: GitHub.

Appendix: source

Thrown at code/default/launcher/sys_platform.py:48

    else:
        def X_is_running():
            try:
                from subprocess import Popen, PIPE
                p = Popen(["xset", "-q"], stdout=PIPE, stderr=PIPE)
                p.communicate()
                return p.returncode == 0
            except:
                return False


        def has_gi():
            try:
                import gi
                gi.require_version('Gtk', '3.0')
                from gi.repository import Gtk as gtk
                return True
            except Exception as e:
                xlog.warn("load gi fail:%r, SysTray will not show.", e)
                return False


        def has_pygtk():
            try:
                import pygtk
                pygtk.require('2.0')
                import gtk
                return True
            except:
                return False


        platform = "linux"
        platform_lib = os.path.join(default_path, 'lib', 'linux')
        sys.path.append(platform_lib)

        if X_is_running() and (has_pygtk() or has_gi()):

View on GitHub (pinned to cfa5bc17b6)