Go to file
Francesco Esposito d56e9796d8
Merge pull request #5 from franjsco/dependabot/npm_and_yarn/lodash-4.17.19
Bump lodash from 4.17.15 to 4.17.19
2020-07-19 16:55:41 +02:00
src update dirs/readme 2020-05-13 00:59:15 +02:00
.gitignore add .gitignore 2019-02-12 21:50:37 +01:00
LICENSE Initial commit 2018-09-24 21:21:53 +02:00
README.md update dirs/readme 2020-05-13 00:59:15 +02:00
config.json Initial commit 2018-09-24 21:21:53 +02:00
package-lock.json Bump lodash from 4.17.15 to 4.17.19 2020-07-16 10:31:37 +00:00
package.json update dirs/readme 2020-05-13 00:59:15 +02:00
screenshot.png update dirs/readme 2020-05-13 00:59:15 +02:00


Welcome to lscanbot 📱

Maintenance License: GPL--3.0 Twitter: franjsco

A telegram bot to find devices on your LAN.


Step by step

  1. Install arp-scan package on your GNU/Linux system.
  2. Configure arp-scan to use without sudo. (chmod u+s)
  3. Clone this repository on your system.
  4. Install dependecies with npm install.
  5. Create new bot with @BotFather on Telegram.
  6. Insert your API Token (app.token) into config.json.
  7. Insert your Telegram ID (app.authorizedUsers) into config.json.
  8. Insert your Network Device (scanner.interface) into config.json.


Start server:

npm run start

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)

example: (/add Motorola Moto G6; Frank; AB:CC:MY:MC:AD)

After that, you can scan:


It will send back the devices connected to your network.


/remove [MAC Address]


👤 franjsco (Francesco Esposito)

Show your support

Give a if this project helped you!

📝 License

Copyright © 2020 franjsco (Francesco Esposito).
This project is GPL--3.0 licensed.

This README was generated with ❤️ by readme-md-generator