Toniebox Hacking – How to get started

Over the last three years we, the Team RevvoX (formed in Nov. 2019) came up with a lot of information regarding all the possibilities that can be done with Tonieboxes besides the origin features.

We achieved to bring, own content, own NFC tags, customization and even some hardware mods to the Toniebox. In addition we have supported a lot of repairs for otherwise ‘dead’ boxes with our knowledge of the different revisions of the PCB to check or exchange the right components (we even have a complete reverse engineered hardware layout within our wiki).

Within this Blog Post I would like to give a short introduction to all new community members that are interested in tinkering with the new toy that their children got for Christmas or any other occasion.

You can find all members of the Team RevvoX within our Telegram Group. We are looking forward to see you there and are more than willing to answer your questions if there is anything left open.

What can be done without any FW or HW modification?

There are several different levels how to modify the Toniebox and the user’s experience without changing the hardware or the firmware.

Custom Content on the Toniebox

We as Team RevvoX introduced a software called TeddyBench, which is a GUI based Software for Windows that lets you add your own audio content to any Toniebox independently from the Tonie Cloud. Therefore, you can grab some mp3 files and encode them as TAF (Tonie Audio File) and implement them on the build-in microSD Card of the Toniebox.

This can be done just by getting access to the microSD card and placing this into any microSD card reader on the PC. TeddyBench will recognize all Contents that are already stored / downloaded to the box. After encoding some own audio content you can place the card back into the Toniebox and it will work.

No firmware modification nor other hardware hacks needed.

Custom NFC tags

To let the Toniebox play your own content, you need to have some way to let the box know what it should play. Therefore we figured out, what kind of NFC Chip is used within the figurines and how it is linked to the box and its content. If you like to understand how this works, please feel free to read one of my older blogs dedicated to the internals (click here).

By using custom tags you can let your box play your custom content.

TeddyBench helps you to get the link between the custom tag and your custom audio content set. For this you need the 8 Byte long UID of your custom tags.
There are several ways to read the UID of the custom tags, such as using smartphone apps (iOS: NFC Tools, NXP Tag Info; Android: NXP Tag Info), hardware tools like the Proxmark3 or the Flipper zero, or an Arduino with a compatibel NFC reader (e.g. ESP8266 with a PN5180).

IMPORTANT: Once the tag is placed on the Toniebox you will NOT be able to read the UID of the custom tags because the Toniebox will enable the “privacy mode” on this tag. What this is and how to get out of this mode, you can read in the section “Important things to know” further down this Blog post.
The solution to this is FIRST read ALL UIDs from your custom tag, write them down and then start using them with the Toniebox.

Where can I get the right custom tags that will work with my Toniebox?

[RFIDfriend] is the answer and the recommend source by Team RevvoX! He spent a lot of time and effort figuring out where to get the right tags and was able to source some of these. By going back and forth with some Chinese RFID label manufactures and buying a lot of wrong NFC tags, he was eventually able to get his hands on the right ones. They come in form of round sticky labels.
RFIDfriend has some of these tags left and is more than willing to hand these over to some tinkerers. You can find him on Kleinanzeigen, or can contact him directly via Telegram Chat or via eMail (he sends these international as well). The best way is to contact him via eMail.
Be aware that there are some Chinese fakes going around as well! These tend to fail after minimal use. But you can be assured that RFIDfriend is only handling tags with the original NXP chip build in.

Play original content with custom tags

The way the Toniebox works is that as soon as a figurine is placed on top of the box, it checks whether the related content is already on the internal microSD card and starts to play it back, or it starts downloading the corresponding audio content from the Tonie Cloud and saves this on the microSD card while it starts playing it back.

While there are many possibilities to exchange these figurines with friends, from the kindergarten or even from public libraries, the content will remain on the microSD card of your Box even if the figurines are returned to their owners.

TeddyBench can identify the content on your microSD card and you can relink this to custom tags. This allows you to play the original Tonie audio content even if you no longer have the original figurine on hand.

