Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/erffy/zig-waybar-contrib
✨ Sleek and lightweight Waybar modules built with Zig
https://github.com/erffy/zig-waybar-contrib
sway waybar waybar-contrib waybar-module zig ziglang zls
Last synced: 29 days ago
JSON representation
✨ Sleek and lightweight Waybar modules built with Zig
- Host: GitHub
- URL: https://github.com/erffy/zig-waybar-contrib
- Owner: erffy
- License: gpl-3.0
- Created: 2025-01-12T17:08:03.000Z (29 days ago)
- Default Branch: main
- Last Pushed: 2025-01-12T17:39:14.000Z (29 days ago)
- Last Synced: 2025-01-12T18:27:54.920Z (29 days ago)
- Topics: sway, waybar, waybar-contrib, waybar-module, zig, ziglang, zls
- Language: Zig
- Homepage:
- Size: 27.3 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> [!IMPORTANT]
> I am new to Zig, so some modules may take a long time to add/update. I would appreciate your help 🥰.
# zig-waybar-contrib
A collection of high-performance Waybar modules written in Zig.
## Overview
`zig-waybar-contrib` provides efficient, lightweight modules for [Waybar](https://github.com/Alexays/Waybar) by leveraging the performance and safety features of [Zig](https://ziglang.org/). These modules are optimized and focus on system monitoring and status reporting.
## Features
- **High Performance**: Optimized implementation in Zig for minimal resource usage
- **Modular Design**: Use only the modules you need
- **Real-time Monitoring**: Accurate system metrics with minimal overhead
## Available Modules
- All modules write a single line json output.
- All modules are compiled with LTO and ReleaseFast optimizations. See the [build](./build.zig) file for details.
### Updates Module
Tracks available system updates on Arch Linux
- Status: ✅ Implemented
- Dependencies: `pacman-contrib`, `fakeroot`
- Note: Compatible only with Arch-based distributions
### GPU Module
Monitors GPU statistics and performance
- Status: ✅ Implemented | ⚠️ Partially Working
- Known Issues: Path resolution errors may affect functionality
- Supports: AMD GPUs (RX series)
### Memory Module
Tracks system memory usage and statistics
- Status: ✅ Implemented
- Features: Real-time memory monitoring
- Displays: Used/Total memory, usage percentage
### Ping Module
Network latency monitoring
- Status: ✅ Implemented
- Features: Configurable ping targets
- Displays: Current network latency
### CPU Module
CPU usage and temperature monitoring
- Status: 🚧 In Development
- Planned Features: Usage percentage, temperature, frequency
## Installation
- Download the latest release from the [GitHub Releases](https://github.com/erffy/zig-waybar-contrib/releases)
## Configuration
Add modules to your Waybar configuration (`~/.config/waybar/config`):
```json
{
"modules-right": [
"custom/updates",
"custom/gpu",
"custom/memory",
"custom/ping"
],
"custom/updates": {
"exec": "path/to/updates-module",
"return-type": "json",
"interval": 3600
}
// Add other module configurations as needed
}
```
## Building from Source
> Requirements
- Zig (0.13)
```bash
git clone https://github.com/erffy/zig-waybar-contrib
cd zig-waybar-contrib
zig build
```
## Contributing
Contributions are welcome! Please consider:
- Adding new modules
- Improving existing modules
- Fixing bugs
- Improving documentation
## 🛡️ License
This project is licensed under the GNU General Public License v3.0. See the [LICENSE](./LICENSE) file for details.
---
### ✨ Made with ❤️ by Me