Radar Notif

A desktop notification system that monitors internet connectivity across various Iranian ISPs using ArvanCloud's Radar service.

⚠️ Known Issue

Status: Currently Not Working

The ArvanCloud Radar API is now protected by ArvanCDN's bot shield (Arcshield), which requires JavaScript execution to generate valid cookies. We need to work on this later. If you can solve it sooner, please make a PR!

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.

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

./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:

git clone https://github.com/yourusername/radar-notif.git
cd radar-notif

2. Build for your platform:

For all platforms:

make all

Or build for a specific platform:

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:

./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 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 for cross-platform notifications

---