Skip to content
totoshko88Public

About

Gnome extension to work with GlobalProtect CLI

Resources

Contributing

Security policy

Stars

7 stars

Watchers

0 watching

Forks

Latest commit

 

History

94 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gp-gnome

License: GPL v3 GNOME Shell Version CI Get it on GNOME Extensions

GNOME Shell extension for GlobalProtect VPN CLI integration. Native system tray indicator with full VPN management.

Note: Designed for GlobalProtect CLI (PanGPLinux) - the official Palo Alto Networks VPN client for Linux.

Menu Screenshot

Features

Category Features
Connection Connect/Disconnect with MFA support, Gateway selection, Stays connected on screen lock, Configurable auto-disconnect on lock/logout
Monitoring Real-time status, Configurable polling (3-60s), Custom status icons
Settings Portal address, Username, SSL-only mode, Log level, Certificate import
Advanced Network rediscovery, HIP resubmission, Log collection, Diagnostics
Info Host state (HIP), Errors, Notifications, Help, Version

Requirements

  • GNOME Shell 45, 46, 47, 48, 49, 50, or 51
  • GlobalProtect CLI installed (globalprotect command available)

Installation

From GNOME Extensions (recommended)

→ Install from extensions.gnome.org

From Release

# Download and install
wget https://github.com/totoshko88/gp-gnome/releases/latest/download/gp-gnome@totoshko88.github.io.zip
gnome-extensions install gp-gnome@totoshko88.github.io.zip --force
gnome-extensions enable gp-gnome@totoshko88.github.io

# Restart GNOME Shell
# Wayland: Log out and back in
# X11: Alt+F2 → r → Enter

From Source

git clone https://github.com/totoshko88/gp-gnome.git
cd gp-gnome
make install
gnome-extensions enable gp-gnome@totoshko88.github.io

Quick Start

  1. Click the extension icon in system tray
  2. Open Settings → Set your portal address
  3. Click Connect
  4. Complete MFA in browser if prompted

Status Icons

Icon State
🟢 Green Connected
🔴 Red Disconnected
🟡 Yellow Connecting/Disconnecting
🟠 Orange Error

Configuration

Via Settings Dialog

Click extension icon → Settings

Via Command Line

gsettings set org.gnome.shell.extensions.gp-gnome portal-address "vpn.example.com"
gsettings set org.gnome.shell.extensions.gp-gnome poll-interval 10
gsettings set org.gnome.shell.extensions.gp-gnome username "your-username"
gsettings set org.gnome.shell.extensions.gp-gnome ssl-only true

Lock & logout behavior

The extension does not manage the VPN across screen lock or logout. The GlobalProtect daemon owns the tunnel, so the connection stays up while the screen is locked regardless of the extension's state. To disconnect, use the extension's Connect/Disconnect toggle or the globalprotect disconnect command.

Troubleshooting

Extension not appearing

# Check if enabled
gnome-extensions list --enabled | grep gp-gnome

# Check logs
journalctl -f -o cat /usr/bin/gnome-shell | grep -i gp-gnome

# Restart GNOME Shell (Wayland: log out/in, X11: Alt+F2 → r)

Connection issues

# Verify CLI works
globalprotect show --status

# Check CLI version
globalprotect --version

Settings not saving

# Recompile schema
cd ~/.local/share/gnome-shell/extensions/gp-gnome@totoshko88.github.io/
glib-compile-schemas schemas/

Development

# Run tests
make test

# Create distribution package
make dist

# Validate against EGO guidelines
bash tests/validate-review-guidelines.sh

Documentation

Support

Donatello Monobank

License

GPL-3.0 — Made with ❤️ in Ukraine 🇺🇦

About

Gnome extension to work with GlobalProtect CLI

Resources

Contributing

Security policy

Stars

7 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages