Skip to content

Wrap indicator import statement to correctly warn user about missing dependency #5

@joshua1955

Description

@joshua1955

Description

When installing chwall on Arch-based systems (like CachyOS) via the AUR package, the main application works, but the chwall-indicator utility immediately fails to launch with a ValueError.

The user is required to manually install libappindicator-gtk3 to resolve this, suggesting this package is a missing runtime dependency for chwall-indicator that should be explicitly listed in the package metadata.

Steps to Reproduce

  1. Start with a clean Arch Linux (or Arch derivative like CachyOS) installation.
  2. Install chwall from the AUR (e.g., using an AUR helper like yay or paru):
    yay -S chwall
  3. Attempt to run the indicator:
    chwall-indicator

Actual Result

The program fails with the following traceback:

Traceback (most recent call last):
  File "/usr/bin/chwall-indicator", line 5, in <module>
    from chwall.gui.indicator import ChwallIndicator
  File "/usr/lib/python3.13/site-packages/chwall/gui/indicator.py", line 10, in <module>
    gi.require_version("AppIndicator3", "0.1")
    ~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.13/site-packages/gi/__init__.py", line 132, in require_version
    raise ValueError(f"Namespace {namespace} not available")
ValueError: Namespace AppIndicator3 not available

Expected Result

chwall-indicator should launch successfully and appear in the system tray.

Workaround (Fix)

The issue is resolved by manually installing the necessary dependency:

sudo pacman -S libappindicator-gtk3

Recommendation

Please ensure that libappindicator-gtk3 (or its equivalent in other distributions, which provides the AppIndicator3 GTK bindings) is listed as a hard runtime dependency for chwall-indicator in the packaging metadata (e.g., PKGBUILD for Arch, or the main project dependencies if applicable).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions