https://github.com/bikecoders/internet_checker

Script to run it on background to check and announce when your Internet connection is down and up by emitting a sound
https://github.com/bikecoders/internet_checker

node nodejs npm npm-package rxjs

Last synced: about 1 month ago
JSON representation

Script to run it on background to check and announce when your Internet connection is down and up by emitting a sound

• Host: GitHub
• URL: https://github.com/bikecoders/internet_checker
• Owner: bikecoders
• License: mit
• Created: 2017-07-30T00:58:05.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2018-01-18T02:52:58.000Z (over 7 years ago)
• Last Synced: 2025-03-15T14:28:24.203Z (about 2 months ago)
• Topics: node, nodejs, npm, npm-package, rxjs
• Language: JavaScript
• Size: 45.9 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Internet Checker

[![npm version](https://badge.fury.io/js/internet_checker.png)](https://badge.fury.io/js/internet_checker)

Script to run it on background to check and announce when your Internet connection is down and up by emitting a sound.

> **This is very useful when your connection is not stable and you don't want to waste time checking often if your internet connection is really down.**

## How to install it

### Pre-requisites

1. You must have [`npm`](https://www.npmjs.com/) and [`node`](https://nodejs.org/en/) in your computer

2. You must have [`speak`](http://espeak.sourceforge.net/) installed

### Steps

#### From GitHub

1. Clone this repo `git clone https://github.com/bikecoders/internet_checker`

2. Step into the folder you just cloned `internet_checker`

3. Install node dependencies with `npm install`

4. Run the script with `npm start`

5. Done, now the computer will notify you when your internet is down

#### From NPM

1. Run `npm i internet_checker`

2. Step into `node_modules/internet_checker`

3. Run the script with `npm start`

## How it works ?

Once running the script make a `ping` to google (plubic dns on `8.8.8.8`) every 10 seconds, if **one of those package is lost** the script will send 10 packages in less than 10 seconds to make sure if your internet connection is down.

### Sequence Diagram

![sequence diagram](https://raw.githubusercontent.com/bikecoders/internet_checker/master/Diagrams/secuence.jpg)

## Libraries used 

- [ReactiveX](http://reactivex.io/)  - ![ReactiveX logo](http://reactivex.io/assets\/Rx_Logo_S.png) 

- [Ping](https://www.npmjs.com/search?q=ping) npm package

----------------------

> Written with [StackEdit](https://stackedit.io/).