Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added manual for customTag usage #63

Merged
merged 12 commits into from
Mar 28, 2025
10 changes: 8 additions & 2 deletions content/docs/tools/teddyCloud/tecdoc/tonies-custom-json.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ bookCollapseSection: true
# tonies.custom.json
teddyCloud uses the `tonies.custom.json` file from `config` folder to read the metadata of custom tags in the same manner it's done for the official boxine tonies in the `tonies.json` file. The structure is the same, but it's not overwritten as the `tonies.json` file through regularly updates. So you can use the `tonies.custom.json` to save metadata of your own custom tags.

You can generate the required JSON data via teddyCloud GUI (Edit Tag / Create new model) and save it in the `tonies.custom.json` file, or you can generate it manually, as described below.

Initially the `tonies.custom.json` file looks like the following:

```
Expand All @@ -22,7 +24,11 @@ Enriched with metadata for the above shown custom tag the `tonies.custom.json` f
[{"no": "0", "model": "123456", "audio_id": ["369519776"], "hash": ["af9e61a9c1b12138fb060908d595742334b04515"], "title": "Custom Tonie Example Title", "series": "Custom Tonies", "episodes": "This is my custom tonie", "tracks": ["Title 1", "Title 2", "Title 3", "Title 4", "Title 5", "Title 6", "Title 7", "Title 8", "Title 9", "Title 10"], "release": "0", "language": "de-de", "category": "custom", "pic": "https://upload.wikimedia.org/wikipedia/en/6/6b/Hello_Web_Series_%28Wordmark%29_Logo.png"}]
```

This results after restart of teddyCloud in the following changed appearance in the GUI:
**Note:** After you changed the `tonies.custom.json` file you need to reload it via teddyCloud GUI ( Settings / Reload Tonies.json ) or restart the server.

![GUI](/img/gui-tonies-reload-config.png)

This results after reloading of the `tonies.custom.json` file in the following changed appearance in the GUI:


![Tonie Cards](/img/tonies-custom-json_filled1.png)
Expand Down Expand Up @@ -51,7 +57,7 @@ Each element consists of a JSON object with the following keys:
| release | `"0"` | currently unused |
| language | `"de-de"` | language code, will be shown in the gui if it's another language than the dominant one |
| category | `"custom"` | category of the custom tag, currently unused |
| pic | `"https://.../Logo.png"` | url of the picture which shall be shown as custom tag image in the GUI |
| pic | `"https://.../Logo.png"` | url of the picture which shall be shown as custom tag image in the GUI. In case of use of the custom image folder the path should be relative, like "/custom_img/…". |

### How to get the Audio ID and the Hash value of a TAF

Expand Down
61 changes: 61 additions & 0 deletions content/docs/tools/teddyCloud/usage/custom-tags.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: "Custom Tags"
description: "Information on how to set up and use custom tags in teddyCloud."
bookCollapseSection: true
---
# Custom Tags

To use custom tags within teddyCloud, you need to obtain specific tags and follow these steps.

## 1. Buy specific tags

The Toniebox only accepts specific tags that meet the following criteria:

- Type: SLIX-L
- Privacy-Mode
- UID length: 16 characters
- UID starts with: E0 04 03

Note:

- ESP32: NO other NFC tags will be accepted by the Toniebox.
- Cc3200: Other NFC tags will also be accepted after applying patches.

## (OPTIONAL) 2. Read and save the tag ID

Once you place a new tag on the Toniebox, it will automatically activate privacy mode on this tag, making it unrecognizable by other NFC readers. Privacy mode must be deactivated beforehand.

If you want to save the tag ID for later use, please use a common NFC tag reader (e.g., via an iOS or Android app).

## 3. Place the new NFC tag on the Toniebox

If the teddyCloud setup and Toniebox flashing are already complete, you can proceed with this step.

- Place the new custom NFC tag on your Toniebox for the first time. (The Toniebox will respond with an error code, but that's fine for now since no custom play has been assigned yet.)
- Check the teddyCloud GUI: You should now see a new custom tag:

![GUI](/img/tonies-custom-json_empty.png)

## 4. Assign content

Now you can assign content to the new custom tag:

- Click on the "Edit" button.
- Choose a source from your library.
- Click on "Save".
- Press and hold one of the Toniebox's ears to perform a Freshnesscheck (2 „s“). After that, your new custom tag should work.

## 5. Change the name and picture of the custom tag

If you want to change the name and picture of your custom tag, follow these steps:

- Create a new "Model" as described in [tonies.custom.json config](../tecdoc/tonies-custom-json.md) and save it to your `tonies.custom.json` file.
- Go to the teddyCloud GUI, click on "Settings," and then "Reload Tonies.json". Afterwards, the added entry will be available for selection.

![GUI](/img/gui-tonies-reload-config.png)

- Edit your custom tag again, insert the unique ID you assigned to your new model, and click on "Save."

![GUI](/img/gui-tonies-edit-model.png)

The name, description, and picture should now be updated.
Binary file added static/img/gui-tonies-edit-model.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added static/img/gui-tonies-reload-config.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.