https://github.com/ali-hossam/raqeb
A modern Linux system monitoring application using qt6/qml
https://github.com/ali-hossam/raqeb
linux monitoring-tool qml qt6 system-monitoring ubuntu
Last synced: 6 months ago
JSON representation
A modern Linux system monitoring application using qt6/qml
- Host: GitHub
- URL: https://github.com/ali-hossam/raqeb
- Owner: Ali-Hossam
- Created: 2024-07-10T13:09:17.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-22T14:49:16.000Z (almost 2 years ago)
- Last Synced: 2025-02-14T13:39:54.510Z (over 1 year ago)
- Topics: linux, monitoring-tool, qml, qt6, system-monitoring, ubuntu
- Language: QML
- Homepage:
- Size: 39.8 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Raqeb - System Monitoring Application
Raqeb is a system monitoring application designed for Ubuntu that monitors CPU and GPU temperatures, usage, and disk and memory usage. It is specifically tailored to work with NVIDIA GPUs and requires the `nvidia-smi` utility for GPU monitoring.
## Features
- Monitor CPU temperatures and usage
- Monitor GPU temperatures and usage (NVIDIA only)
- Monitor disk usage
- Monitor memory usage
## Requirements
- Ubuntu operating system
- NVIDIA GPU and drivers
- `nvidia-smi` utility
## Installation
### Setup Branch
To install a packaged version of Raqeb, follow these steps:
1. **Clone the Repository in HOME dir:**
```bash
git clone -b setup https://github.com/Ali-Hossam/Raqeb.git
cd Raqeb
```
2. **Run the Setup Script:**
```bash
sh install.sh
```
This script will copy the necessary files to the appropriate locations and create a desktop entry for Raqeb.
### Source Code Branch
To work with the source code and build Raqeb from scratch, follow these steps:
1. **Clone the Repository:**
```bash
git clone -b main https://github.com/Ali-Hossam/Raqeb.git
cd raqeb
```
2. **Open the Project in Qt Creator:**
- Launch Qt Creator.
- Open the project by selecting the `raqeb.pro` file.
- Configure the build settings as needed.
- Build and run the project from within Qt Creator.
## Usage
After installation, you can launch Raqeb from the applications menu. Look for the Raqeb icon and click on it to start monitoring your system.
### Running from the Command Line
If you want to run Raqeb directly from the command line, navigate to the installation directory and execute the main script:
```bash
cd /path/to/raqeb
sh Raqeb.sh
```
## Troubleshooting
### Common Issues
1. **nvidia-smi not found:**
Ensure that the NVIDIA drivers and `nvidia-smi` utility are installed and accessible from the command line:
```bash
sudo apt install nvidia-driver-
sudo apt install nvidia-utils-
```
2. **Application not appearing in the application menu:**
Ensure the desktop entry was created correctly. You can manually copy the `.desktop` file to the appropriate directory:
```bash
cp Raqeb.desktop ~/.local/share/applications/
```
## Contributing
Contributions are welcome! If you would like to contribute to Raqeb, please follow these steps:
1. Fork the repository.
2. Create a new branch for your feature or bugfix.
3. Commit your changes.
4. Push your branch and create a pull request.
---