{"id":21224845,"url":"https://github.com/chaphasilor/ble-analyzer-server","last_synced_at":"2025-03-15T01:42:06.607Z","repository":{"id":119690298,"uuid":"325051164","full_name":"Chaphasilor/ble-analyzer-server","owner":"Chaphasilor","description":"A tool for displaying and analyzing Bluetooth Low-Energy (BLE) packet streams in pcapng format. Supports both recorded and live sessions. Server part only.","archived":false,"fork":false,"pushed_at":"2022-10-25T10:19:47.000Z","size":232,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-21T17:36:51.173Z","etag":null,"topics":["bluetooth","bluetooth-le","bluetooth-low-energy","pcap","pcap-np","pentesting","security","wireshark"],"latest_commit_sha":null,"homepage":"https://github.com/Chaphasilor/ble-analyzer-gui","language":"JavaScript","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/Chaphasilor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":"Chaphasilor","patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2020-12-28T15:44:29.000Z","updated_at":"2024-10-28T00:49:13.000Z","dependencies_parsed_at":null,"dependency_job_id":"d95a95de-643a-425d-997f-ab68adfadae7","html_url":"https://github.com/Chaphasilor/ble-analyzer-server","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chaphasilor%2Fble-analyzer-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chaphasilor%2Fble-analyzer-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chaphasilor%2Fble-analyzer-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Chaphasilor%2Fble-analyzer-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Chaphasilor","download_url":"https://codeload.github.com/Chaphasilor/ble-analyzer-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243672370,"owners_count":20328762,"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":["bluetooth","bluetooth-le","bluetooth-low-energy","pcap","pcap-np","pentesting","security","wireshark"],"created_at":"2024-11-20T23:00:17.392Z","updated_at":"2025-03-15T01:42:06.588Z","avatar_url":"https://github.com/Chaphasilor.png","language":"JavaScript","funding_links":["https://github.com/sponsors/Chaphasilor"],"categories":[],"sub_categories":[],"readme":"# ble-analyzer-server\nA tool for displaying and analyzing Bluetooth Low-Energy (BLE) packet streams in pcapng format. Supports both recorded and live sessions. Server part only.\n\n![Screenshot](./Screenshot_Overview.png)\n\n## Getting Started\n\n### Quickstart\n\nYou can download \u0026 use pre-built binaries for Windows and Linux (x64) from [the releases page](https://github.com/Chaphasilor/ble-analyzer-server/releases).  \nAll commands and arguments are just the same with it, simply replace `node index` with the path to the binary.  \nYou'll also have to set the environment variables manually, or use a `.env` file (see below).\n\n### Dev Setup\n\n#### Prerequisites\n\nAfter cloning, create a file called `.env` in the project root.  \nThere you can specify the environment variables:\n\n```s\nPORT=70 # just an example\nenvironment=development # or `debug` or `production`\n```\n\nYou'll need to have Node.js 14 or higher (and `npm`) installed.  \nAlso make sure that [`tshark`](https://tshark.dev/) (the CLI version of Wireshark) is installed on your system and in your `PATH`, so that you can run `tshark` from any terminal.\n\n#### Installation\n\n```sh-session\n$ npm install\n```\n\n### Startup/Usage\n\nThe server requires a Bluetooth LE packet stream in `pcap-ng` format as input.  \nYou can either:\n\n- Specify a file with an existing recording (`node index /path/to/pcap-ng-recording`) ***or***\n- Use a pipe to stream live data to the server (`node index \u003c \u003cstream source\u003e` for Windows CMD, `\u003cstream source\u003e | node index` for Linux)\n\nAfter starting the server like described above, it starts listening at `ws://127.0.0.1:\u003cPORT\u003e`, where `\u003cPORT\u003e` is the port you specified in the `PORT` environment variable (e.g. in `.env`).  \nYou can then paste this websocket URL (e.g. `ws://127.0.0.1:70` or `wss://server.example.com`) into the [GUI](https://github.com/Chaphasilor/ble-analyzer-gui) (you can also use the [live demo GUI here](https://ble-analyzer-gui.netlify.app/)) to start analyzing packets.  \nAfter clicking on `Confirm URL`, you can either click on `Load Packets` to load all received packets up to now, or click `Receive Live Packets` to continously monitor incoming packets received by the server.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchaphasilor%2Fble-analyzer-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchaphasilor%2Fble-analyzer-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchaphasilor%2Fble-analyzer-server/lists"}