KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

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

hyprltm-net

★ 45 Open GitHub ↗

A lightweight, Rofi-based network manager GUI built for the HyprLTM Hyprland setup. Easily manage Wi-Fi, Ethernet, and VPN connections with minimal dependencies.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">
  <img src="hyprltm-net.svg" width="80" alt="HyprLTM-Net Logo"/>
  <br>
  HyprLTM-Net
</h1>

<p align="center">
  <strong>A high-performance network management interface (GUI) for Hyprland, powered by Rofi and NetworkManager.</strong>
</p>

[![HyprLTM-Net Demo](https://img.youtube.com/vi/k2QlRe5Cvls/maxresdefault.jpg)](https://youtu.be/k2QlRe5Cvls)

<p align="center"><em>HyprLTM-Net Demo (YouTube)</em></p>

![Gradient](https://raw.githubusercontent.com/hyprltm/hyprltm-net/stable/assets/gradient.svg)

## Features

### Wi-Fi Management
- Scan for nearby networks
- Connect to new or hidden SSIDs
- Manage saved connections & passwords

</td>
<td width="50%" valign="top">

### Wired Profiles
- Switch between Ethernet configurations
- View connection status

</td>
</tr>
<tr>
<td width="50%" valign="top">

### VPN Support
- **WireGuard** & **OpenVPN** integration
- Import `.conf` or `.ovpn` files directly

</td>
<td width="50%" valign="top">

### Advanced Controls
- **Airplane Mode** toggle
- **QR Code Sharing** for Wi-Fi
- **Hotspot Manager**
- **Bluetooth Tethering**

</td>
</tr>
</table>

### Smart Installation
- **Distro Detection**: Auto-installs dependencies (Arch, Fedora, openSUSE, NixOS)
- **Desktop Entry**: Creates launcher menu entry & icon

### Robust Feedback
`hyprltm-net` includes a complete visual feedback system ensuring you never miss a status update.
- **Universal Semantic Styling**: Red (Error), Orange (Warning), Green (Success), and Blue (Info).
- **Blocking Dialogs**: Critical errors (e.g. Wrong Password) require user action to proceed.
- **Fallback Notification System**: If no notification service (like `dunst`) is running, the script automatically falls back to Rofi dialogs.

#### Feedback Gallery
<div align="center">
  <table width="80%">
    <tr>
      <td align="center">
        <img src="assets/error_dialog.png" width="100%"><br>
        <sub><b>Error (Red)</b>: Critical failures (like a wrong password or failed connection) trigger a blocking dialog. This ensures errors are never ignored silently.</sub>
      </td>
    </tr>
  </table>
  <br>
  <table width="80%">
    <tr>
      <td align="center">
        <img src="assets/warning_dialog.png" width="100%"><br>
        <sub><b>Warning (Orange)</b>: Alerts the user to important states, such as "No Notification Service found," suggesting a fallback to Rofi dialogs.</sub>
      </td>
    </tr>
  </table>
  <br>
  <table width="80%">
    <tr>
      <td align="center">
        <img src="assets/success_dialog.png" width="100%"><br>
        <sub><b>Success (Green)</b>: Immediate visual confirmation when a connection is successfully established.</sub>
      </td>
    </tr>
  </table>
  <br>
  <table width="80%">
    <tr>
      <td align="center">
        <img src="assets/info_dialog.png" width="100%"><br>
        <sub><b>Info (Blue)</b>: Contextual information, such as confirming that "Airplane Mode" has been enabled.</sub>
      </td>
    </tr>
  </table>
</div>

![Gradient](https://raw.githubusercontent.com/hyprltm/hyprltm-net/stable/assets/gradient.svg)

## Menu Structure

```
Main Menu
├── Wi-Fi
│   ├── Status (Current Connection) -> View Details (IP, Signal, Mac...)
│   ├── Toggle (Enable / Disable)
│   ├── Available Networks (SSID List)
│   │   ├── [New Secure Network]
│   │   │   └── Enter Password
│   │   │       └── Password Actions (Show/Hide/Edit/Confirm)
│   │   └── [Saved Network]
│   │       ├── Autoconnect (Toggle)
│   │       ├── Connect / Disconnect Now
│   │       ├── IPv4 Configuration
│   │       ├── IPv6 Configuration
│   │       ├── Forget Connection
│   │       ├── Rename Connection
│   │       ├── Edit Password
│   │       ├── MAC Randomization (Toggle)
│   │       └── Share via QR Code
│   ├── Hotspot Manager
│   │   ├── Create New Hotspot
│   │   └── Manage Saved Hotspots
│   │       └── [Hotspot Profile] -> (Toggle, Edit Password, Rename, Delete)
│   ├── Connect to Bluetooth Tether
│   │   └── [Discovered/Paird Device] -> (Auto-pair & connect / Connect)
│   ├── Known Connections (Saved Profiles)
│   │   └── [Saved Wi-Fi Profile]
│   │       ├── Autoconnect (Toggle)
│   │       ├── Connect / Disconnect Now
│   │       ├── IPv4 Configuration
│   │       ├── IPv6 Configuration
│   │       ├── Forget Connection
│   │       ├── Rename Connection
│   │       ├── Edit Password
│   │       ├── MAC Randomization (Toggle)
│   │       └── Share via QR Code
│   └── Connect to a hidden network
├── Wired
│   ├── [Available Interface] -> Connect
│   └── [Saved Profile] -> (Same options as Wi-Fi)
├── VPN
│   ├── [VPN Profile]
│   │   ├── Autoconnect (Toggle)
│   │   ├── Connect / Disconnect
│   │   ├── IPv4 / IPv6 Configuration
│   │   ├── Forget Connection
│   │   ├── Rename Connection
│   │   └── Edit Password (if applicable)
│   └── Import Configuration
├── Saved Connections
│   └── [List of All Profiles]
│       ├── Autoconnect (Toggle)
│       ├── Connect / Disconnect Now
│       ├── IPv4 Configuration
│       ├── IPv6 Configuration
│       ├── Forget Connection
│       ├── Rename Connection
│       ├── Edit Password
│       └── Share via QR Code
├── Status
│   ├── Active Connection Details
│   ├── All Device Status (List)
│   └── Speed Test (Download / Upload / Ping)
└── Airplane Mode
    ├── Full Airplane Mode (Blocks all RF / Bluetooth)
    └── Wi-Fi Only
```

![Gradient](https://raw.githubusercontent.com/hyprltm/hyprltm-net/stable/assets/gradient.svg)

## Prerequisites

![Gradient](https://raw.githubusercontent.com/hyprltm/hyprltm-net/stable/assets/gradient.svg)

## Installation

### 1. One-Line Installation
```bash
bash <(curl -s https://raw.githubusercontent.com/hyprltm/hyprltm-net/main/setup.sh)
```
The script will auto-detect your distribution, install dependencies, and set up the menu.

<details>
<summary><strong>Manual Installation</strong></summary>

If you prefer to install manually:
```bash
mkdir -p ~/.local/bin && cp hyprltm-net.sh ~/.local/bin/hyprltm-net && chmod +x ~/.local/bin/hyprltm-net
mkdir -p ~/.config/rofi/themes/ && cp *.rasi ~/.config/rofi/themes/
```

**Keybind:** Add to your Hyprland config:

- **hyprlang (legacy)** — `~/.config/hypr/hyprland.conf`:
  ```ini
  bind = SUPER, N, exec, hyprltm-net
  ```
- **Lua (0.55+)** — `~/.config/hypr/hyprland.lua`:
  ```lua
  hl.bind("SUPER + N", hl.dsp.exec_cmd("hyprltm-net"))
  ```

**Waybar:** Add to your `network` module in `~/.config/waybar/config.jsonc`:
```json
"on-click": "hyprltm-net"
```
</details>

![Gradient](https://raw.githubusercontent.com/hyprltm/hyprltm-net/stable/assets/gradient.svg)

## Configuration & Customization

### Custom Icons

HyprLTM-Net allows you to completely override any icon used in the UI with your own preferred Unicode/Nerd Font characters or Emojis.

1. Copy the example configuration file:
   ```bash
   mkdir -p ~/.config/hyprltm
   cp hyprltm-net.conf.example ~/.config/hyprltm/hyprltm-net.conf
   ```
2. Edit `~/.config/hyprltm/hyprltm-net.conf` and uncomment any `icon_...` variables you want to change (e.g., `icon_wifi_full="🚀"`).
3. Relaunch HyprLTM-Net and your new icons will instantly apply!

*(Note: The default icons used in the script are standard Material Design Icons from the JetBrains Nerd Font family. They map to the Private Use Area (PUA) of Unicode, which is why they may look like generic square characters in text editors that don't have a Nerd Font applied).*

![Gradient](https://raw.githubusercontent.com/hyprltm/hyprltm-net/stable/assets/gradient.svg)

### Theming

HyprLTM-Net uses the **LTMNight** color palette. Customize appearance by editing `~/.config/rofi/themes/ltmnight.rasi`.

#### Theme Selection via Environment Variables

Override the theme at runtime without modifying config files:

Search order: env var path → `~/.config/rofi/themes/` → `~/.config/hyprltm/themes/` → `/usr/share/rofi/themes/` → `/etc/xdg/rofi/themes/` → `~/.local/share/rofi/themes/` → script directory → rofi built-in fallback.

If `ROFI_NETWORK_MANAGER_THEME` points to a missing or broken path, the script falls back through the search chain.

```bash
# Use a custom theme name
export ROFI_THEME_NAME="my-custom-theme"

# Or point directly to a theme file
export ROFI_NETWORK_MANAGER_THEME="$HOME/.config/rofi/themes/my-theme.rasi"

./hyprltm-net.sh
```

![Gradient](https://raw.githubusercontent.com/hyprltm/hyprltm-net/stable/assets/gradient.svg)

## ❤️ Support the Project

If you find this tool helpful, there are many ways to support the project:

### Financial Support
If you'd like to support the development financially:

### Contribute & Support
Financial contributions are not the only way to help! Here are other options:
- **Star the Repository**: It helps more people find the project!
- **Report Bugs**: Found an issue? Open a ticket on GitHub.
- **Suggest Features**: Have a cool idea? Let me know!
- **Share**: Tell your friends!

Every bit of support helps keep the project alive and ensures I can spend more time developing open source tools for the Linux community!

![Gradient](https://raw.githubusercontent.com/hyprltm/hyprltm-net/stable/assets/gradient.svg)

## License

**Created by [Djalel Oukid (sniper1720)](https://github.com/sniper1720)** and distributed under the **GPL-3.0 License**.

*Check out more Linux & Open Source content on my [website!](https://www.linuxtechmore.com)*

hyprltm-net

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README