Show HN：Whosthere：一款使用 Go 語言編寫的、具備現代化 TUI 的區域網路發現工具

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

To see all available qualifiers, see our documentation.

Local Area Network discovery tool with a modern Terminal User Interface (TUI) written in Go. Discover, explore, and understand your LAN in an intuitive way. Knock Knock.. who's there? 🚪

License

ramonvermeulen/whosthere

Folders and files

Latest commit

History

Repository files navigation

Whosthere

Local Area Network discovery tool with a modern Terminal User Interface (TUI) written in Go.
Discover, explore, and understand your LAN in an intuitive way.

Whosthere performs unprivileged, concurrent scans using mDNS
and SSDP scanners. Additionally, it sweeps the
local subnet by attempting TCP/UDP connections to trigger ARP resolution, then reads the
ARP cache to identify devices on your Local Area Network.
This technique populates the ARP cache without requiring elevated privileges. All discovered devices are enhanced with
OUI lookups to display manufacturers when available.

Whosthere provides a friendly, intuitive way to answer the question every network administrator asks: "Who's there on my network?"

Features

Installation

Or with Go:

Or build from source:

Usage

Run the TUI for interactive discovery:

Run as a daemon with HTTP API:

Additional command line options can be found by running:

Platforms

Whosthere is supported on the following platforms:

Key bindings (TUI)

Environment Variables

Configuration

Whosthere can be configured via a YAML configuration file.
By default, it looks for the configuration file in the following order:

When not running in TUI mode, logs are also written to the console output.

Example of the default configuration file:

Daemon mode HTTP API

When running Whosthere in daemon mode, it exposes an very simplistic HTTP API with the following endpoints:

Themes

Theme can be configured via the configuration file, or at runtime via the CTRL+t key binding.
A complete list of available themes can be found here, feel free to open a PR to add your own theme!

Example of theme configuration:

When the name is set to custom, the other color options can be used to create your own custom theme.

Logging

Logs are written to the application's state directory:

When not running in TUI mode, logs are also output to the console.

Known Issues

For clipboard functionality to work:

Runtime requirements:

Build requirements (when compiling from source):

Disclaimer

Whosthere is intended for use on networks where you have permission to perform network discovery and scanning,
such as your own home network. Unauthorized scanning of networks may be illegal and unethical.
Always obtain proper authorization before using this tool on any network.

Contributing

Contributions and suggestions such as feature requests, bug reports, or improvements are welcome!
Feel free to open issues or submit pull requests on the GitHub repository.
Please make sure to discuss any major changes on a Github issue before implementing them.

About

Local Area Network discovery tool with a modern Terminal User Interface (TUI) written in Go. Discover, explore, and understand your LAN in an intuitive way. Knock Knock.. who's there? 🚪

Topics

Resources

License

Uh oh!

There was an error while loading. Please reload this page.

Stars

Watchers

Forks

Releases

  2

Packages

  0

Uh oh!

There was an error while loading. Please reload this page.

Contributors

  4

Uh oh!

There was an error while loading. Please reload this page.

Languages

Footer

Footer navigation