Within TeddyBench you just do a simple double click on the identified content and it will open a popup window that shows the UID of the original Tonie figurine to that the audio content is linked to. You can now edit this UID to the UID of your custom tag. That’s all it takes to continue playing the content that has already been downloaded to your Toniebox.

In case you are interested in the legal matter: In Germany, Austria and Switzerland, this is called “Privatkopie” and is covered by relevant law.

Downside of going the custom content / custom NFC tag way

There is just one downside to this. You have to keep the box in Offline Mode, or just cut off the internet connection for your Toniebox via your internet router settings.

Every time the box starts up it is verifying the whole content that is stored on the internal microSD card with the Tonie Cloud. This is eventually leading to the deletion of content that is not linked to UIDs known to the Tonie Cloud when the according custom tag is placed on top of the box (while this is online). Even the unplayed custom content is changed so that the resume feature will not work for it anymore, even after switching back to Offline Mode.

Why exactly this takes place and how you can get away with the Offline Mode and live with this while still using original Tonie figurines, you can find in the section further down in this article about the “important things to know”.

What can be done with Bootloader / FW modification?

The PCB design of the Toniebox has a Debug Connector present. This arouses even more curiosity about going further down that rabbit hole. In this section I will just briefly explain what can be done so far.
If you are interested in how to make a full dump of the flash, take a look into my older blog post where I explain in detail how to do this.
Information about how to install the custom bootloader, please take a look into our wiki.

IMPORTANT: As of now only the Toniebox V1 and V2 are able to get the Bootloader / FW mod. The V3 uses another microcontroller and is not yet ready for this. We are working hard on this…

Custom Bootloader / HackieboxNG SD bootloader

The Bootloader is the first thing that gets started when the microcontroller gets powered up. It takes care of preparing some basic stuff AND will eventually load the Toniebox firmware.

The HackieboxNG SD bootloader enables two main features to the user:

  • switch between different firmwares (up to nine OFWs and CFWs)
  • patching the original firmware on startup

Switching between different firmwares

By pressing the ear buttons in a certain order, the box will prompt you with a different blinking sequence at the center light, signaling that you are in the FW switching mode. Here you can switch between nine firmware slots. These can be either different versions of the original firmware or could be custom firmware (see next section).

Patching the original firmware on startup

With patches for the original firmware you can add certain features to the normal use of your Toniebox. To name a few:

  • disable privacy mode
    the privacy mode for the figurines and custom tags will remain disabled after removing them from the box
  • disrupt the connection to the Tonie Cloud
  • use of alternative NFC tags
    enables the use of other NFC standards in addition to the one demanded by the Toniebox
  • disable hidden mode
    blocks the verification at the start of the content directory with the cloud. This way, the custom content will not get the “hidden flag” (see section “important to know”)

More details and How Tos can be found in our wiki.

Custom Firmware (CFW)

The custom firmware (CFW) by Team RevvoX is as of now just a proof of concept and not able to serve as a daily use firmware for the Toniebox.
You can play single WAV files and see differnt hardware status within a webpage that is provided. Even a file transfer is possible (that is far too slow to use it as a content handler).

If my words did not hold your interest and you like to support further development to a useable solution that is capable to play TAFs, please visit our wiki for more information.

What hardware hacks can be done?

relocation of microSD card reader

Because managing the content on the microSD card with TeddyBench requires regular access to the microSD card, and a complete teardown of the Toniebox would take some time (although we did some speedruns to proof how fast we are), we came up with a simple hardware modification that lets you relocate the microSD card holder to the bottom of the Toniebox just behind the lid.

For this mod you would need a microSD card extension which is at least 25cm long (longer than that is fine, there is enough space within the Toniebox to place longer cables).

Here are some Amazon Links to the needed extension. (some of them are now and then not available. Thats why I pasted some more links).

