zaoan0 GitHub avatar

funf-pro-relay

zaoan0

An open-source remote relay system for controlling the FUNF BoBoBei Pro BLE device, using a WebSocket-based middleware and Android foreground service to overcome background disconnection issues of the official app.

Stars

72

7-day growth

No data

Forks

20

Open issues

0

License

MIT

Last updated

2026-07-28

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It provides a complete, self-hosted alternative to the official app with reliable background BLE connections via Android foreground service, multi-user isolation, and a protocol layer that can be updated by editing JSON.

Who it is for

  • Couples in long-distance relationships who use FUNF devices
  • Self-hosters and privacy-conscious users
  • BLE reverse engineers and hardware tinkerers
  • Developers interested in relay system architecture

Use cases

  • Remote control of FUNF BoBoBei Pro from anywhere via a web dashboard
  • Stable long-distance intimate interaction without BLE dropouts
  • Self-hosted privacy-focused alternative to cloud-dependent apps
  • Protocol experimentation and customization by modifying JSON config

Strengths

  • Android foreground service with wake lock and battery optimization ensures persistent BLE connection
  • WebSocket relay with bidirectional heartbeat achieves ~200ms command latency
  • Protocol configuration is JSON-based, easy to adapt to new BLE commands
  • Multi-tenant security with PBKDF2 password hashing, Fernet encryption, and device key isolation

Considerations

  • BLE communication is not encrypted, so any device in range can connect
  • Device status is cached server-side, not real-time telemetry
  • Each device channel supports only one controller and one device at a time
  • Requires manual background app whitelisting per phone brand for reliability

README quick start

安装依赖

sudo pip3 install --break-system-packages -r server/requirements.txt

Related repositories

Similar projects matched by category, topics, and programming language.

lopopolo
Featured
lopopolo GitHub avatar

harness-engineering

Harness Engineering is a methodology for improving coding agent outputs by carefully crafting the environment around them—providing curated context, tools, and executable constraints that encode an organization’s nonfunctional requirements and cumulative lessons.

AI & Machine LearningAI Agents
2,390
slvDev
Featured
slvDev GitHub avatar

esp32-ai

A 28.9 million parameter language model runs on an $8 ESP32-S3 microcontroller entirely on-device, generating simple stories at about 9.5 tokens per second.

AI & Machine LearningLarge Language Models
1,960
littledivy
Featured
littledivy GitHub avatar

mimic

mimic captures traffic from any iOS or web app and automatically generates a Python client library that lets you call the app's API like a regular library.

AI & Machine Learning
1,482