Skip to content

Commit fc56f4c

Browse files
committed
Apple / Mac OS X notes in readme
Thanks Balthasar for all the shims that were necessary to make this work
1 parent 851dc10 commit fc56f4c

File tree

1 file changed

+45
-0
lines changed

1 file changed

+45
-0
lines changed

README.md

+45
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,8 @@ Or check here for more build instructions and other useful stuff:
3333
- https://github.com/wiedehopf/adsb-wiki/wiki/Building-readsb-from-source
3434
- https://github.com/wiedehopf/adsb-wiki/wiki/Raspbian-Lite:-ADS-B-receiver
3535

36+
For OS X check build and general info, check further down
37+
3638
### aircraft.json format:
3739

3840
[json file Readme](README-json.md)
@@ -230,6 +232,49 @@ oh if you want that display:
230232
you'll have to update, just disabled the MLAT speed check from displayign stuff ... because usually it's not interesting
231233

232234

235+
## Apple / Mac OS X
236+
237+
Thank you to https://github.com/ind006/readsb_macos/ for all the shims needed to make this work.
238+
239+
readsb should be (largely) compatible with macOS, on both Intel and ARM architectures.
240+
You may need to modify the Makefile to point at where on your mac you have the standard libs and includes installed.
241+
This in turn depends on whether you're using macports or homebrew for those libs and includes. The Makefile has paths
242+
pre-set for homebrew.
243+
244+
Build using:
245+
```
246+
make -j4 RTLSDR=yes
247+
```
248+
249+
You can run it from the command line (try `screen -S readsb` and run it in there, press ctrl-A to detach the terminal)
250+
Example command line:
251+
```sh
252+
./readsb --quiet --net --device-type rtlsdr --gain auto
253+
# optionally add coordinates:
254+
--lat -33.874 --lon 151.206
255+
# add --interactive for testing, it will show a list of planes in the terminal
256+
# optional listen ports:
257+
--net-ri-port 30001 --net-ro-port 30002 --net-sbs-port 30003 --net-bi-port 30004,30104 --net-bo-port 30005
258+
# optional sending of data to an aggregator:
259+
--net-connector feed.flyrealtraffic.com,30004,beast_reduce_plus_out,7817bd08-f226-11ef-ba9e-072eee452592
260+
# optional output of json and other regularly updated files:
261+
--write-json-every 0.5 --write-json=/run/readsb
262+
```
263+
264+
For a graphical interface, the tar1090 webinterface is recommended: https://github.com/wiedehopf/tar1090
265+
The install script won't work so i'd recommend the following basic webserver configuration:
266+
- serve the html directory as /tar1090
267+
- serve the write-json directory as /tar1090/data
268+
269+
An easy way to add some traces when selecting a plane:
270+
Add `--write-globe-history=/var/globe_history` to the readsb command line.
271+
You can also serve this folder as /tar1090/globe_history but that's only required for the history going back further
272+
than 24h.
273+
274+
The classical tar1090 uses traces created via a shell scripts and served at /tar1090/chunks but running that shell
275+
script is probably a hassle, so just use the above.
276+
277+
233278
## readsb --help
234279

235280
might be out of date, check the command on a freshly compiled version

0 commit comments

Comments
 (0)