RR App (`rr_emg`)

Language: English | 繁體中文 | 简体中文

Overview

rr_emg is a desktop GUI for Bluetooth monitoring and control.

It supports:

EMGS devices (EMG + IMU streaming)
AKR-compatible devices (including rr_akr2 protocol behavior and other compatible devices such as EMGS-family products)

Typical use:

scan and connect to devices,
monitor live data,
send control/configuration commands,
record sessions for analysis.

Audience

Operators and clinicians
R&D teams
Integrators and developers

For operator-focused instructions, see IFU.md.

Requirements

Python >=3.10,<3.14
Bluetooth-capable host (macOS / Linux / Windows)

Installation

Option 1: Release packages (recommended for most operators)

Download from GitHub Releases.

Windows: rr-app-<version>-setup.exe
macOS: rr-app-<version>-macos.dmg
Linux: rr-app-<version>-linux-<arch>.AppImage

Pushing a v* git tag attaches these unsigned packages to that GitHub Release (and publishes PyPI separately). On macOS, if Gatekeeper warns, right-click the app and choose Open.

Option 2: PyPI / pipx

pip install rr-app

pipx install rr-app

Option 3: From source (developer path)

python -m venv .venv
source .venv/bin/activate
pip install -e .

Quick Start

Turn on host Bluetooth.
Power on target device(s).
Launch:

rr

Scan and connect in the app.
Use Signals tab for live monitoring.
Use settings/control actions as needed.
Start recording when session export is required.

Simulation mode (no hardware):

RR_BACKEND=sim rr

Device Compatibility Notes

EMGS discovery prefix: EMGS
AKR discovery prefixes: AKR and KNR
AKR BLE profile fallback is built-in (new profile first, legacy profile fallback)

Protocol and OTA Docs

AKR/BT CLI + telemetry: doc/BT_AKR_DEVICE_PROTOCOL.md
OTA CLI session protocol: doc/OTA_PROTOCOL_CLI_SESSION.md

Data and Logs

Startup logs:
- macOS: ~/Library/Logs/rr-app
- Linux/Windows: ~/.rr-app/logs
Default recording folder: ~/rr_data

Project Links

Homepage: RR_EMG
Issues: GitHub Issues

Metadata

Release files for rr-app 1.12.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rr-app 1.12.14
File	Size	Uploaded	Provenance
rr_app-1.12.14.tar.gz	290.6 kB	Oct 21, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for rr-app 1.12.14
File	Interpreter	ABI	Platform	Reset
rr_app-1.12.14-py3-none-any.whl 315.4 kB Oct 21, 2026 With provenance	Python 3	none	any	Details

Total release size: 606.0 kB

Release files / rr_app-1.12.14.tar.gz

Download URL	rr_app-1.12.14.tar.gz
Size	290.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`2c6767c2c86c291f69d55d8aded45322968f44e85cb2bd194d8b0348c343dc26`
BLAKE2b-256 checksum How to use checksums	`f8fe72a7ffac5a68c18fced102f710bd93d6c2fb5032da436652583d1c012c9b`
Upload date	Oct 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/o0fung/rr_app
Publishing commit: github.com/o0fung/rr_app/tree/0d53d9b26c9d79aed44375169e0e103f3e1815d0

Workflow

Publishing configuration: github.com/o0fung/rr_app/blob/0d53d9b26c9d79aed44375169e0e103f3e1815d0/.github/workflows/publish.yml
Publishing logs: github.com/o0fung/rr_app/actions/runs/39543145667/attempts/1

Artifact

Subject: rr_app-1.12.14.tar.gz
SHA-256 checksum: 2c6767c2c86c291f69d55d8aded45322968f44e85cb2bd194d8b0348c343dc26 Verifying attestations

Release files / rr_app-1.12.14-py3-none-any.whl

Download URL	rr_app-1.12.14-py3-none-any.whl
Size	315.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5097952ee51fd084f775555d6b691eab915bded1dbc38fae771812371ca281b7`
BLAKE2b-256 checksum How to use checksums	`a1ba6a0f3316c9e74bc21eefc83294330b5d9bc0a61a7bf503529df3ce9a3609`
Upload date	Oct 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.16`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/o0fung/rr_app
Publishing commit: github.com/o0fung/rr_app/tree/0d53d9b26c9d79aed44375169e0e103f3e1815d0

Workflow

Publishing configuration: github.com/o0fung/rr_app/blob/0d53d9b26c9d79aed44375169e0e103f3e1815d0/.github/workflows/publish.yml
Publishing logs: github.com/o0fung/rr_app/actions/runs/39543145667/attempts/1

Artifact

Subject: rr_app-1.12.14-py3-none-any.whl
SHA-256 checksum: 5097952ee51fd084f775555d6b691eab915bded1dbc38fae771812371ca281b7 Verifying attestations

Security for rr-app 1.12.14

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for rr_app-1.12.14.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/o0fung/rr_app
Publishing commit: github.com/o0fung/rr_app/tree/0d53d9b26c9d79aed44375169e0e103f3e1815d0

Workflow

Publishing configuration: github.com/o0fung/rr_app/blob/0d53d9b26c9d79aed44375169e0e103f3e1815d0/.github/workflows/publish.yml
Publishing logs: github.com/o0fung/rr_app/actions/runs/39543145667/attempts/1

Artifact

Subject: rr_app-1.12.14.tar.gz
SHA-256 checksum: 2c6767c2c86c291f69d55d8aded45322968f44e85cb2bd194d8b0348c343dc26 Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.