The very basic ruby gem to scan your LAN for devices
Based on nmap.
require 'lan_scanner'
# examples with explicit default parameters
devices = LanScanner.scan_devices network: '192.168.178.0/24'
# => [LanScanner::Device, LanScanner::Device, ...]
devices.each do |d|
puts "=================================================="
puts "Found device on #{d.remote_address}"
puts
puts "Hostname: #{d.host_name}"
puts
# =================================================="
# Found device on 192.168.178.20
#
# Hostname: Windows-PC
#
endrequire 'lan_scanner'
devices = LanScanner.scan_device_states %w[192.168.178.1 192.168.178.22 192.168.178.44], expensive: true
# => [LanScanner::Device, LanScanner::Device, ...]
devices.each do |d|
puts "#{d.remote_address} -> #{d.host_name} (#{d.state})"
end
# 192.168.178.1 -> server.domain (up)
# 192.168.178.22 -> mycomputer.domain (up)
# 192.168.178.44 -> (down)This gem is based on nmap. So you need to install nmap before and ensure it is available via command line (added to PATH environment variable).
To check if you have installed nmap correctly, run the following command on a terminal
nmap --version
and you should get some version information. After, you are ready to install the ruby gem.
Add this line to your application's Gemfile:
gem 'lan_scanner'And then execute:
$ bundle install
Or install it yourself by:
$ gem install lan_scanner
Check out the doc at RubyDoc https://www.rubydoc.info/gems/lan_scanner
Bug reports and pull requests are welcome on GitHub at https://github.com/magynhard/lan_scanner. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.