If you like to procure a ready modified cable where the housing and the resistor is removed, please take a look at this offer.

Here are some Pics that show how the mod is done. A detailed write up is in the making.

Quick HowTo: remove black plastic housing of extension; remove red marked resistor from extension PCB (e.g. with plier); make two small cut outs in the screw studs; slide extension PCW in between the studs; use some hot glue to fix the PCB; take care that when the microSD card is inserted the upper side of the card is slightly higher than the surrounding surface (this way you can press it and it will come up to grab it with your fingers).

The red marked resistor needs to be removed. Otherwise the Toniebox will not be able to read the microSD card!

Inserting the microSD card extension into the microSD card holder on the PCB takes a bit of gentle force. There is one larger (silver cylindrical) part right next to the holder. But if you give a bit pressure on the whole package you will be able to close the lid of the microSD card holder.

Build your own figurines and tags

The original figurines are definetly an outstanding feature of the Toniebox. My kids love to play with these even without the Toniebox. But sometimes they are very bulky as well. Especially while traveling. Therefore I came up with the “Travel Tonie”. It is a coin shaped custom tag that includes a picture of the original figurine, a magnet and a NFC tag from RFIDfriend (the round sticker). This way we are able to bring much more Storys with us on our journeys.

Here are some Pics that show how these tags are build up. A detailed write up is in the making.

I used the following coin cases and magnets:

What else is possible?

Support of Proxmark3

The Proxmark3 is a powerfull NFC / RFID / hacking device. But at that point of time when we were trying to read the NFC tags build in the Tonie figurines, it was not able to read tags where the “Privacy Mode” was enabled.
Thats why we came up with a firmware mod, that would add three Toniebox related features:

  • disable privacy mode at tonie figurines / custom tags (with known passwords)
  • communicate with TeddyBench
  • emulate NFC tags for the Toniebox

Use TeddyBench with the support of Proxmark3

TeddyBench can change the linked UID of the audio content on the microSD card. This can be done by double clicking on the audio content to be changed. A window will open and present the actual linked UID which can be edited. This can be either done by manually enter the new UID via the keyboard (the UID must be read prior to this with your smartphone app), or you could just place the tag onto the Proxmark3, which will disable the privacy mode and enter the UID for you.

In addition it will show you the linked content within the Content frame of TeddyBench. If you place any used tag onto the Proxmark3, it will directly highlight the linked content so that you know immediately what this tag is connected to at the moment.

Here are some links to get your hands on the Proxmark3

Emulating Tonies using Proxmark3

The NFC tags used for the Toniebox store in total 40 Bytes of data. 8 Byte are used for the UID and 32 Bytes are stored within the memory blocks (8 Blocks á 4 Bytes).
With the Dump feature build into TeddyBench you can use the Proxmark3 to read the complete data from tags. This data can be used to emulate a NFC tag. When the Proxmark3 is placed on top of the Toniebox and you start the emulation feature with the prior read 40 Bytes of data, the Proxmark3 starts emulating the given information and the Toniebox starts playing the connected audio accordingly.

Emulating Tonies with Flipper zero

For the Flipper Zero our Team Member g3gg0 came up with an addition to enable it to read iso15693 tags although the used internals are not capable of doing so. He bitbanged the needed protocol into the tool and added the feature of dumping tonie figurines / tags. An emulation feature was added as well, where the prior dumped information could be used to play these back and the Flipper zero could be placed on top of the Toniebox which will start working the same way as the original tag would do.

You will find more information on g3gg0s blog.

Important things to know

Some hints on common issues and failiures that can be done:

Offline Mode

If you have custom content on your microSD card, or you have linked original content to custom tags, you should avoid going online with your box. Otherwise two things will happen to your custom stuff. For all custom stuff the resume feature will get lost and if you place your custom tag on the box while it is online, it will delete this content as well.

