Skip to content

A shell script to check and log when your internet connection goes down.

License

Notifications You must be signed in to change notification settings

hanok-e/netcheck

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Netcheck

A shellscript to check and log when your internet connection goes down. Netcheck checks for internet connectivity and if its interupted, writes a log containing the time of disconnect, and length of time disconnected. Once it reconnects it will log the reconnected internet speed and continue monitoring again.

Netcheck also include an optional web interface for viewing your connection logs remotely from a web browser. You can use a service such as NGROK to allow you to see the web interface outside of your network.

Installation

git clone https://github.com/TristanBrotherton/netcheck.git
cd netcheck
chmod +x netcheck.sh
./netcheck.sh

CLI Interface

Netcheck CLI interface

Web Interface

Netcheck CLI interface

Options

netcheck.sh -h                                           Display this message
netcheck.sh -f path/my_log_file.log          Specify log file and path to use
netcheck.sh -s                                 Disable speedtest on reconnect
netcheck.sh -c                Check connection ever (n) seconds. Default is 5
netcheck.sh -u            URL/Host to check, default is http://www.google.com
netcheck.sh -w                                  Enable the remote webinteface
netcheck.sh -p                  Specify an optional port for the webinterface
netcheck.sh -i                           Install netcheck as a system service
netcheck.sh -d path/script            Specify script to execute on disconnect
netcheck.sh -r path/script             Specify script to execute on reconnect

Run as a service

You can optionally run netcheck as a system service. For systems that use systemctl (Linux) you may use its service installation script:

sudo ./netcheck.sh -i

Scripts for disconnect/reconnect events

You can optionally define actions to be executed upon disconnect or reconnect. To do so you may use the -d and -r options.

Two sample bash scripts making use of the espeak-ng text-to-speech utility are provided under the sample-scripts to showcase how these options can be used:

./netcheck.sh -d sample-scripts/disconnected.sh -r sample-scripts/reconnected.sh

About

A shell script to check and log when your internet connection goes down.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 66.9%
  • HTML 22.9%
  • CSS 10.2%