{"id":22964886,"url":"https://github.com/susji/ruuviscan","last_synced_at":"2026-05-17T09:35:10.597Z","repository":{"id":230606459,"uuid":"779758796","full_name":"susji/ruuviscan","owner":"susji","description":"Minimalistic terminal tool for scanning Ruuvi sensors with Bluetooth Low Energy and dumping the data as JSON","archived":false,"fork":false,"pushed_at":"2024-04-01T15:02:36.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-07T19:13:48.573Z","etag":null,"topics":["ble","bluetooth-low-energy","go","golang","json","ruuvi","ruuvi-ble-devices","ruuvitag","ruuvitag-sensor"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/susji.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":"2024-03-30T17:49:46.000Z","updated_at":"2024-04-03T21:30:40.000Z","dependencies_parsed_at":"2024-03-30T19:45:17.641Z","dependency_job_id":"fb86daa7-4d37-4f2f-b6cb-1ea346f8c8fd","html_url":"https://github.com/susji/ruuviscan","commit_stats":null,"previous_names":["susji/ruuviscan"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/susji%2Fruuviscan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/susji%2Fruuviscan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/susji%2Fruuviscan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/susji%2Fruuviscan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/susji","download_url":"https://codeload.github.com/susji/ruuviscan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246753378,"owners_count":20828139,"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":["ble","bluetooth-low-energy","go","golang","json","ruuvi","ruuvi-ble-devices","ruuvitag","ruuvitag-sensor"],"created_at":"2024-12-14T20:12:47.829Z","updated_at":"2025-10-27T15:07:12.277Z","avatar_url":"https://github.com/susji.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ruuviscan\n\nThis is a small utility for scanning Bluetooth Low Energy (BLE) Advertisements\nfrom [Ruuvi sensors](https://ruuvi.com) and dumping the values as JSON to\nstandard output.\n\n# Building\n\nGrab a precompiled [release](https://github.com/susji/ruuviscan/releases) or use\nthe Go toolchain.\n\n# Usage\n\nSet the environment value `VERBOSE=1` if you wish to see more details when a\nRuuviTag Advertisement is received.\n\n## Dumping human-readable temperature values in real time\n\n```\n$ ./ruuviscan \\\n      | jq -rc 'select(.Temperature.Valid) | [.Timestamp, .MAC, .Temperature.Value] | @tsv'\n```\n\n## Storing temperature values in an SQLite database\n\nFirst create a suitable database file with a table for temperature data:\n\n```\n$ sqlite3 temps.db \u003c\u003c'EOF'\nCREATE TABLE temps (\n    timestamp TIMESTAMP NOT NULL,\n    mac STRING NOT NULL,\n    temp REAL NOT NULL\n)\nEOF\n```\n\nThen you can run the program to scan and store for the values:\n\n```\n$ ./ruuviscan \\\n    | jq --unbuffered -rc \\\n        'select(.Temperature.Valid) |\n             [.Timestamp, .MAC, .Temperature.Value] | @sh' \\\n    | while read -r _ts _mac _temp; do\n          sqlite3 temps.db \"INSERT INTO TEMPS VALUES ($_ts, $_mac, $_temp)\"\n      done\n```\n\nYou may also observe the latest values as they are recorded:\n\n```\n$ watch sqlite3 --readonly \\\n      \"temps.db \\\n           'SELECT COUNT(*) FROM temps;\n            SELECT * FROM temps ORDER BY timestamp DESC LIMIT 10;'\"\n```\n\nSee [temps.plt](./temps.plt) for an example how to plot the temperature data\nwith gnuplot.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsusji%2Fruuviscan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsusji%2Fruuviscan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsusji%2Fruuviscan/lists"}