Skip to main content

Python Library for NETGEAR Plus Switches

What it does

Grabs statistical network data from supported NETGEAR Switches from the Plus Managed Network Switch line. These switches can only be managed using a Web interface and not through SNMP or cli. This library uses web scraping to collect the switch configuration, statistics and some basic configuration updates.

How it works

  1. Detecting Switch Model/Product in login.cgi
  2. Connects to the Switch and asks for a cookie (http://IP_OF_SWITCH/login.cgi)
  3. HTTP-Request send to the Switch twice (http://IP_OF_SWITCH/portStatistics.cgi) and compared with previous data ("in response time")

List of port statistics

Name key from get_switch_infos() Unit
Port {port} Traffic Received port_{port}_traffic_rx_mbytes MB (in response time)
Port {port} Traffic Sent port_{port}_traffic_tx_mbytes MB (in response time)
Port {port} Receiving port_{port}_speed_rx_mbytes MB/s
Port {port} Transferring port_{port}_speed_tx_mbytes MB/s
Port {port} IO port_{port}_speed_io_mbytes MB/s
Port {port} Total Received port_{port}_sum_rx_mbytes MB (since last switch reboot/reset)
Port {port} Total Transferred port_{port}_sum_tx_mbytes MB (since last switch reboot/reset)
Port {port} Connection Speed port_{port}_connection_speed MB/s
Port {port} Status port_{port}_status "on"/"off"
Port {poe_port} POE Power port_{poe_port}_poe_power_active "on"/"off"

PoE capable models of the GS30x series (GS305EP/EPP, GS308EP/EPP) also expose per PoE port:

Name key from get_switch_infos() Unit
Port {poe_port} POE Status port_{poe_port}_poe_status "delivering_power"/"searching"/"disabled"
Port {poe_port} POE Delivering port_{poe_port}_poe_power_delivered "on"/"off"
Port {poe_port} POE Class port_{poe_port}_poe_class 0-8 or None when no powered device
Port {poe_port} POE Voltage port_{poe_port}_poe_voltage V
Port {poe_port} POE Current port_{poe_port}_poe_current mA
Port {poe_port} POE Power port_{poe_port}_poe_output_power W
Port {poe_port} POE Temperature port_{poe_port}_poe_temperature °C
Port {poe_port} POE Fault port_{poe_port}_poe_fault text, "No Error" when fine

get_port_infos() and get_poe_port_infos() return the same data regrouped per port number.

List of aggregated statistics

Sensor Name key from get_switch_infos() Unit
Switch IO sum_port_speed_bps_io MB/s
Switch Traffic Received sum_port_traffic_rx MB (in response time)
Switch Traffic Sent sum_port_traffic_tx MB (in response time)

Supported and tested NETGEAR Models/Products and firmware versions

Model Ports Firmware versions Bootloader versions
GS105E 5 ?
GS105Ev2 5 V1.6.0.15 V1.4.0.5-VB
GS105PE 5 V1.6.0.17 V1.6.0.2-VB
GS108E 8 V1.00.11 V1.00.03
GS105Ev3 5 ?
GS108Ev3 8 V2.00.05, V2.06.10, V2.06.17, V2.06.24 V2.06.01 - V2.06.03
GS108Ev4 8 V1.0.1.3
GS108PEv3 8 V2.06.24 V0.00.00
GS110EMX 10 V1.0.2.8
GS116Ev2 16 V2.6.0.48, V2.6.0.50
GS305E 5 V1.0.0.16 V1.0.0.2
GS305EP 5 V1.0.1.1
GS305EPP 5 V1.0.1.4
GS308E 8 V1.00.11 V1.00.03
GS308EP 8 V1.0.0.10, V1.0.1.4, V2.0.0.5
GS308EPP 8 V1.0.1.4
GS308Ev4 8 V1.0.1.3
GS316EP 16 V1.0.4.4
GS316EPP 16 V1.0.4.4
JGS516PE 16 V2.6.0.48
JGS24Ev2 24 V2.6.0.48
MS305E 5 v1.0.0.9
MS308E 8 v1.0.0.9
XS512EM 12 V1.0.2.8

Supported firmware languages: GR (German), EN (English)

Unsupported models

Model Support status
JGS524PE See #93
MS108EUP See #91

HOWTO_Add_New_Models.md contains instructions to add unsupported models.

CLI usage

export NETGEAR_PLUS_PASSWORD=s3cr3t # replace with your password
ngp-cli login 192.168.178.68 # replace with IP address of your switch
ngp-cli status
ngp-cli port list        # link status, speed and settings per port
ngp-cli poe status       # PoE config and live status per port (PoE models)
ngp-cli poe off 7        # disable / enable / power-cycle PoE on a port
ngp-cli poe on 7
ngp-cli poe cycle 7
ngp-cli logout
ngp-cli -h

Library Usage

Create a python virtual environment

python3 -m venv .venv
source .venv/bin/activate
pip install py-netgear-plus

Using this VENV go to your local source folder

Example calls

cd src
python3
ip = "192.168.178.68"  # replace with IP address of your switch
p = "fyce4gKZemkqjDY"  # replace with your password
import py_netgear_plus

sw = py_netgear_plus.NetgearSwitchConnector(ip, p)
sw.autodetect_model()
sw.get_login_cookie()

data = sw.get_switch_infos()
print(sw.switch_model.MODEL_NAME)
print(data["port_1_sum_rx_mbytes"])
print(data)
sw.turn_off_poe_port(1)  # Supported only on PoE capable models
sw.turn_on_poe_port(1)

Metadata

Release files for py-netgear-plus 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for py-netgear-plus 0.7.0
File Size Uploaded Provenance Actions
py_netgear_plus-0.7.0.tar.gz 248.5 kB With provenance Details for py_netgear_plus-0.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for py-netgear-plus 0.7.0
File Interpreter ABI Platform Actions
py_netgear_plus-0.7.0-py3-none-any.whl Python 3 none any Details for py_netgear_plus-0.7.0-py3-none-any.whl

Total release size: 299.1 kB

Release files / py_netgear_plus-0.7.0.tar.gz

Download URL py_netgear_plus-0.7.0.tar.gz
Size 248.5 kB
Tags Source
SHA-256 checksum
How to use checksums
3a9f8f91d2cfba72fc8062d4d3696b92fc1f4f7385e40aa24366ac35d4c42e75
BLAKE2b-256 checksum
How to use checksums
554ac09b887e37003a8e4170521758be3f72b8d80d78e8cf05ebccc1e39a57e8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Release files / py_netgear_plus-0.7.0-py3-none-any.whl

Download URL py_netgear_plus-0.7.0-py3-none-any.whl
Size 50.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3685c5ff677066b9a8a8d9a580ba11ac404017c8a26955255d08edc29c9bc7de
BLAKE2b-256 checksum
How to use checksums
b160e6514fc7f0c4a2156432f6508aaf42d619074d3fc53ac6c3b267b8c08f0c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Security for py-netgear-plus 0.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for py_netgear_plus-0.7.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.7.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page