{"id":21429728,"url":"https://github.com/louis-e/satellitefreqmon","last_synced_at":"2025-07-04T03:05:45.271Z","repository":{"id":174310193,"uuid":"652053920","full_name":"louis-e/SatelliteFreqMon","owner":"louis-e","description":"Open source solution for accurately monitoring satellite passes using configurable TLE and precise frequency recording using the software-defined radio application GQRX","archived":false,"fork":false,"pushed_at":"2023-06-11T00:19:38.000Z","size":2106,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-16T21:48:40.708Z","etag":null,"topics":["automation","gqrx","python","satellite","sdr"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/louis-e.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-10T23:57:30.000Z","updated_at":"2025-01-03T19:17:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"31c4bc3b-f9d0-429a-a1d6-ba03dc583dd7","html_url":"https://github.com/louis-e/SatelliteFreqMon","commit_stats":null,"previous_names":["louis-e/satellitefreqmon"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/louis-e/SatelliteFreqMon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louis-e%2FSatelliteFreqMon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louis-e%2FSatelliteFreqMon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louis-e%2FSatelliteFreqMon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louis-e%2FSatelliteFreqMon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/louis-e","download_url":"https://codeload.github.com/louis-e/SatelliteFreqMon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/louis-e%2FSatelliteFreqMon/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263437326,"owners_count":23466363,"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":["automation","gqrx","python","satellite","sdr"],"created_at":"2024-11-22T22:18:59.028Z","updated_at":"2025-07-04T03:05:45.243Z","avatar_url":"https://github.com/louis-e.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SatelliteFreqMon - _Automated Satellite Tracking and Precise Frequency Recording_\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python](https://img.shields.io/badge/python-3.8-blue.svg)](https://www.python.org/downloads/release/python-380/)\n\nThe goal of this project is to provide a comprehensive open source solution for accurately monitoring satellite passes[^1] using configurable [TLE (Two-Line Elements)](https://en.wikipedia.org/wiki/Two-line_element_set)[^2] and precise frequency recording using the software-defined radio application GQRX[^3].\n\n\n## Hardware Setup\n\n\u003cimg src=\"git-assets/hardware-setup.png?raw=true\" width=\"75%\"\u003e\n\n### Hardware List\n- RTL-SDR RTL2832U Dongle\n- Wideband LNA\n- V Dipole Antenna (tuned for NOAA frequencies)\n- Raspberry Pi\n\n\n## TLE File Configuration\nPlace the TLE files in the `sats/` directory.\n\n### Syntax\n```\nSATELLITE NAME\nTLE-LINE-1\nTLE-LINE-2\nFREQUENCY\nBANDWIDTH (Frequency range)\n```\n\n### Example\n```\nNOAA19\n1 33591U 09005A   23156.14173894  .00000208  00000-0  13708-3 0  9991\n2 33591  99.1001 201.8759 0012774 277.1213  82.8506 14.12764011738249\n137100\n42000\n```\n\nAlso make sure to adapt the GROUNDSTATION_LOCATION variable to set the groundstation location. This is necessary to accurately calculate the satellite passes.\n\n## Example Output\n\n```\npi@sdrpi:~/sat-tracker $ python tracker.py\n===== Passes calculated for: ['METEOR M2', 'NOAA19', 'NOAA15', 'ISS (ZARYA)', 'JAS 2 (FO-29)', 'NOAA18'] =====\n=== Configuring GQRX...\nM WFM 45000 RPRT 0\nL SQL -150 RPRT 0\n=== ISS (ZARYA) overpass (2023-06-07 17:52:22 - 2023-06-07 18:02:57 for 0:10:34.696568) on 145800KHz.\nF 145800000 RPRT 0\nM WFM 40000 RPRT 0\nAOS RPRT 0\n```\n\n\u003cimg src=\"git-assets/gqrx-noaa.png?raw=true\" width=\"65%\"\u003e\n\n## Maintainership and License\n\nIf you have any suggestions for improvements or would like to contribute to the project, feel free to submit a pull request.\nThis project is licensed under the MIT License[^4]. See the [LICENSE](LICENSE) file for details.\n\nCopyright (c) 2023 louis-e\n\n[^1]: https://github.com/satellogic/orbit-predictor\n\n[^2]: \"A two-line element set (TLE) is a data format encoding a list of orbital elements of an Earth-orbiting object for a given point in time, the epoch.\" https://en.wikipedia.org/wiki/Two-line_element_set\n\n[^3]: \"Gqrx is an open source software defined radio receiver (SDR) powered by the GNU Radio and the Qt graphical toolkit.\" https://gqrx.dk/\n\n[^4]:\n    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:\n    \n    The above copyright notice, the author (\"louis-e\") and this permission notice shall be included in all copies or substantial portions of the Software.\n    \n    THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flouis-e%2Fsatellitefreqmon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flouis-e%2Fsatellitefreqmon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flouis-e%2Fsatellitefreqmon/lists"}