{"id":25866280,"url":"https://github.com/lupin3000/colmismartring","last_synced_at":"2025-07-12T16:37:10.939Z","repository":{"id":275115848,"uuid":"925118346","full_name":"Lupin3000/ColmiSmartRing","owner":"Lupin3000","description":"Read information via Python from Colmi Smart Ring","archived":false,"fork":false,"pushed_at":"2025-02-23T08:09:43.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-18T23:42:00.916Z","etag":null,"topics":["ble","colmi","python","smart-ring"],"latest_commit_sha":null,"homepage":"https://softwaretester.info","language":"Python","has_issues":false,"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/Lupin3000.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-01-31T09:09:45.000Z","updated_at":"2025-02-23T08:09:47.000Z","dependencies_parsed_at":"2025-03-02T02:31:38.881Z","dependency_job_id":"7f7991cb-f12b-4cea-aa2c-f4d2392b55a5","html_url":"https://github.com/Lupin3000/ColmiSmartRing","commit_stats":null,"previous_names":["lupin3000/colmismartring"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Lupin3000/ColmiSmartRing","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lupin3000%2FColmiSmartRing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lupin3000%2FColmiSmartRing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lupin3000%2FColmiSmartRing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lupin3000%2FColmiSmartRing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Lupin3000","download_url":"https://codeload.github.com/Lupin3000/ColmiSmartRing/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lupin3000%2FColmiSmartRing/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265024279,"owners_count":23699589,"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","colmi","python","smart-ring"],"created_at":"2025-03-02T02:29:16.827Z","updated_at":"2025-07-12T16:37:10.689Z","avatar_url":"https://github.com/Lupin3000.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Colmi Smart Ring - Python\n\n## Minimum requirements\n\n[![Static](https://img.shields.io/badge/python-\u003e=3.12.x-green)](https://python.org)\n[![Static](https://img.shields.io/badge/asyncio-==3.4.3-green)](https://docs.python.org/dev/library/asyncio.html)\n[![Static](https://img.shields.io/badge/bleak-==0.22.3-green)](https://bleak.readthedocs.io/en/latest/)\n\n## Installation\n\n\u003e Tested with Colmi Smart Ring R06 (_but should work with mostly all Colmi Smart Rings_).\n\n1. Clone this repository\n2. Create Python virtualenv (_recommended_)\n3. Install required Python modules/packages (_via requirements.txt_)\n\n```shell\n# clone repository\n$ git clone https://github.com/Lupin3000/ColmiSmartRing.git\n\n# change into cloned directory\n$ cd ColmiSmartRing/\n\n# create virtualenv\n$ python -m venv .venv\n\n# activate virtual environment\n$ .venv/bin/activate\n\n# update pip (optional)\n(.venv) $ pip3 install -U pip\n\n# show content of requirements.txt (optional)\n(.venv) $ cat requirements.txt\n\n# install all modules/packages\n(.venv) $ pip3 install -r requirements.txt\n\n# list all modules/packages (optional)\n(.venv) $ pip3 freeze\n```\n\n## Scan for Colmi Smart Ring\n\n\u003e To use all Python scripts, you need the BLE address of your Colmi Smart Ring!\n\n```shell\n# scan for smart ring address\n(.venv) $ python3 ColmiRingScanner.py\n```\n\nSometimes the scanner will not find the Colmi Smart Ring, please try again! If you found the Colmi Smart Ring and selected it. The Python script will create a new directory (_config_). Inside this newly created directory a new file is created (_colmi_address.py_) with two constants (_RING_NAME and RING_ADDRESS_). These constants are used later by all other Python scripts.\n\n## Read data from Colmi Smart Ring\n\n**Note:** Sometimes the BLE connection will not be established on first run, just try the respective Python script again.\n\n### Accelerometer\n\n\u003e This Python script will read and print continuously the data from accelerometer (_X, Y, Z_).\n\u003e\u003e To stop the script and BLE connection press keys: [Ctrl] + [c].\n\n```shell\n# read accelerometer data \n(.venv) $ python3 ColmiRingAccelerometer.py\n```\n\n### Real-time Heart Rate\n\n\u003e This Python script will read max. 5 values and print the average data for heart-rate (_bpm_).\n\u003e\u003e To stop the script and BLE connection press keys: [Ctrl] + [c].\n\n```shell\n# read heart rate data \n(.venv) $ python3 ColmiRingHeartRate.py\n```\n\n### Real-time SpO2\n\n\u003e This Python script will read max. 5 values and print the average data for SpO2 (_%_).\n\u003e\u003e To stop the script and BLE connection press keys: [Ctrl] + [c].\n\n```shell\n# read SpO2 data \n(.venv) $ python3 ColmiRingSPO2.py\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flupin3000%2Fcolmismartring","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flupin3000%2Fcolmismartring","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flupin3000%2Fcolmismartring/lists"}