1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
pyNetgear
==============
[](https://github.com/sponsors/starkillerOG)
[](https://gitlab.com/matmaul/pynetgear/pipelines)
pyNetgear provides an easy to use Python API to control your Netgear router. It uses the SOAP-api on modern Netgear routers to communicate. It is built by reverse engineering the requests made by the [NETGEAR Genie app](https://play.google.com/store/apps/details?id=com.dragonflow).
pyNetgear works with Python 2 and 3.
If you are connected to the network of the Netgear router, a host is optional.
If you are connected via a wired connection to the Netgear router, a password is optional.
The username defaults to admin.
The port defaults to 5000.
The ssl defaults to false.
You can specify url and it will take precedence on host/port/ssl parameters.
This allows the use of HTTPS, `https://orbilogin.com` for example.
It currently supports the following operations:
**login**<br>
Logs in to the router. Will return True or False to indicate success.
**get_attached_devices**<br>
Returns a list of named tuples describing the device signal, ip, name, mac, type, link_rate and allow_or_block.
**get_attached_devices_2**<br>
Returns a list of named tuples describing the device signal, ip, name, mac, type, link_rate, allow_or_block, device_type, device_model, ssid and conn_ap_mac.
This call is slower and probably heavier on the router load.
**get_traffic_meter**<br>
Return a dict containing the traffic meter information from the router (if enabled in the webinterface).
**allow_block_device**<br>
Allows user to block/unblock devices from accessing router by specifying mac_addr and new device_status (Block/Allow)
**Note:** In order to use this function, Remote Management _must_ be enabled in the router's admin settings.
Installation
------------
You can install PyNetgear from PyPi using `pip3 install pynetgear` (use `pip` if you're still using Python 2).
Usage
-----
To test run from the console:
`$ python -m pynetgear [<pass>] [<host>] [<user>] [<port>] [<ssl>]`
To use within your Python scripts:
```python
from pynetgear import Netgear
netgear = Netgear(password=mypassword)
for i in netgear.get_attached_devices():
print i
```
Supported routers
-----------------
It has been tested with the Netgear R6300 router and the Netgear WNDR4500 router. According to the NETGEAR Genie app description, the following routers should work:
* Netgear Orbi
* Netgear R7800
* Netgear R7500v2 (Port 80)
* Netgear R7000
* Netgear R6900
* Netgear R6300
* Netgear R6250
* Netgear R6200
* Netgear R6100
* Netgear N300 - Model: C3000 (Port 80)
* Netgear Centria (WNDR4700, WND4720)
* Netgear WNDR4500
* Netgear WNDR4300
* Netgear WNDR4000
* Netgear WNDR3800
* Netgear WNDR3700v3
* Netgear WNDR3700v2
* Netgear WNDR3400v2
* Netgear WNR3500Lv2
* Netgear WNR2200
* Netgear WNR2000v3
* Netgear WNR2000v4 (Port 80)
* Netgear WNR1500
* Netgear WNR1000v2
* Netgear WNR1000v3
* Netgear WNDRMAC
* Netgear WNR612v2
|
