Skip to content

nelbren/ICM

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

50 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ Internet Connection Monitor (ICM) ๐Ÿ”Œ

Version Date Updated on OS Supported on OS md5sum
6.2 2025-09-04 14:11 ๐ŸŽ ๐ŸŽ๐ŸชŸ๐Ÿง caaea811e32cf98a42b3c7078da63d03

A bash script for ๐ŸชŸWindows (using git bash), ๐ŸŽMacOS and ๐ŸงLinux that continuously checks the internet connection, keeps a log of each check, and if it identifies an internet connection, it takes evidence (web access, open ports, ping, access address information, screenshot and clipboard content capture). Upon completion it creates a TGZ file with the log and all captured evidence.

How to use it:

  1. ๐Ÿ’พ Install ICM using git bash on ๐ŸชŸWindows or Terminal/iTerm on ๐ŸŽMacOS or Terminal on ๐ŸงLinux:

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

  2. ๐Ÿ’ฟ Switch to the directory

    • ICM if running alone:

      cd ICM

    • Project

      cd PROJECT

      NOTE: Please use git init in this directory.

  3. ๐Ÿƒ Run the script:

    • ๐ŸŒ With connection to ICMd

      • With Git:

        Run the alias: ICM IP-OF-ICMDd ID

      • Without Git:

        Run the alias: ICM IP-OF-ICMDd ID NOGIT

    • ๐Ÿ’ป Alone (Without connection to ICMd)

      ./ICM.bash

  4. ๐Ÿง™ Wait for the magic!

  5. ๐Ÿ›‘ Stop the script

    Control โž• C

  6. Review logs and evidence

    In the user's home there is a file called ICM.tgz with the log and evidence, sorted by day and the number of execution process.

  7. Troubleshooting for ๐ŸชŸWindows | ๐ŸŽMacOS

    • ๐ŸŒ Enable Internet

      Run the alias: $ INTERNET_ENABLE

    • ๐Ÿšซ Disable Internet

      Run the alias: $ INTERNET_DISABLE

MADE WITH ๐Ÿ’› BY NELBREN

About

๐ŸŒ Internet Connection Monitor (ICM) ๐Ÿ”Œ

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •