https://github.com/ohmydevops/arvancloud-radar-notif
📡 Tell me about iran internet outages in realtime
https://github.com/ohmydevops/arvancloud-radar-notif
censorship golang internet monitoring outage
Last synced: 9 days ago
JSON representation
📡 Tell me about iran internet outages in realtime
- Host: GitHub
- URL: https://github.com/ohmydevops/arvancloud-radar-notif
- Owner: ohmydevops
- License: mit
- Created: 2025-07-11T12:01:16.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-07-11T13:57:08.000Z (3 months ago)
- Last Synced: 2025-07-11T15:07:39.883Z (3 months ago)
- Topics: censorship, golang, internet, monitoring, outage
- Language: Go
- Homepage: https://radar.arvancloud.ir/
- Size: 166 KB
- Stars: 10
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Radar Notif
A desktop notification system that monitors internet connectivity across various Iranian ISPs using ArvanCloud's Radar service.
## Features
- Real-time monitoring of multiple ISPs
- Desktop notifications for internet outages and recoveries
- Cross-platform support (Linux, Windows, macOS)
- Concurrent monitoring of multiple ISPs
- Configurable service monitoring (currently set to Google)
## Download
You can download the latest pre-built binaries for Linux, Windows, and macOS from the [Releases page](https://github.com/ohmydevops/arvancloud-radar-notif/releases).
## Command Line Options
You can use the following flags when running the executable:
- `--help` Show help message and available services
- `--service=N` Monitor a specific service directly (N is the service number)
### Available Services
1. google
2. wikipedia
3. playstation
4. bing
5. github
6. digikala
7. divar
8. aparat
### Examples
```bash
./build/radar-linux # Interactive mode (asks for service)
./build/radar-linux --service=3 # Monitor playstation directly
./build/radar-linux --help # Show help and available services
```
## Prerequisites (to build on your machine)
- Go 1.16 or higher
- Make (for building)
## Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/radar-notif.git
cd radar-notif
```
2. Build for your platform:
For all platforms:
```bash
make all
```
Or build for a specific platform:
```bash
make linux # For Linux
make windows # For Windows
make mac # For macOS
```
The built executables will be available in the `build` directory.
## Usage
Simply run the executable for your platform:
```bash
./build/radar-linux # On Linux
./build/radar-mac # On macOS
./build/radar-windows.exe # On Windows
```
The application will:
- Start monitoring the configured ISPs every minute
- Show desktop notifications when internet connectivity issues are detected
- Display notifications when connectivity is restored
- Print real-time status updates in the terminal
## Monitored ISPs
- Sindad (Multiple locations)
- Bertina
- AbrBaran
- Tehran Network
- HostIran
- ParsOnline
- Afranet
- MCI
- Irancell
## Common Issues
1. Notification not working:
- Make sure you have notification permissions enabled on your system
- Verify that the `icon.png` file is in the same directory as the executable
2. Build errors:
- Ensure you have Go 1.16 or higher installed
- Run `go mod tidy` to resolve any dependency issues
3. Runtime errors:
- Check your internet connection
- Verify that ArvanCloud's Radar service is accessible
For more issues, please check the [Issues](https://github.com/yourusername/radar-notif/issues) page.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is open source and available under the MIT License.
## Acknowledgments
- Thanks to ArvanCloud for providing the Radar API
- Uses [beeep](https://github.com/gen2brain/beeep) for cross-platform notifications
---
