{"id":21735189,"url":"https://github.com/sdr-enthusiasts/docker-beast-splitter","last_synced_at":"2025-03-21T00:20:54.505Z","repository":{"id":37900611,"uuid":"456758880","full_name":"sdr-enthusiasts/docker-beast-splitter","owner":"sdr-enthusiasts","description":"FlightAware's beast-splitter helper utility for the Mode-S Beast, running in a docker container.","archived":false,"fork":false,"pushed_at":"2025-03-02T08:37:50.000Z","size":191,"stargazers_count":3,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-02T09:28:38.020Z","etag":null,"topics":["ads-b","adsb","beast","flightaware","mode-s","piaware"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","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/sdr-enthusiasts.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":"2022-02-08T02:48:46.000Z","updated_at":"2025-03-02T08:37:52.000Z","dependencies_parsed_at":"2024-05-18T01:39:17.668Z","dependency_job_id":"ddb93b64-b524-4afa-8f79-573b2a60179c","html_url":"https://github.com/sdr-enthusiasts/docker-beast-splitter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdr-enthusiasts%2Fdocker-beast-splitter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdr-enthusiasts%2Fdocker-beast-splitter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdr-enthusiasts%2Fdocker-beast-splitter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sdr-enthusiasts%2Fdocker-beast-splitter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sdr-enthusiasts","download_url":"https://codeload.github.com/sdr-enthusiasts/docker-beast-splitter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244712793,"owners_count":20497555,"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","beast","flightaware","mode-s","piaware"],"created_at":"2024-11-26T05:12:18.355Z","updated_at":"2025-03-21T00:20:54.479Z","avatar_url":"https://github.com/sdr-enthusiasts.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sdr-enthusiasts/docker-beast-splitter\n\nFlightAware's [beast-splitter][1] helper utility for the [Mode-S Beast][2], running in a docker container.\n\nThe Beast provides a single data stream over a (USB) serial port. If you have more than one thing that wants to read that data stream, you need something to redistribute the data. This is what beast-splitter does.\n\nMore information on [beast-splitter][1] is available at the [official repository][1].\n\n## Environment Variables\n\n| Variable                 | Controls which `beast-splitter` option | Description                                                    | Default           |\n| ------------------------ | -------------------------------------- | -------------------------------------------------------------- | ----------------- |\n| `BEAST_SPLITTER_SERIAL`  | `--serial`                             | Read from given serial device, set to `OFF` to disable serial  | `/dev/beast`      |\n| `BEAST_SPLITTER_NET`     | `--net`                                | Read from given network host:port                              | Unset             |\n| `BEAST_SPLITTER_BAUD`    | `--fixed-baud`                         | Set a fixed baud rate, or 0 for autobauding                    | `0`               |\n| `BEAST_SPLITTER_LISTEN`  | `--listen`                             | Specify a `[host:]port[:settings]` to listen on                | `0.0.0.0:30005:R` |\n| `BEAST_SPLITTER_CONNECT` | `--connect`                            | Specify a `host:port[:settings]` to connect to                 | Unset             |\n| `BEAST_SPLITTER_FORCE`   | `--force`                              | Specify settings to force on or off when configuring the Beast | Unset             |\n\n## Example `docker run`\n\n```bash\ndocker run \\\n  -d -it --restart=always \\\n  --name beast-splitter \\\n  --device /dev/beast:/dev/beast \\\n  -p 30005:30005 \\\n  ghcr.io/sdr-enthusiasts/docker-beast-splitter:latest\n```\n\n## Example `docker-compose.yml` service\n\n```yaml\nbeast-splitter:\n  image: ghcr.io/sdr-enthusiasts/docker-beast-splitter:latest\n  container_name: beast-splitter\n  restart: always\n  devices:\n    - /dev/beast:/dev/beast\n  ports:\n    - 30005:30005\n```\n\n## Testing the container\n\nOnce running, you can test the container to ensure it is correctly receiving data by issuing the command:\n\n```shell\ndocker exec -it beast-splitter viewadsb\n```\n\nWhich should display a departure-lounge-style screen showing all the aircraft being tracked, for example:\n\n```\n Hex    Mode  Sqwk  Flight   Alt    Spd  Hdg    Lat      Long   RSSI  Msgs  Ti -\n────────────────────────────────────────────────────────────────────────────────\n 7C801C S                     8450  256  296                   -28.0    14  1\n 7C8148 S                     3900                             -21.5    19  0\n 7C7A48 S     1331  VOZ471   28050  468  063  -31.290  117.480 -26.8    48  0\n 7C7A4D S     3273  VOZ694   13100  376  077                   -29.1    14  1\n 7C7A6E S     4342  YGW       1625  109  175  -32.023  115.853  -5.9    71  0\n 7C7A71 S           YGZ        725   64  167  -32.102  115.852 -27.1    26  0\n 7C42D1 S                    32000  347  211                   -32.0     4  1\n 7C42D5 S                    33000  421  081  -30.955  118.568 -28.7    15  0\n 7C42D9 S     4245  NWK1643   1675  173  282  -32.043  115.961 -13.6    60  0\n 7C431A S     3617  JTE981   24000  289  012                   -26.7    41  0\n 7C1B2D S     3711  VOZ9242  11900  294  209  -31.691  116.118  -9.5    65  0\n 7C5343 S           QQD      20000  236  055  -30.633  116.834 -25.5    27  0\n 7C6C96 S     1347  JST116   24000  397  354  -30.916  115.873 -17.5    62  0\n 7C6C99 S     3253  JST975    2650  210  046  -31.868  115.993  -2.5    70  0\n 76CD03 S     1522  SIA214     grnd   0                        -22.5     7  0\n 7C4513 S     4220  QJE1808   3925  282  279  -31.851  115.887  -1.9    35  0\n 7C4530 S     4003  NYA      21925  229  200  -30.933  116.640 -19.8    58  0\n 7C7533 S     3236  XFP       4300  224  266  -32.066  116.124  -6.9    74  0\n 7C4D44 S     3730  PJQ      20050  231  199  -31.352  116.466 -20.1    62  0\n 7C0559 S     3000  BCB       1000                             -18.4    28  0\n 7C0DAA S     1200            2500  146  002  -32.315  115.918 -26.6    48  0\n 7C6DD7 S     1025  QFA793   17800  339  199  -31.385  116.306  -8.7    53  0\n 8A06F0 S     4131  AWQ544    6125  280  217  -32.182  116.143 -12.6    61  0\n 7CF7C4 S           PHRX1A                                     -13.7     8  1\n 7CF7C5 S           PHRX1B                                     -13.3     9  1\n 7C77F6 S           QFA595     grnd 112  014                   -33.2     2  2\n```\n\nPress `CTRL-C` to escape this screen.\n\n## Getting help\n\nPlease feel free to [open an issue on the project's GitHub](https://github.com/sdr-enthusiasts/docker-beast-splitter/issues).\n\nJoin our [Discord channel](https://discord.gg/sTf9uYF) and converse.\n\n[1]: https://github.com/flightaware/beast-splitter\n[2]: http://www.modesbeast.com/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdr-enthusiasts%2Fdocker-beast-splitter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsdr-enthusiasts%2Fdocker-beast-splitter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsdr-enthusiasts%2Fdocker-beast-splitter/lists"}