mirror of
https://github.com/franjsco/lscanbot
synced 2025-02-16 11:31:37 +01:00
Bump lodash from 4.17.15 to 4.17.19
Welcome to lscanbot 📱
A telegram bot to find devices on your LAN.
![](/franjsco/lscanbot/media/commit/d56e9796d8c51080f10986c32dbcd4bdfd38eb00/screenshot.png)
Install
Step by step
- Install arp-scan package on your GNU/Linux system.
- Configure arp-scan to use without sudo. (
chmod u+s
) - Clone this repository on your system.
- Install dependecies with
npm install
. - Create new bot with @BotFather on Telegram.
- Insert your API Token (app.token) into
config.json
. - Insert your Telegram ID (app.authorizedUsers) into
config.json
. - 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)
- Website: https://franjsco.github.io/
- Twitter: @franjsco
- Github: @franjsco
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
Description
Languages
JavaScript
100%