{"id":13497144,"url":"https://github.com/daniestevez/gr-satellites","last_synced_at":"2025-05-14T21:06:39.677Z","repository":{"id":38848351,"uuid":"66658131","full_name":"daniestevez/gr-satellites","owner":"daniestevez","description":"GNU Radio decoder for Amateur satellites","archived":false,"fork":false,"pushed_at":"2025-05-14T08:58:56.000Z","size":11303,"stargazers_count":831,"open_issues_count":27,"forks_count":175,"subscribers_count":47,"default_branch":"main","last_synced_at":"2025-05-14T09:42:39.833Z","etag":null,"topics":["ccsds","decoder","fec","gnuradio","satellite","sdr","telemetry"],"latest_commit_sha":null,"homepage":"","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/daniestevez.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null},"funding":{"github":"daniestevez","custom":"https://destevez.net/donate/"}},"created_at":"2016-08-26T15:22:52.000Z","updated_at":"2025-05-14T08:28:02.000Z","dependencies_parsed_at":"2023-02-15T21:45:55.626Z","dependency_job_id":"a0b92377-0538-4d2f-b6bb-e5087aeaa5b6","html_url":"https://github.com/daniestevez/gr-satellites","commit_stats":{"total_commits":1639,"total_committers":44,"mean_commits":37.25,"dds":"0.21415497254423432","last_synced_commit":"f5564b6a6df370a404d3448d23fc6687ef528dc2"},"previous_names":[],"tags_count":83,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniestevez%2Fgr-satellites","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniestevez%2Fgr-satellites/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniestevez%2Fgr-satellites/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/daniestevez%2Fgr-satellites/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/daniestevez","download_url":"https://codeload.github.com/daniestevez/gr-satellites/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254227612,"owners_count":22035669,"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":["ccsds","decoder","fec","gnuradio","satellite","sdr","telemetry"],"created_at":"2024-07-31T20:00:24.557Z","updated_at":"2025-05-14T21:06:34.658Z","avatar_url":"https://github.com/daniestevez.png","language":"Jupyter Notebook","funding_links":["https://github.com/sponsors/daniestevez","https://destevez.net/donate/"],"categories":["Jupyter Notebook","Software","GnuRadio Software"],"sub_categories":["Satellite operation"],"readme":"# gr-satellites\n\n[![GitHub release (latest by date)](https://img.shields.io/github/v/release/daniestevez/gr-satellites)](https://github.com/daniestevez/gr-satellites/releases/latest)\n[![Conda](https://img.shields.io/conda/v/conda-forge/gnuradio-satellites)](https://anaconda.org/conda-forge/gnuradio-satellites)\n[![Read the Docs](https://img.shields.io/readthedocs/gr-satellites)](https://gr-satellites.readthedocs.io/)\n[![GitHub license](https://img.shields.io/github/license/daniestevez/gr-satellites)](https://github.com/daniestevez/gr-satellites/blob/main/LICENSE)\n\ngr-satellites is a GNU Radio out-of-tree module encompassing a collection of\ntelemetry decoders that supports many different Amateur satellites. This\nopen-source project started in 2015 with the goal of providing telemetry\ndecoders for all the satellites that transmit on the Amateur radio bands.\n\nIt supports most popular protocols, such as AX.25, the GOMspace NanoCom U482C\nand AX100 modems, an important part of the CCSDS stack, the AO-40 protocol used\nin the FUNcube satellites, and several ad-hoc protocols used in other\nsatellites.\n\nThis out-of-tree module can be used to decode frames transmitted from most\nAmateur satellites in orbit, performing demodulation, forward error correction,\netc. Decoded frames can be saved to a file or displayed in hex format. For some\nsatellites the telemetry format definition is included in gr-satellites, so the\ndecoded telemetry frames can be printed out as human-readable values such as bus\nvoltages and currents. Additionally, some satellites transmit files such as JPEG\nimages. gr-satellites can be used to reassemble these files and even display the\nimages in real-time as they are being received.\n\ngr-satellites can be used as a set of building blocks to implement decoders for\nother satellites or other groundstation solutions. Some of the low level blocks\nin gr-satellites are also useful for other kinds RF communications protocols.\n\n## Documentation\n\ngr-satellites [documentation](https://gr-satellites.readthedocs.io/) is hosted in\n[reathedocs.io](https://readthedocs.io/).\n\n## Releases and branches\n\nCurrently there are the following series of releases in the history of\ngr-satellites:\n\n* `v5.x.y` is the current release series, and supports GNU Radio 3.10.\n\n* `v4.x.y` has the same functionality as the v5.x.y series, but supports\n  GNU Radio 3.9 (until v4.6.0, the v4.x.y series supported both GNU Radio\n  3.9 and 3.10).\n\n* `v3.x.y` has the same functionality as the v5.x.y series, but supports\n  GNU Rado 3.8. This series was the result of a large refactor that\n  introduced a lot of new functionality and improvements.\n  The refactor started on September 2019 and was finished in May 2020.\n   \n* `v2.x.y` is a series of releases compatible with GNU Radio 3.8 that existed\n  between September 2019 and May 2020. The functionality in this series is\n  equivalent to the `v1.x.y` series.\n\n* `v1.x.y` the original series of releases, which was compatible with GNU Radio\n  3.7. Development in this series stopped on September 2019 with the appearance\n  of the `v2.x.y` line, but some bugfix releases have been published afterward.\n\nThe repository is organized in the following branches:\n\n* `main` is where the active development happens. From time to time, features\n  will be frozen in a new release. This branch is compatible with GNU Radio 3.10.\n\n* `maint-3.10` is the branch where releases in the current `v5.x.y` line are\n  published. This branch is compatible with GNU Radio 3.10.\n\n* `maint-3.9` is the branch where releases in the current `v4.x.y` line are\n  published. This branch is compatible with GNU Radio 3.9.\n\n* `maint-3.8` is the branch where releases in the current `v3.x.y` line are\n  published. This branch is compatible with GNU Radio 3.8.\n\n* `maint-3.8-v2` is the branch where releases in the `v2.x.y` line were\n  published. This branch is compatible with GNU Radio 3.8. No changes\n  happen in this branch any longer.\n\n* `maint-3.7` is the branch where releases in the `v1.x.y` line were\n  published. This branch is compatible with GNU Radio 3.7. No changes happen\n  in this branch any longer.\n\nIn general, pull requests should be submitted to `main`.\n\n## Installation\n\nThe installation procedure of gr-satellites is roughly the usual of a GNU Radio\nout-of-tree module. Detailed instructions about the required dependencies and\nhow to build and install gr-satellites are given in the\n[documentation](https://gr-satellites.readthedocs.io/).\n\n## Support\n\nSupport for gr-satellites is handled only through\n[Github issues](https://github.com/daniestevez/gr-satellites/issues)\nand [Github discussions](https://github.com/daniestevez/gr-satellites/discussions)\nso that the whole community can benefit, rather than through private\nchannels such as email. Please understand this when asking for support.\nTake a look [here](https://github.com/daniestevez/gr-satellites/discussions/304) to\ncheck whether a new topic fits better in the issues page or in the discussions page.\n\n## Satellite teams\n\nSatellite teams interested in using gr-satellites for your groundstation\nsolution, please read\n[this note](https://github.com/daniestevez/gr-satellites/blob/main/satellite_teams.md),\nespecially if you will be using Amateur radio spectrum.\n\n## Commercial satellites\n\n[This note](https://github.com/daniestevez/gr-satellites/blob/main/commercial_satellites.md)\ndescribes the policy of the gr-satellites project with respect to code\ncontributions that add support for commercial satellite missions.\n\n## CCSDS TM and TC Space Datalink and SpacePacket blocks\n\nAthanasios Theocharis made under ESA Summer of Code in Space 2019 a collection\nof blocks covering several CCSDS blue books. The documentation for this blocks\ncan be found in\n[CCSDS_README.md](https://github.com/daniestevez/gr-satellites/blob/main/CCSDS_README.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaniestevez%2Fgr-satellites","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaniestevez%2Fgr-satellites","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaniestevez%2Fgr-satellites/lists"}