{"id":13703772,"url":"https://github.com/emlid/ntripbrowser","last_synced_at":"2025-07-29T03:32:47.939Z","repository":{"id":11374951,"uuid":"68295098","full_name":"emlid/ntripbrowser","owner":"emlid","description":"CLI tool to easily get NTRIP caster information","archived":false,"fork":false,"pushed_at":"2022-12-08T05:47:16.000Z","size":157,"stargazers_count":32,"open_issues_count":4,"forks_count":10,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-11-13T10:38:09.427Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://emlid.com/reach/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/emlid.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}},"created_at":"2016-09-15T13:12:39.000Z","updated_at":"2024-05-30T00:46:26.000Z","dependencies_parsed_at":"2023-01-13T16:28:58.370Z","dependency_job_id":null,"html_url":"https://github.com/emlid/ntripbrowser","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emlid%2Fntripbrowser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emlid%2Fntripbrowser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emlid%2Fntripbrowser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/emlid%2Fntripbrowser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/emlid","download_url":"https://codeload.github.com/emlid/ntripbrowser/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227976766,"owners_count":17850255,"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":[],"created_at":"2024-08-02T21:00:59.957Z","updated_at":"2025-07-29T03:32:47.908Z","avatar_url":"https://github.com/emlid.png","language":"Python","funding_links":[],"categories":["Localization and State Estimation","Localization"],"sub_categories":["Lidar and Point Cloud Processing","Point Cloud Processing"],"readme":"# NTRIP Browser\n[![CI checks](https://github.com/emlid/ntripbrowser/actions/workflows/ci.yaml/badge.svg)](https://github.com/emlid/ntripbrowser/actions/workflows/ci.yaml)\n\nA Python API for browsing NTRIP (Networked Transport of RTCM via Internet Protocol).\n\n## Requirements\n\n- pager\n- geopy\n- pycurl\n- cchardet\n- texttable\n- Python 3.11+\n\n## Installation\n\n- make sure that you have `libcurl` installed\n\n- `pip install ntripbrowser`\n\n- or clone and run `make install`\n\n#### libcurl installation hints\n\n- installation via `apt`:\n\n  ```bash\n  apt-get install libssl-dev libcurl4-openssl-dev python-dev\n  ```\n\n## Usage\n\n```\nntripbrowser [-h] [-p] [-t] [-c] host\n\npositional arguments:\n  host                  NTRIP source table host address\n\noptional arguments:\n  -h, --help            Show this help message and exit\n  -p, --port            Set url port. Standard port is 2101\n  -t, --timeout         Add timeout\n  -c, --coordinates     Add NTRIP station distance to this coordinate\n  -M  --maxdist         Only report stations less than this number of km away\n                        from given coordinate\n```\n\n#### CLI workflow example:\n\n```bash\nntripbrowser cddis-caster.gsfc.nasa.gov -p 443 -t 5 -c 1.0 2.0 -M 4000\n```\n\n## Package API\n\n#### Workflow example:\n\n```python\nbrowser = NtripBrowser(host, port=2101, timeout=5)\nbrowser.get_mountpoints()\nbrowser.host = another_host\nbrowser.get_mountpoints()\n```\n\n#### Arguments:\n\n- `host`\n\n\u003e NTRIP caster host.\n\u003e Standard port is 2101, use `:port` optional argument to set another one.\n\n#### Optional arguments:\n\n- `port`\n\n\u003e NTRIP caster port.\n\n- `timeout`\n\n\u003e Use `timeout` to define, how long to wait for a connection to NTRIP caster.\n\n- `coordinates`\n\n\u003e Use `coordinates` to pass your position coordinates in function and get distance to NTRIP station.  \n\u003e Form of coordiantes must be `(x, y)` or `(x.x, y.y)` of latitude, longitude.\n\n- `maxdist`\n  \u003e Use `maxdist` to only report stations less than this number of km away from given coordinate.\n  \u003e Stations lacking coordinates will not be returned.\n\n#### Result\n\nAs a result you'll get a dictionary consisting of a lists of dictionaries with such structure:\n\n- CAS stations: `\"Host\", \"Port\", \"ID\", \"Operator\", \"NMEA\", \"Country\", \"Latitude\", \"Longitude\", \"FallbackHost\", \"FallbackPort\", \"Site\", \"Other Details\", \"Distance\"`\n\n- NET stations: `\"ID\", \"Operator\", \"Authentication\", \"Fee\", \"Web-Net\", \"Web-Str\", \"Web-Reg\", \"Other Details\", \"Distance\"`\n\n- STR stations: `\"Mountpoint\", \"ID\", \"Format\", \"Format-Details\",\"Carrier\", \"Nav-System\", \"Network\", \"Country\", \"Latitude\", \"Longitude\", \"NMEA\", \"Solution\", \"Generator\", \"Compr-Encryp\", \"Authentication\", \"Fee\", \"Bitrate\", \"Other Details\", \"Distance\"`\n\n#### Exceptions\n\n- `ntripbrowser.NtripbrowserError` - base class for all ntripbrowser exceptions.\n- `ntripbrowser.UnableToConnect` - raised when ntripbrowser could not connect to the assigned url.\n- `ntripbrowser.NoDataReceivedFromCaster` - raised when ntripbrowser could not find any data on the page.\n- `ntripbrowser.ExceededTimeoutError` - raised when connection timeout is exceeded.\n\n## To test\n\n```bash\nmake test\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femlid%2Fntripbrowser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Femlid%2Fntripbrowser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Femlid%2Fntripbrowser/lists"}