{"id":23360319,"url":"https://github.com/nfacha/adsb-stats-logger","last_synced_at":"2025-04-10T10:32:08.407Z","repository":{"id":56755955,"uuid":"445534384","full_name":"nfacha/adsb-stats-logger","owner":"nfacha","description":"ADS-B Stats Logger from Dump1090","archived":false,"fork":false,"pushed_at":"2024-04-10T20:00:34.000Z","size":63,"stargazers_count":11,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T09:21:12.672Z","etag":null,"topics":["ads-b","adsb","aircraft","dump1090","dump1090-fa","planespotting","radar","rtl-sdr","rtlsdr","transponder"],"latest_commit_sha":null,"homepage":"https://facha.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nfacha.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-01-07T13:42:32.000Z","updated_at":"2025-01-07T03:05:47.000Z","dependencies_parsed_at":"2022-08-16T01:50:22.952Z","dependency_job_id":"8196da69-663b-467a-b34d-31a39d432de0","html_url":"https://github.com/nfacha/adsb-stats-logger","commit_stats":{"total_commits":39,"total_committers":1,"mean_commits":39.0,"dds":0.0,"last_synced_commit":"e9f14ad9858eca005a812de1ffb7b9abdb64eeca"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfacha%2Fadsb-stats-logger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfacha%2Fadsb-stats-logger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfacha%2Fadsb-stats-logger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nfacha%2Fadsb-stats-logger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nfacha","download_url":"https://codeload.github.com/nfacha/adsb-stats-logger/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248199136,"owners_count":21063641,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ads-b","adsb","aircraft","dump1090","dump1090-fa","planespotting","radar","rtl-sdr","rtlsdr","transponder"],"created_at":"2024-12-21T11:13:51.111Z","updated_at":"2025-04-10T10:32:08.387Z","avatar_url":"https://github.com/nfacha.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![wakatime](https://wakatime.com/badge/user/65ddcee5-893d-45e3-989c-4d52691b9072/project/68abfa67-8b61-46d6-b31d-de28ef515ccb.svg)](https://wakatime.com/badge/user/65ddcee5-893d-45e3-989c-4d52691b9072/project/68abfa67-8b61-46d6-b31d-de28ef515ccb)\n\n![GitHub tag (latest SemVer)](https://img.shields.io/github/v/tag/nfacha/adsb-stats-logger?label=Latest%20version)\n![GitHub Release Date](https://img.shields.io/github/release-date/nfacha/adsb-stats-logger)\n![GitHub last commit](https://img.shields.io/github/last-commit/nfacha/adsb-stats-logger)\n\n![GitHub Repo stars](https://img.shields.io/github/stars/nfacha/adsb-stats-logger?style=social)\n![GitHub watchers](https://img.shields.io/github/watchers/nfacha/adsb-stats-logger?style=social)\n\n[![Discord](https://img.shields.io/discord/933444164379619348)](https://discord.gg/ecyK3y4zTW)\n# ADS-B Stats Logger\n## Like this project? Don't forget to STAR it and follow it for future releases :)\n\n## Features\n\n- Log all unique flights seen by the ADS-B receiver\n- Log all unique operators seen by the ADS-B receiver\n- Log the flight with the highest altitude seen by the ADS-B receiver\n- Log the flight with the highest speed seen by the ADS-B receiver\n- Log the flight the furthest away from the ADS-B receiver\n- Log the flight closest from the ADS-B receiver\n- Log the flight with the best signal strength seen by the ADS-B receiver\n- Log the flight with the worst signal strength seen by the ADS-B receiver\n- All data is available in Metric Units (by default) or Imperial Units\n\n## Python Compatibility\nThis has been tested and confirmed to work on Python 3.10, but should work fine in Python.\n\n## Usage\n1. Clone the git repo on your ADS-B server and enter its directory:\n```bash\ngit clone https://github.com/nfacha/adsb-stats-logger.git\ncd adsb-stats-logger\n```\n2. Copy the config file sample:\n```bash\ncp config.ini.sample config.ini\n```\n3. Edit the config to your liking, one easy way would be using nano\n```bash\nnano config.ini\n```\n4. Edit the config to your liking, one easy way would be using nano\n```ini\n[PATHS]\nDATA_PATH = /run/dump1090-fa/ #The path to your dump1090 logs folder\n[LOCATION]\nSTATION_LAT = 37.7 #Your base station latitude, used for distance calculations\nSTATION_LNG = 37.7 #Your base station longitude, used for distance calculations\n[LOGGING]\nSENTRY_DSN =#Sentry DSN for error logging, leave empry to disable\nSENTRY_ENVIRONMENT=#Sentry environment, leave empry to disable\nLOG_LEVEL = 20 #Log level, see https://docs.python.org/3/library/logging.html#logging-levels\n[UNITS]\nUSE_METRIC_SYSTEM = true #Use metric system for distance calculations, else use caveman units (a.k.a. imperial)\n```\n5. Leave the script running in the background, one easy way would be to use screen\n```bash\nscreen -S logger -dm python3 logger.py\n```\n6. By now the script should be running, wait a bit for data to gather and as soon as you have at least one plane in your range it should start to gather data, to see this data use\n```bash\npython3 show.py\n```\nYou will get an output similar to this:\n\n```\nINFO:root:Logging level: 20\nINFO:root:Use metric system: True\n--- Metrics ---\nData range: 2022-01-07 16:33:15 - 2022-01-07 13:26:54\nUnique Flights: 5\nUnique Operators: 3\nMax Altitude: Flight IBE6317 11.879000304785126 km at 2022-01-07 13:39:43\nMax Speed: Flight IBE6501 851.3644 kmh at 2022-01-07 13:36:00\nMax Station Distance: Flight RYR28FF 5449.571199579309 km at 2022-01-07 15:34:44\nMin Station Distance: Flight SAT571 12.83198307011012 km at 2022-01-07 16:33:14\nMax Signal: Flight IBE6317 -16.3 db at 2022-01-07 13:39:43\nMin Signal: Flight IBE6501 -24.0 db at 2022-01-07 13:39:43\n--- Unique Flights Seen ---\nSAT2500 last seen on 2022-01-07 13:26:54\nIBE6317 last seen on 2022-01-07 13:39:48\nIBE6501 last seen on 2022-01-07 13:39:48\nRYR28FF last seen on 2022-01-07 15:40:59\nSAT571 last seen on 2022-01-07 16:33:15\n--- Unique Operators Seen ---\nSAT last seen on 2022-01-07 16:33:15\nIBE last seen on 2022-01-07 13:39:48\nRYRFF last seen on 2022-01-07 15:40:59\n\nProcess finished with exit code 0\n\n```\n\nIf you want to see the runtime logs, or to be able to Ctrl-C you can enter the screen with:\n```bash\nscreen -x logger\n```\n\n### Inspiration\nThis was inspired by wesmorgan1's Reddit post: https://www.reddit.com/r/ADSB/comments/rutot0/python3_script_to_profile_dump1090_output_and/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnfacha%2Fadsb-stats-logger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnfacha%2Fadsb-stats-logger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnfacha%2Fadsb-stats-logger/lists"}