franjsco
/
lscanbot
mirror of https://github.com/franjsco/lscanbot
1
0
Fork 0
Code Issues Releases Wiki Activity
4 Commits 11 Branches 2 Tags 2.4 MiB
JavaScript 100%
Go to file
Francesco Esposito 05de05cef5 Update README.md 2018-09-24 21:24:31 +02:00
LICENSE Initial commit 2018-09-24 21:21:53 +02:00
README.md Update README.md 2018-09-24 21:24:31 +02:00
config.json Initial commit 2018-09-24 21:21:53 +02:00
db.js Initial commit 2018-09-24 21:21:53 +02:00
index.js Initial commit 2018-09-24 21:21:53 +02:00
logger.js Initial commit 2018-09-24 21:21:53 +02:00
package-lock.json Initial commit 2018-09-24 21:21:53 +02:00
package.json Initial commit 2018-09-24 21:21:53 +02:00
scanner.js Initial commit 2018-09-24 21:21:53 +02:00
utils.js Initial commit 2018-09-24 21:21:53 +02:00

README.md

lscanbot

An opensource telegram bot to find devices on your LAN.

The bot is written in Node.js.

Usage

lscanbot scans devices with arp-scan, showing only devices registered in the inventory.

Before scanning, you must insert the devices into the inventory (to track it):

/add [Device name] ; [Owner] ; [MAC Address]

(use ; to split arguments)

After that, you can scan:

/scan

It will send back the devices connected to your network.

Installation

In order to use this bot is required that the code is hosted on a linux system connected to your LAN (Raspberry Pi would be a good choice)

Prerequisites

  • Node.js
  • npm
  • GNU/Linux

Step by step

  1. Install arp-scan package on your linux system.
  2. Configure arp-scan to use without sudo. (chmod u+s)
  3. Clone this repository on your system.
  4. Install dependeces with npm install.
  5. Create new bot with BotFather on Telegram.
  6. Insert your token (app.token) into config.json.
  7. Insert your TelegramID (app.authorizedUsers) into config.json.
  8. Insert your network device (scanner.interface) int config.json.
  9. Start withnpm start.

License

GPLv3

Made with ❤️ by Francesco Esposito (@f3sposito)