To avoid this you could either switch to the Offline Mode (holding both ears until a sound is played, press one of both ears again until another sound is played), or you could take some actions like blocking the Toniebox within your router. Linking the Box to a Wifi that is only active when needed, works as well.

I for myself use a second microSD card to download new content with original Tonie figurines and copy the new files to another microSD card that I only use in Offline Mode. This way I can have fun of both worlds.

BUT BE AWARE: The Box will leave the Offline Mode as soon as it gets disconnected from the battery, or the battery runs flat.

Resume feature / Live mode / hidden file attribute

If your box goes Online while having your custom stuff on it, the Toniebox will add the “hidden” file attribute to the files that are altered / not known to the Tonie Cloud. Although you did not place the custom tag on the Toniebox (this would let the box delete this specific content) before you went back Offline, it enables the “LIVE Mode” (just ment for creative tonies). This means that the audio will ALWAYS play from the very beginning and the resume feature will not work.

You will get this feature back by removing the “hidden file attribute” from all custom content files. The better way is to keep the box from going online. Or take care that the microSD card with the custom content is not going online and you always use a different microSD card to go online and download new content (see Offline Mode section for more information).

Privacy Mode – What is it and how do I get rid of it?

The NFC chips used within the Tonie figurine are keeping their information as a secret. They are locked into a so called “privacy mode” that can only be disabled by using the password set by boxine.

The custom tags you can buy from RFIDfriend are send to you with a disabled privacy mode. That means you can read the UID with you smartphone and tools like “NFC Manager” or “NXP Tag Info”. But as soon as these were placed on the Toniebox, these will be locked as well.

To disable the privacy mode you could either use a Proxmark3 or use the “knock method”.
The knock methode is called so, because you “knock” (or tab) the tag or the figurine very quickly onto the reader surface of the Toniebox and remove it immediately. This way the box will disable the privacy mode and tries to read the content of the chip. The quick remove of the tag from the reader prevents the box to enable the privacy mode again.

If it does not work for you, you might be toooo slow. Here is a short video.

Toniebox hardware differences – V1, V2, V3

The first Toniebox was released at the second half of 2016. Since then two major PCB layout changes were released.

The V1 and V2 share basically the same architecture around the TI CC3200 microcontroller. The V2 was released during the Chip supply shortage and the US release of the Toniebox. Thats why we believe they just made some adjustments to fit different electronic components because other might not be available at that point of time, or Boxine had to do some corrections for the US release.

Because the TI CC3200 was deprecated a while ago they had to come up with the V3 wich implements the TI CC3235. The V3 Toniebox was released at the beginning of 2022.

Besides of the PCB Layout and microcontroller changes the overall look and user experience did not change in comparison of the three versions.

The downside (as of now) is, that our custom Bootloader and CFW does not work yet with the V3. But we are working hard on this issue.

Final thoughts

This is just a short introduction into hacking of the Toniebox. We gained a lot more knowledge about how the Toniebox works and what are the detailed processes behind the scenes…

If you think I should add more information about certain stuff, please drop me a line at or leave a comment.

