mirror of
https://github.com/franjsco/lscanbot
synced 2025-02-18 20:40:35 +01:00
Bumps [js-yaml](https://github.com/nodeca/js-yaml) from 3.12.0 to 3.13.1. - [Release notes](https://github.com/nodeca/js-yaml/releases) - [Changelog](https://github.com/nodeca/js-yaml/blob/master/CHANGELOG.md) - [Commits](https://github.com/nodeca/js-yaml/compare/3.12.0...3.13.1) Signed-off-by: dependabot[bot] <support@github.com>
lscanbot
An opensource telegram bot to find devices on your LAN.
![](/franjsco/lscanbot/media/commit/3128b53f44c535da8398a86af3b699085f6c944b/screenshot.png)
The bot is written in Node.js.
Usage
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 My device; Me; 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]
Installation
In order to use this bot is required that the code is hosted on a GNU/Linux system connected to your LAN (Raspberry Pi would be a good choice)
Prerequisites
- Node.js
- npm
- GNU/Linux
Step by step
- Install arp-scan package on your 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 token (app.token) into
config.json
. - Insert your TelegramID (app.authorizedUsers) into
config.json
. - Insert your network device (scanner.interface) into
config.json
. - Start with
npm start
.
License
GPLv3
Made with ❤️ by Francesco Esposito (@frsposito)
Description
Languages
JavaScript
100%