{"id":46806460,"url":"https://github.com/technocreatives/beckon-android","last_synced_at":"2026-03-10T07:16:13.016Z","repository":{"id":40425333,"uuid":"364517134","full_name":"technocreatives/beckon-android","owner":"technocreatives","description":"A safe and correct Bluetooth Low Energy (BLE) library for Android with functional data types and Kotlin Coroutines and RxJava2 interface.","archived":false,"fork":false,"pushed_at":"2023-03-21T13:08:23.000Z","size":1229,"stargazers_count":11,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2023-10-18T04:01:48.189Z","etag":null,"topics":["android","ble","bluetooth","bluetooth-mesh","coroutines","coroutines-flow","dfu","functional","kotlin","rxjava","rxjava2"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","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/technocreatives.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE-APACHE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-05-05T08:57:49.000Z","updated_at":"2023-05-08T05:18:53.000Z","dependencies_parsed_at":"2023-02-01T02:45:25.648Z","dependency_job_id":null,"html_url":"https://github.com/technocreatives/beckon-android","commit_stats":null,"previous_names":[],"tags_count":6,"template":null,"template_full_name":null,"purl":"pkg:github/technocreatives/beckon-android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technocreatives%2Fbeckon-android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technocreatives%2Fbeckon-android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technocreatives%2Fbeckon-android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technocreatives%2Fbeckon-android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/technocreatives","download_url":"https://codeload.github.com/technocreatives/beckon-android/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/technocreatives%2Fbeckon-android/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30326893,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T05:25:20.737Z","status":"ssl_error","status_checked_at":"2026-03-10T05:25:17.430Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["android","ble","bluetooth","bluetooth-mesh","coroutines","coroutines-flow","dfu","functional","kotlin","rxjava","rxjava2"],"created_at":"2026-03-10T07:16:11.124Z","updated_at":"2026-03-10T07:16:12.862Z","avatar_url":"https://github.com/technocreatives.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Beckon [![](https://jitpack.io/v/technocreatives/beckon-android.svg)](https://jitpack.io/#technocreatives/beckon-android)\n\nA safe, correct and pleasant Bluetooth Low Energy (BLE) library for Android with functional data types and reactive interface.\n\n## Introduction\n\nThis library aims to solve many of the pains that Android developers have to endure in their life when working with Android BLE.\n\nBy using functional programming approach and reactive interface, this library (will) provides:\n\n  - Sane and simple Api with Coroutines/Flow.\n  - The best error handling ever which is backed by [Arrow](https://arrow-kt.io/).\n  - Support all BLE operations (read, write, notifications, bond). Thanks to [NordicSemiconductor/Android-BLE-Library](https://github.com/NordicSemiconductor/Android-BLE-Library)!\n  - Support BLE Mesh. Thanks to [NordicSemiconductor/Android-nRF-Mesh-Library](https://github.com/NordicSemiconductor/Android-nRF-Mesh-Library)\n  - Support DFU over BLE. Thanks to [NordicSemiconductor/Android-DFU-Library](https://github.com/NordicSemiconductor/Android-DFU-Library)\n\n## Setup \u003ca name = \"setup\"\u003e\u003c/a\u003e\n\nYou can get `Beckon` by using [Jitpack](https://jitpack.io/#technocreatives/beckon-android).\n\n```Gradle\n    repositories {\n        mavenCentral()\n        maven { url 'https://jitpack.io' }\n    }\n\n    // Beckon\n    implementation \"com.github.technocreatives.beckon-android:beckon:main-SNAPSHOT\"\n\n    // Beckon DFU\n    implementation \"com.github.technocreatives.beckon-android:beckon-dfu:main-SNAPSHOT\"\n\n    // Beckon Mesh\n    implementation \"com.github.technocreatives.beckon-android:mesh-data:main-SNAPSHOT\"\n    implementation \"com.github.technocreatives.beckon-android:beckon-mesh:main-SNAPSHOT\"\n```\n\n## Compatibility \u003ca name = \"compatibility\"\u003e\u003c/a\u003e\n\nThe library uses arrow, version `1.1.2`, to provide well typed [Either](https://arrow-kt.io/docs/apidocs/arrow-core/arrow.core/-either/) results for error handling. A basic understanding of how Arrow's work is essential.\n\n## Contributing \u003ca name = \"contributing\"\u003e\u003c/a\u003e\n\nAny bug reports, feature requests, questions and pull requests are very welcome.\n\n## Modules \u0026 Features\n\n### Beckon\n\nBasic BLE connection to devices\n\n- Scan\n- Connect/disconnect a device\n- Create/remove Bond\n- Save/remove (A new concept from Beckon)\n- Descriptor with requirements on a device\n\n### Beckon DFU\n\nWrapper around [NordicSemiconductor/Android-DFU-Library](https://github.com/NordicSemiconductor/Android-DFU-Library)\n\n- Sealed interface of results during the process of a DFU (Starting, EnablingBootloader, Uploading and Success/Aborted/Error)\n- Process to view current state and abort a DFU process\n\n### Beckon Mesh\n\n- Exposes mesh states for Loaded, Connected \u0026 Provisioning\n- Support multiple meshes\n- Observe changes to mesh configuration\n- Exposes sendMessage as suspend for Ack message\n- Typed Configuration messages\n- ProxyFilterMessage that types AccessPayload and OpCode (e.g Single, Double \u0026 Triple octet)\n\n#### Mesh Data\n\n- Well typed and formatted Mesh Config, compatible with [NordicSemiconductor/Android-nRF-Mesh-Library](https://github.com/NordicSemiconductor/Android-nRF-Mesh-Library) and [NordicSemiconductor/IOS-nRF-Mesh-Library](https://github.com/NordicSemiconductor/IOS-nRF-Mesh-Library)\n- Serializable\n\n## Workflow\n\n```\n-\u003e Create a new branch\n-\u003e Push a lot of commits\n-\u003e Create a new PR to master\n-\u003e Push a lot of commits\n-\u003e Do code review \u0026 discuss\n-\u003e make sure ci agrees with what you did\n-\u003e Rebase to master (if needed)\n-\u003e Squash into one commit (and write a beautiful commit message)\n-\u003e If team agrees then merge to master\n```\n\n## Limitation\n\nThis library is not feature complete, feel free to make a PR if you wish to add functionality that is missing.\n\n## License\n\nLicensed under either of these:\n\n- Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or\n  https://www.apache.org/licenses/LICENSE-2.0)\n- MIT license ([LICENSE-MIT](LICENSE-MIT) or\n  https://opensource.org/licenses/MIT)\n\n### Contributing\n\nUnless you explicitly state otherwise, any contribution you intentionally submit\nfor inclusion in the work, as defined in the Apache-2.0 license, shall be\ndual-licensed as above, without any additional terms or conditions.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechnocreatives%2Fbeckon-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechnocreatives%2Fbeckon-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechnocreatives%2Fbeckon-android/lists"}