Skip to content

Commit 258fab1

Browse files
authored
Update README.md
1 parent 0a06744 commit 258fab1

File tree

1 file changed

+16
-11
lines changed

1 file changed

+16
-11
lines changed

README.md

+16-11
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,25 @@
1-
# RETIRED: Mozilla Location Services from Python
1+
# Scan WiFi from Python
22

33
[![ci](https://github.com/scivision/mozilla-location-wifi/actions/workflows/ci.yml/badge.svg)](https://github.com/scivision/mozilla-location-wifi/actions/workflows/ci.yml)
44
[![PyPI Download stats](http://pepy.tech/badge/mozloc)](http://pepy.tech/project/mozloc)
55

6-
This project is RETIRED due to
7-
[discontinuation of Mozilla Location Services](https://discourse.mozilla.org/t/retiring-the-mozilla-location-service/128693).
8-
It worked so well, sorry to see it go!
6+
This project shows how to scan WiFi from Python using command line tools or pyobjc (macOS).
97

10-
This project can nonetheless be used as a reference for accessing WiFi information from Python.
8+
[Scapy dot11](https://scapy.readthedocs.io/en/latest/api/scapy.layers.dot11.html) is an alternative, more robust cross-platform way to scan WiFi than demonstrated here.
9+
10+
[Discontinuation](https://discourse.mozilla.org/t/retiring-the-mozilla-location-service/128693)
11+
of
12+
[Mozilla Location Services API](https://ichnaea.readthedocs.io/en/latest/api/geolocate.html?highlight=macaddress#wifi-access-point-fields).
13+
is sad as it worked so well!
14+
15+
This project can be used as a reference for simply accessing WiFi information from Python without using Scapy.
1116

1217
A future direction might be to use
1318
[Google Geolocation API](https://developers.google.com/maps/documentation/geolocation/intro)
1419

1520
---
1621

17-
Uses command line access to WiFi information via
18-
[Mozilla Location Services API](https://ichnaea.readthedocs.io/en/latest/api/geolocate.html?highlight=macaddress#wifi-access-point-fields)
19-
from Python.
22+
Uses command line access to WiFi information from Python.
2023
The command line programs used to access WiFi information include:
2124

2225
* Linux: [nmcli](https://developer.gnome.org/NetworkManager/stable/nmcli.html) NetworkManager
@@ -45,9 +48,10 @@ python -m mozloc
4548
```
4649

4750
Shows `time` `lat` `lng` `accuracy` `N BSSIDs heard`.
48-
In urban areas, accuracy of less than 100 meters is possible.
4951

50-
dump raw signals, without using API:
52+
When Mozilla Location Services were available, accuracy better than 100 meters was possible.
53+
54+
Dump raw signals, without using API:
5155

5256
```sh
5357
python -m mozloc --dump
@@ -83,7 +87,8 @@ E.g.
8387

8488
## TODO
8589

86-
Would like to add Bluetooth beacons. Need to use a new location service.
90+
* Would like to add Bluetooth beacons.
91+
* Need to use a new location service.
8792

8893
## Notes
8994

0 commit comments

Comments
 (0)