24 Gedanken zu „Toniebox Hacking – How to get started“

  1. Just wanted to say thanks for all your hard work on this. You posted this post just at the right time because I saw the photos for the SD card extension and immediately ordered one. As per your instructions I removed the resistor and fixed the SD card slot into position between the screw holes… it works like a charm!

    The only problem now is that I ordered the wrong standard of RFID tag… SLIX, not SLIX-L (UID ending in 01 not 03)… So I’ve ordered new ones from Germany.

    Thanks again!

  2. Super genialer Blog.

    Durch das Lesen der verschiedenen Beschreibungen ist mir folgende Frage gekommen:
    Wenn ich einen NFC-Tag habe, der einen NXP ICODE SLIX-L Chip besitzt, kann ich diesen mit Hilfe von TeddyBench mit einer eigenen Sprachaufnahme kompatibel für die Toniebox bespielen? Damit die Toniebox den selbst bespielten NFC-Tag lesen kann, ist es notwendig in der microSDKarte der Box diese Aufnahme mit dem UID des NFC-Tags zu speichern, was mit Hilfe von TeddyBench möglich ist?

    LG Jasmin

    • Hallo Jasmin,
      Das ist korrekt. Wobei in den NFC Tags (auch nicht in den Tonie Figuren) kein Inhalt, sondern nur eine Art Seriennummer gespeichert ist. Diese ist mit dem jeweiligen Audioinhalt auf der SD Karte verlinkt. Sollte der Inhalt nicht auf der SD Karte kiegen, versucht die Box diesen bei der Cloud abzurufen. Dieses ist natürlich für custom tags nicht möglich, da diese nicht in der Cloud vorhanden sind.
      Deshalb hilft hier TeddyBench um den Inhalt auf die SD Karte zu bekommen und die jeweilige verlinkung zu den NFC tags zu verwalten.


  3. Vielen Dank für Eure ganze Arbeit und die ausführlichen Anleitungen!
    Es funktioniert bei mir alles bestens, wie beschrieben…

    Ich habe nur ein Problem mit einer zusätzlichen SD Karte (SanDisk ultra, 64gb)
    Diese wird von der Box nicht erkannt. Ich konnte noch keinen Beitrag oder Kommentar dazu finden. Liegt es am Dateisystem exFat, oder habe ich etwas anderes übersehen?

    Andere SD Karten (<16 gb, Fat32) werden problemlos von der Box verwendet.
    (über einen der verlinkten SD-Kartenverlängerungsadapter, mit entferntem Wiederstand)

    Besten Dank und viele Grüße!

    • Hallo, insbesondere die Toniebox V1 und V2 ist sehr wählerisch wenn es um die SD Karte geht. Sie nimmt bei weitern nicht jede. In unserem WIKI kannst du weitere Informationen zu den SD KArten finden, die bereits mit den verschiedenen Versionen genutzt werden. Diese sollte auch immer mit einem Fat32 Dateisystem formatiert sein. Zum Teil haben wir festgestellt, dass wenn man die SD KArte mit einem Mac oder einem Linux System formatiert, funktioniert diese meistens in den Tonieboxen. Unter Windows gibt es da manchmal probleme.

  4. Hello,

    if the red marked resistor on the extension cable is not removed, will the tonie box be “destroyed” or will it just not work with this cable (but work fine again, once the extension is removed again)?

    • Nothing will happen nor the box will get destroyed. The Box will just not recognize the SD card in the extension. you can either remove the red marked resistor or you remove the extension and insert the SD card directly into the PCB. This makes the Box work again.

  5. Hello Gambrius,
    what have you used for holding the magnet in the coinbox?
    Can you publish a link?
    It looks like cardboard but i really searched for it but can’t find something similar.

    Thanks for your answer!

    • Hi,
      The spacer material is just laser cuttet HOL (furniture back board).
      You could use some card board or soft foam as well which is cut to the right dimensions.

      Some coin holders have some foam inlays included.
      But you could just leave it and place the magnet with some hot glue to the center of one half of the case.

  6. Hallo Gambrinus,

    ich bin mit Begeisterung auf das Projekt gestoßen. Beim Auslesen mit TeddyBench ist mir aufgefallen, dass bei einigen Tonies (BZW. den Audiodateien) mehr Titel erstellt werden, als auf der Tonie Homepage als Titel angegeben werden.

    Zum Beispiel bei “Für Hund und Katz ist auch noch Platz” sind laut 11 Titel, TeddyBench liest 13 Titel aus

    • Hallo,
      TeddyBench extrahiert die Tracks so, wie diese im TAF (Tonie Audio File) vorhanden sind. Es kann hier zu Abweichungen zum Eintrag des Tonies im Tonie Online Shop kommen, da die Inhalte zum Teil aktualisiert werden. D.h. dass auf neueren Tonies ein abgewandelter, bzw. aktualisierter Inhalt verwendet wird und die Beschreibung auf der Tonie Shop Seite nicht angepasst / aktualisiert wird.

  7. Hi,
    besten Dank für die ganze Arbeit!

    Ich habe eine nagelneue Toniebox mit zwei Kreativ-Tonies und genügend passenden RFID-Chips da, aber noch nicht die Zeit gefunden, das Ganze auszuprobieren.
    Die Box war noch nie mit dem Internet verbunden und möchte beim Start jetzt aber eingerichtet werden.
    Kann ich das irgendwie überspringen bzw. muss ich damit rechnen, dass ein FW-Update installiert wird, sobald ich sie mit dem Internet verbinde? Ich hätte gern weiterhin die Option, eine Custom FW zu installieren.
    Die Audio-Dateien habe ich ja auch ohne Internetverbindung auf der SD-Karte platzieren können.


    • Hallo,
      Du könntest diese manuell einrichten, ohne die APP oder den Assistenten zu verwenden. Einfach in den AP Modus wechseln: 1. beide Ohren bedrückt halten bis ein Ton abgespielt wird. Dann loslassen und einen der beiden Ohren drücken, bis ein Ton abgespielt wird und wieder los lassen. Jetzt kannst Du Dich mit dem Rechner oder dem Handy direkt mit dem AP der Toniebox über WLAN verbinden. Im Browser einfach die IP angeben und die konfiguration durchlaufen.

      Wenn Du eine V1 oder V2 Box hast, dann kannst Du mit den von mir genannten Tools die FW Versionen tauschen. Ebenso ist auch immer die vorherige FW Version noch auf der Box gespeichert und kann von Dir wieder hergestellt werden.

      • Hallo Gambrius,
        ich möchte versuchen eine gebrauchte V1 oder V2 Toniebox zu finden.
        Kann man von außen irgendwie erkennen, um welche Hardware-Version es sich handelt? Ich habe gesehen, dass auf dem Typenschild an der Unterseite verschiedene Produktnummern enthalten sind. Kann man hierdurch die Version erkennen?

  8. Hey Gambrius,

    Many thank for your great work. I face the issue, that some retail tonies get a different hash that the one in your JSON on a new toniebox. Is there a command, that I can use an adjusted JSON file, like TeddyBench.exe -j “tonies-2.json”?
    Many thanks.

    • Hallo Chris,
      Please use the report function within teddybench to report each retail tonie, that is not recognized correctly. Please use the comment field to link me the correct URL within the Tonieshop and or add the correct name of the tonie. I will correct this in the database.
      Please make ONE report per retail tonie.

  9. Just getting into this but had some issues with the RFID tags. The link brings me to a ‘not found page. Do you have any other links that might work for USA? I know there are a bunch of different types and didn’t want to waste time and money.

    Love the work!

  10. Hallo,
    Vielen Dank für den Beitrag! Ich mache (Dank deinem alten Beitrag) seit langer Zeit schon meine Figuren selbst. Wenn ich mir originale Figuren aus der Bibliothek leihe, wechsle ich die SD-Karte, gehe online, stelle die Figur drauf und warte, dass sie heruntergeladen ist. Dann gehe ich wieder offline, entferne die SD-Karte, stecke sie in den Rechner und möchte den Inhalt dann auf “meine” SD-Karte kopieren. Allerdings wird die “online”-SD-Karte seit einiger Zeit nicht mehr vom Rechner erkannt, da erscheint einfach kein externes Laufwerk mehr. Bei der ersten Karte dachte ich, die wäre einfach kaputt, aber das ist jetzt schon die nächste Karte … Muss ich warten, bis sich die Box selbst abschaltet, bevor ich die SD-Karte entfernen kann? Oder gab es eine neue Firmware, die den Lesezugriff der Karten sperrt?
    Danke sehr!


Schreibe einen Kommentar