franjsco
/
lscanbot
mirror of https://github.com/franjsco/lscanbot
1
0
Fork 0
Code Issues Releases Wiki Activity
22 Commits 11 Branches 2 Tags 2.4 MiB
JavaScript 100%
Go to file
franjsco 517d3ea4e9 update dirs/readme 2020-05-13 00:59:15 +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 update dirs/readme 2020-05-13 00:59:15 +02: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

README.md

Welcome to lscanbot 📱

Maintenance License: GPL--3.0 Twitter: franjsco

A telegram bot to find devices on your LAN.

Install

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.

Usage

Start server:

npm run start

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

Scan

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:

/scan

It will send back the devices connected to your network.

Remove

/remove [MAC Address]

Author

👤 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