KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

wireguard-indicator

★ 179 Open GitHub ↗

An Indicator for WireGuard

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![License MIT](https://img.shields.io/badge/license-MIT-green)
![Contributors](https://img.shields.io/github/contributors-anon/atareao/wireguard-indicator)
![Last commit](https://img.shields.io/github/last-commit/atareao/wireguard-indicator)
[![CodeFactor](https://www.codefactor.io/repository/github/atareao/wireguard-indicator/badge)](https://www.codefactor.io/repository/github/atareao/wireguard-indicator)

<h1 align="center">Welcome to WireGuard Indicator 👋</h1>

<a href="https://www.atareao.es/aplicacion/wireguard-indicator" id="homepage" rel="nofollow">
<img align="right" height="128" id="icon" src="icons/wireguard-icon.svg" width="128"/>
</a>

<h2>🏠 <a href="https://www.atareao.es/aplicacion/wireguard-indicator" id="homepage">Homepage</a></h2>
WireGuard Indicator is a GNOME Shell indicator that shows the status of your WireGuard VPN.
WireGuard Indicator can enable or disable the WireGuard VPN by clicking on it.
You need superuser privileges (i.e. root access).

## Prerequisites

You need WireGuard. To install it, simply type in the terminal:

```
sudo apt install wireguard
```

Of course, you need to [configure your beloved WireGuard first](https://www.wireguard.com/quickstart/).

## Installing the WireGuard Indicator

To install the WireGuard Indicator, follow these steps:

Go to the [GNOME Extensions page](https://extensions.gnome.org/) and search for "[WireGuard Indicator](https://extensions.gnome.org/extension/3612/wireguard-indicator/)".

Enable the extension by clicking the switch.

## Setting Up

WireGuard Indicator provide two ways to connect to your wireguard vpn:

- **nmcli** 
With `nmcli` we need to add our `wg.conf` file connection first by `sudo nmcli connection import type wireguard file /path/to/your/your-wg-file.conf`, since WireGuard Indicator pick up the connection of `type=wireguard` they'll show up on the drop down and toggled right away after import (note: you may want to disable the auto connect via `nm-connection-editor` or your distro network setting).

- **systemd**  
Add wireguard to systemd by running `sudo systemctl enable wg-quick@yourconfig.service`, make sure you have your `/etc/wireguard/config.conf` in place.

## Using WireGuard Indicator

When you start **WireGuard Indicator** it appears in the Indicator Area, as you can see in the next screenshot:

![WireGuard Indicator](https://raw.githubusercontent.com/atareao/wireguard-indicator/master/screenshots/screenshot_01.png)

In this screenshot, the language is in Spanish. If there is no translation for your language, you can have the app in English.

If you enable on one of the WireGuard connections, a dialog will appear and ask you for your password to gain root privileges.

![WireGuard Indicator](https://raw.githubusercontent.com/atareao/wireguard-indicator/master/screenshots/screenshot_02.png)

You can set additional options as you can see in next screenshot:

![WireGuard Indicator](https://raw.githubusercontent.com/atareao/wireguard-indicator/master/screenshots/screenshot_03.png)

* Enable the dark theme for the WireGuard Indicator icon:

![WireGuard Indicator](https://raw.githubusercontent.com/atareao/wireguard-indicator/master/screenshots/screenshot_04.png)

* Set the `systemd` service name
* Set the check time

## Contributing to WireGuard Indicator

To contribute to **WireGuard Indicator**, please follow these steps:

1. Fork this repository.
2. Create a branch: `git checkout -b <branch_name>`.
3. Make your changes and commit them: `git commit -m '<commit_message>'`
4. Push to the original branch: `git push origin atareao/readmemaker`
5. Create the pull request.

Alternatively see the GitHub documentation on [creating a pull request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request).

## 👤 Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<table id="contributors">
	<tr id="info_avatar">
		<td id="atareao" align="center">
			<a href="https://github.com/atareao">
				<img src="https://avatars3.githubusercontent.com/u/298055?v=4" width="100px"/>
			</a>
		</td>
		<td id="dtalens" align="center">
			<a href="https://github.com/dtalens">
				<img src="https://avatars.githubusercontent.com/u/6631832?v=4" width="100px"/>
			</a>
		</td>
	</tr>
	<tr id="info_name">
		<td id="atareao" align="center">
			<a href="https://github.com/atareao">
				Lorenzo Carbonell
			</a>
		</td>
		<td id="dtalens" align="center">
			<a href="https://github.com/dtalens">
				dtalens
			</a>
		</td>
	</tr>
	<tr id="info_commit">
		<td id="atareao" align="center">
			<a href="/commits?author=atareao">
				💻
			</a>
		</td>
		<td id="dtalens" align="center">
			<a href="/commits?author=dtalens">
				🌍
			</a>
		</td>
	</tr>
</table>

wireguard-indicator

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README