SwitchMiner

Know what’s plugged into every port.

SwitchMiner scans your Cisco and Arista switches over SNMP and lists every device on every port: MAC address, IP address, computer name and VLAN. It exports the map to Excel or CSV. Free and open source, with a Windows GUI and console programs for Windows and Linux.

Download 5.10 for Windows Download 5.10 for Linux (console)

Free and open source (GPLv3). Rated 4.8 out of 5 from 5 reviews on SourceForge.

The SwitchMiner Windows program after scanning a switch, with a table of ports showing description, status, last change, speed, duplex, MTU, VLAN and VLAN name, and a Device Info panel on the right
The SwitchMiner Windows GUI after a scan. All names and addresses are sample data.

From one switch address to a full port map

Give SwitchMiner a switch and it does the walking. It follows CDP to neighboring switches, so a whole closet or floor can be mapped from a single starting point.

  1. Point it at your switches

    Scan one switch, or load a text file with a batch of them. Several switches are scanned at the same time, and you choose how many threads to use. If you have routers, SwitchMiner can also fill in IP addresses and computer names.

  2. It reads them over SNMP

    SNMP v1, v2c and v3 are supported, including MD5 and SHA authentication and DES and AES (128, 192 and 256-bit) privacy. SwitchMiner pulls port status, VLANs, trunks and the MAC addresses on each port, then looks up IP addresses and computer names. Arista switches are supported, and the vendor is detected automatically.

  3. It follows CDP and LLDP neighbors

    Neighboring switches are discovered through CDP and LLDP and scanned too, with no need to list them by hand. Exclude patterns keep it from wandering into devices you don’t want scanned.

  4. You get a spreadsheet

    Results are saved as an Excel workbook with one sheet per switch and a final Inventory sheet, or as a .csv file. The header row is frozen, filters are on, and problem ports are highlighted.

What SwitchMiner finds on each port

The port

  • Interface name and description
  • Operational status and last change
  • Speed and duplex, operational and admin
  • Interface MTU
  • Error counters, with high counts highlighted
  • Spanning tree state, so blocked uplinks are visible
  • A flag on access ports with more than 3 MAC addresses (a switch or hub?)

VLANs

  • VLAN number, data and voice
  • VLAN name, data and voice

The devices on it

  • Every MAC address, so you see the PC and the phone behind it
  • OUI manufacturer, with a built-in download of the current MAC vendor list
  • IP addresses
  • DNS and NBT computer names
  • User and domain info

Neighbors and scanning

  • CDP and LLDP neighbor details for uplinks and connected switches
  • Ping sweep before the scan
  • Uplink port consolidation
  • Search for one MAC address to find its switch port
  • Inventory sheet with model, serial number, software version and uptime for every switch and stack member

What network engineers say

Best Cisco switch port mapping program out there! THIS ONE WORKS.

This program works - and fast.

Works great, helped me debug a switch.

Read all reviews on SourceForge

Release news

Older notes and every download are on the SourceForge news page.

  1. SwitchMiner 5.10

    Adds Arista switch support, an Inventory sheet with model, serial number, software version and uptime, a Port Flag column for access ports with more than 3 MAC addresses, and a formatted Excel report that highlights err-disabled and blocked ports. Fixes error counters that could show negative numbers. See the full list of changes.

  2. SwitchMiner 5.00

    One code base, three programs: a Windows GUI with saved SNMP profiles and one tab per switch, a Windows command-line version, and a portable Linux command-line version that needs no installation. Read the full announcement.

  3. SwitchMiner 4.21

    Fixed a bug with certain switch models running IOS versions that mishandle unsupported OIDs, and fixed a crash.

  4. SwitchMiner GUI 4.20

    Added a device info sidebar and fixed various bugs.

  5. SwitchMiner GUI 4.10

    Added support for SNMP v3 and fixed various other bugs.

  6. SwitchMiner GUI 4.00

    A Win32 GUI version of the product.

Common questions

Quick answers about mapping switch ports with SwitchMiner. For anything else, ask on the discussion board.

How do I find which switch port a device is plugged into?

Scan the switch with SwitchMiner. It reads the MAC addresses learned on every port over SNMP and matches them to IP addresses and computer names, so you can see what is on each port. To look up a single device, use the --search option with its MAC address.

How do I map all the ports on a Cisco switch?

Enter the switch address and your SNMP community or v3 credentials, then scan. SwitchMiner lists each port with its status, speed, duplex, VLAN and the devices behind it, and saves the result as an Excel or CSV file.

Can it scan many switches at once?

Yes. Load a text file with a list of switches and choose how many threads to use. With CDP discovery turned on, SwitchMiner also finds neighboring switches and scans them.

Does it work with Arista or other switch brands?

Yes for Arista: ports, speed, VLANs, MAC addresses, LLDP neighbors and counters. Other vendors that follow the standard SNMP bridge MIBs are scanned with the standard data only, and that has not been tested on real hardware yet. SwitchMiner detects the vendor automatically.

Which SNMP versions does it support?

SNMP v1, v2c and v3, including MD5 and SHA authentication and DES and AES (128, 192 and 256-bit) privacy. If you use v3, the switch needs a group with a “vlan-” context match prefix, or very few MAC addresses will come back.

SNMP v1 and v2c send the community string in clear text, so anyone who can capture traffic on the network can read it. Use v3 with authentication and privacy whenever your switches support it, and use a read-only community if you must use v1 or v2c.

What file formats can it export?

Excel (.xlsx), as one workbook with a sheet for each switch plus an Inventory sheet, and CSV. In Excel the header row is frozen, filters are on, and problem ports such as err-disabled or spanning tree blocked ones are colored. The Windows GUI can also save results as text.

Does SwitchMiner run on Linux?

Yes. Version 5 includes a single portable command-line program for Linux that needs no installation. It requires x86_64 and glibc 2.28 or newer.

Is it free?

Yes. SwitchMiner is open source under the GNU General Public License version 3, and the source code is available to download.

Get SwitchMiner

Version 5.10, released November 8, 2026. Free for everyone, licensed under the GNU General Public License version 3.

  • Windows

    The Windows GUI (smgui.exe) and the command-line program (sm.exe). Tested on Windows 11. It is a 32-bit program that also runs on 64-bit Windows. 7.7 MB zip.

    Download for Windows

  • Linux

    A single portable command-line program (sm) with nothing to install. There is no GUI on Linux. Needs x86_64 and glibc 2.28 or newer, which covers RHEL, Rocky and Alma 8+, Ubuntu 20.04+, Debian 10+, Fedora and openSUSE. 3.3 MB.

    Download for Linux

  • Source code

    The 5.10 source as a tar.gz, 1.2 MB. A SHA256 checksum file is available to verify your downloads.

    Download source

Looking for an older release? Version 5.00, Version 4.x and all other files are still on SourceForge.