Skip to content

Repository files navigation

🌐 Internet Connection Monitor daemon (ICMd) πŸ”Œ

Version Timestamp Updated on OS Supported on OS
2.6 2026-06-08 23:14 πŸͺŸ 🍎πŸͺŸ

Real-Time Client Monitoring Dashboard

This dashboard provides real-time monitoring of connected clients, displaying their status based on recent updates. Each client is identified by an ID, name, IP address, last update timestamp, and elapsed time since the last update.

Key Features

βœ… Traffic Light System – Clients are color-coded based on their last update time:

  • 🟒 Green (Recently updated)
  • 🟑 Yellow (Moderate delay)
  • πŸ”΄ Red (Critical delay)

βœ… Status Tracking – Displays whether a client's condition has been met.

βœ… Server Connection Indicator – Shows if the backend is reachable:

  • 🟒 Connected
  • πŸ”΄ Disconnected

βœ… Alarm System – Plays a sound when a critical condition is detected.

βœ… Ignore Functionality – Clients can be marked as ignored, preventing them from affecting alerts and status colors.

βœ… Global Background Color – The dashboard background adapts to the most critical client state.

βœ… Persistent Settings – Ignored clients are stored in localStorage and synced with the backend on page load.

βœ… Counters – Displays statistics such as:

  • Total active/inactive clients
  • Number of clients in each status category (OK, Warning, Critical)

βœ… Shared Content Directory πŸ†•

A configurable external directory (environment variable: SHARED_DIR) can be used to publish content through the web application. Files placed in this directory are automatically available to authorized users and may include:

  • HTML pages
  • Images
  • PDF documents
  • Other approved static resources

Because the directory is located outside the repository, content can be updated independently of the application source code and deployment process.

This system ensures efficient client tracking, immediate status awareness, and a clear visual representation of critical conditions. πŸš€

How to use it

  1. πŸ’Ύ Install ICMd using CMD on πŸͺŸWindows or Terminal/iTerm on 🍎MacOS

    git clone https://github.com/nelbren/ICMd.git

  2. πŸ’Ώ Switch to the ICM directory

    cd ICMd

  3. πŸ› οΈ Install python virtual environment and required modules

    • πŸͺŸ Windows

      install.bat

    • 🍎 MacOS

      ./install.bash

  4. 🎚️ Configure Canvas Access Settings

    • πŸͺŸ Windows

      config.bat

    • 🍎 MacOS

      ./config.bash

  5. πŸƒ Run the program

    • πŸͺŸ Windows:

      run.bat

    • 🍎MacOS:

      ./run.bash

  6. 🌐 Go to the page and πŸ§™ Wait for the magic

    ICMd

MADE WITH πŸ’› BY NELBREN

About

🌐 Internet Connection Monitor daemon (ICMd) πŸ”Œ

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages