{"id":18735161,"url":"https://github.com/irontec/ibeacons-simple-tools","last_synced_at":"2025-04-12T19:13:18.477Z","repository":{"id":35312852,"uuid":"39574329","full_name":"irontec/ibeacons-simple-tools","owner":"irontec","description":"iBeacon + LE scan from your terminal","archived":false,"fork":false,"pushed_at":"2015-07-23T15:52:27.000Z","size":136,"stargazers_count":9,"open_issues_count":2,"forks_count":5,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-12T19:12:40.878Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/irontec.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-07-23T15:11:00.000Z","updated_at":"2020-05-18T03:45:53.000Z","dependencies_parsed_at":"2022-09-17T06:21:48.493Z","dependency_job_id":null,"html_url":"https://github.com/irontec/ibeacons-simple-tools","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/irontec%2Fibeacons-simple-tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irontec%2Fibeacons-simple-tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irontec%2Fibeacons-simple-tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irontec%2Fibeacons-simple-tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/irontec","download_url":"https://codeload.github.com/irontec/ibeacons-simple-tools/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248618283,"owners_count":21134201,"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-11-07T15:15:55.784Z","updated_at":"2025-04-12T19:13:18.439Z","avatar_url":"https://github.com/irontec.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# iBeacons-simple-tools\nUsing easily your BLE as an iBeacon or use them as a LE Scanner to find out any iBeacon near you.\n\n### Requisties\n\nThe folowing binaries must be accesible from your $PATH\n * hciconfig\n * hcidump\n * hcitool\n\nOn Debian based Distributions:\n```bash\napt-get install -y bluez bluez-hcidump\n```\n\n\n## launch-ibeacon\nThe script will allow you to convert your little BLE dongle into a fully configurable iBeacon.\n\n**Usage:**\n```bash\n./launch-ibeacon -i hciN -u UUID -M MAYOR -m MINOR -p dBm\n```\nDefault Values:\n * -i hci0\n   * HCI Device (as listed with _hciconfig -a_)\n * -u 00000000-0000-0000-0000-000000000000\n   * UUID will be left-padded with \"0\", and truncated to 32 chars. Illegal Characters will be ignored.\n * -M 0\n   * Mayor value, specified in decimal. Never bigger than 65535 (0xFFFF)\n * -m 0\n   * Minor value, specified in decimal. Never bigger than 65535 (0xFFFF)\n * -p \"-59\"\n   * Measured Power in dBm (the script will transform the values as a two complement)\n\n**Example:**\n```bash\n\n# ./launch-ibeacon -i hci1 -u 01 -M 666 -M 333 -p \"-59\"\n · Setting up hci1 [leadv, noscan] ✓\n · Setting up beacon payload ✓\n     UUID: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 01\n     MAYOR: 01 4D (333)\n     MINOR: 00 00 (0)\n     POWER: C5 (-59)\n · Activating Beacon ✓\n     hcitool -i hci1 cmd 0x08 0x0008 1E 02 01 1A 1A FF 4C 00 02 15 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 01 01 4D 00 00 C5 00\n\n ```\n\n\n## ibeacon-scan\nThis little script will allow you to listen to any ibeacon near you.\n\nThe script is **heavily** based on [iBeacon Scan](http://developer.radiusnetworks.com/ibeacon/idk/ibeacon_scan) by Radius Networks.\n(Only a few changes made in order to allow specify HCI device)\n\nUsage:\n```bash\n# ./ibeacon-scan [-i hciX] [-b (bare output, easely parseable)]\n````\n\nDefault Values:\n * -i _hci0_\n\n\nThe command will enable \"lescan\" mode on hciX, and will be generating the following output perpetually:\n```text\nUUID: 00000000-0000-0000-C000-000000000028 MAJOR: 1 MINOR: 1 POWER: -59\nUUID: 00000000-0000-0000-C000-000000000028 MAJOR: 1 MINOR: 1 POWER: -59\nUUID: 23A01AF0-232A-4518-9C0E-323FB773F5EF MAJOR: 35469 MINOR: 29443 POWER: -77\nUUID: 23A01AF0-232A-4518-9C0E-323FB773F5EF MAJOR: 52606 MINOR: 13223 POWER: -77\nUUID: 00000000-0000-0000-C000-000000000028 MAJOR: 1 MINOR: 1 POWER: -59\nUUID: 23A01AF0-232A-4518-9C0E-323FB773F5EF MAJOR: 4322 MINOR: 34831 POWER: -77\nUUID: 00000000-0000-0000-0000-000000000000 MAJOR: 0 MINOR: 0 POWER: -59\nUUID: 00000000-0000-0000-C000-000000000028 MAJOR: 1 MINOR: 1 POWER: -59\nUUID: 23A01AF0-232A-4518-9C0E-323FB773F5EF MAJOR: 35469 MINOR: 29443 POWER: -77\nUUID: 23A01AF0-232A-4518-9C0E-323FB773F5EF MAJOR: 52606 MINOR: 13223 POWER: -77\nUUID: 23A01AF0-232A-4518-9C0E-323FB773F5EF MAJOR: 52606 MINOR: 13223 POWER: -77\nUUID: 23A01AF0-232A-4518-9C0E-323FB773F5EF MAJOR: 4322 MINOR: 34831 POWER: -77\nUUID: 23A01AF0-232A-4518-9C0E-323FB773F5EF MAJOR: 35469 MINOR: 29443 POWER: -77\nUUID: 23A01AF0-232A-4518-9C0E-323FB773F5EF MAJOR: 52606 MINOR: 13223 POWER: -77\nUUID: 23A01AF0-232A-4518-9C0E-323FB773F5EF MAJOR: 52606 MINOR: 13223 POWER: -77\n```\n\nIf \"-b\" option is passed:\n```text\n00000000-0000-0000-C000-000000000028 1 1 -59\n00000000-0000-0000-0000-000000000000 0 0 -59\n00000000-0000-0000-C000-000000000028 1 1 -59\n23A01AF0-232A-4518-9C0E-323FB773F5EF 35469 29443 -77\n23A01AF0-232A-4518-9C0E-323FB773F5EF 52606 13223 -77\n00000000-0000-0000-C000-000000000028 1 1 -59\n00000000-0000-0000-C000-000000000028 1 1 -59\n23A01AF0-232A-4518-9C0E-323FB773F5EF 4322 34831 -77\n00000000-0000-0000-0000-000000000000 0 0 -59\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Firontec%2Fibeacons-simple-tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Firontec%2Fibeacons-simple-tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Firontec%2Fibeacons-simple-tools/lists"}