Cloudflare WARP Indicator supercharges your GNOME desktop with seamless integration for Cloudflare WARP zero-trust network connectivity. This sleek extension adds an elegant, feature-rich interface to your system tray, allowing you to connect, manage, and monitor your WARP connection with just a single click.
| One-Click Toggle: Connect or disconnect with a single click | |
| 🎨 | Familiar UI: 90% copied from the original macOS WARP GUI for seamless experience |
| 📥 | Auto-Installation: Can install WARP client if not already present |
| ⚙️ | Low Resource Usage: Minimal impact on system performance |
Get up and running with the Cloudflare WARP Indicator in just a few clicks.
This is the easiest and recommended way to get the extension:
Just click the badge above and follow the instructions on the GNOME Extensions website.
🔧 Alternative: Manual Installation (for advanced users)
If you prefer installing from source:
- Clone the repository:
git clone https://github.com/depscian/cloudflare-warp-indicator.git
- Navigate into the directory:
cd cloudflare-warp-indicator - Run the install script:
(Note: You might need to make the script executable first:
./install.sh
chmod +x install.sh)
✅ Prerequisites Checklist
Make sure your system is ready:
- GNOME Shell: Version 45 or newer.
- Cloudflare WARP Client: Must be installed. The extension can help install it if missing.
- GLib/Gio Libraries: Usually included with GNOME.
After installation, the extension is ready to use:
- Access: Click the Cloudflare icon in your system tray
- Connect/Disconnect: Toggle the switch to manage your WARP connection
- Status: The icon and label show your current connection status
- First Run: If WARP isn't detected, the extension will offer to install it for you
Interested in contributing or modifying the extension? Here's how to get started:
The codebase is organized for clarity:
cloudflarewarpindicator@depscian.com/
├── models/ # Data models and enums
├── services/ # Connection and installation services
├── utils/ # Utility functions
├── extension.js # Main extension entry point
├── indicator.js # UI implementation
└── warpController.js # Core WARP interaction logic
(Note: The actual extension files reside within the cloudflarewarpindicator@depscian.com/ directory).
- Clone the Repository:
git clone https://github.com/depscian/cloudflare-warp-indicator.git cd cloudflare-warp-indicator - Edit the Code: Modify the JavaScript files within the
cloudflarewarpindicator@depscian.com/directory using your preferred editor.
To see your modifications in action:
- Install Locally: Run the installation script to copy your modified files to the GNOME Shell extensions directory:
(This overwrites any existing installation)
./install.sh
- Reload GNOME Shell: Press
Alt+F2, typer, and pressEnter. Alternatively, disable and re-enable the extension through the GNOME Extensions app or website.
For troubleshooting, you can enable debug logging. Add const DEBUG = true; near the top of cloudflarewarpindicator@depscian.com/extension.js. Logs will appear in the system journal (journalctl /usr/bin/gnome-shell) or potentially in /tmp/warp-extension-debug.log depending on the setup. Remember to remove the debug flag before committing.
Contributions are welcome! Feel free to submit pull requests or open issues.
This project is licensed under the MIT License - see the LICENSE file for details.
Important
This extension is not affiliated, funded, or in any way associated with Cloudflare. It's an independent project designed to enhance the user experience of Cloudflare WARP on Linux.
