# toniebox-reverse-engineering/teddycloud

teddyCloud is an open source server replacement for the Boxine Cloud

Repository: https://github.com/toniebox-reverse-engineering/teddycloud
Canonical: https://ross.abutalabs.com/products/teddycloud
Homepage: https://toniebox-reverse-engineering.github.io/docs/tools/teddycloud/
Language: C
License: GPL-2.0
License Family: copyleft
Topics: teddy, toniebox, teddycloud
Last push: 2026-08-25T11:10:32+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 87, longevity 95
- inputs: {"age_days": 1335, "days_push": 8, "days_rel": 8, "gap_med": 64.5, "n_releases_24m": 9}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1026, forks 77 (observed 2026-08-28T04:03:16.750394+00:00)

## What it is
TeddyCloud is an open-source replacement server for the Boxine Cloud that lets Toniebox owners host cloud services locally, serving their own audio content to the box and controlling what data reaches the manufacturer. It includes a web GUI, audio conversion via ffmpeg, MQTT/Home Assistant integration, and CLI tools for certificate extraction and Tonie Audio File manipulation.

## Use cases
- self-host a replacement cloud server for my toniebox
- serve my own audio files to a toniebox over the air
- stop sending toniebox data to the manufacturer's cloud
- convert mp3 files to tonie audio files
- assign custom nfc tags to my own audio content
- integrate my toniebox with home assistant
- extract certificates from an esp32 firmware dump
- cache original tonie content locally

## When to choose
- you own a Toniebox and want local control over its cloud services and content
- you want to host custom audio content on your own NAS or server
- you want smart-home integration via MQTT and Home Assistant
- you need CLI tools for TAF encoding or firmware certificate extraction

## When to avoid
- you are unwilling to open the box and replace its CA certificates
- you own a Toniebox 2, which is not yet supported
- you want a plug-and-play solution with no networking setup (Docker, DNS, TLS)
- you are looking for a general-purpose media server unrelated to Toniebox

## Facets
- artifact type: application
- maturity: active
- function: http-server, self-hosted, audio-processing, security
- domain: self-hosted, hardware, reverse-engineering, media, privacy
- platform: windows, self-hosted, cli
- tags: toniebox, reverse-engineering, cloud-replacement, mqtt, home-assistant, iot, audio-content, nfc-tags, esp32, firmware-tools, automation, linux, macos, docker, web-server

## Member repositories
- toniebox-reverse-engineering/teddycloud (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:16.750394+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:08:00.108334+00:00, confidence not recorded.
  - readme: https://github.com/toniebox-reverse-engineering/teddycloud (fetched 2026-08-28T04:03:16.750394+00:00, sha 8479f88422e3)
  - homepage: https://toniebox-reverse-engineering.github.io/docs/tools/teddycloud/ (fetched 2026-08-29T13:08:20.082169+00:00, sha 6f3327cadbe3)
  - site_page: https://tonies-wiki.revvox.de/docs/how-to-get-started (fetched 2026-08-29T13:08:20.084682+00:00, sha e182a1fa9cc9)
  - site_page: https://tonies-wiki.revvox.de/docs/rules (fetched 2026-08-29T13:08:20.086450+00:00, sha 4a596c6fa998)
  - site_page: https://tonies-wiki.revvox.de/docs/faq (fetched 2026-08-29T13:08:20.088049+00:00, sha 1afc8fbcaff4)
  - site_page: https://tonies-wiki.revvox.de/docs/tools/teddybench (fetched 2026-08-29T13:08:20.089609+00:00, sha 3425c811ae41)
  - site_page: https://tonies-wiki.revvox.de/docs/tools/teddycloud/usage/custom-tags (fetched 2026-08-29T13:08:20.091149+00:00, sha 9e8a0f8eb4af)
  - site_page: https://tonies-wiki.revvox.de/docs/tools/teddycloud/setup (fetched 2026-08-29T13:08:20.092921+00:00, sha 745f1d0954d0)
  - site_page: https://tonies-wiki.revvox.de/docs/tools/teddycloud/setup/dump-certs (fetched 2026-08-29T13:08:20.094598+00:00, sha 20768128e9b3)
  - site_page: https://tonies-wiki.revvox.de/docs/tools/teddycloud/setup/dump-certs/cc3200 (fetched 2026-08-29T13:08:20.096177+00:00, sha fa0356ecc7c6)
- Data as of 2026-08-30T08:39:29.467469+00:00.