This repository contains tools to personalize and expand your Faba+ (and MyFaba) experience.

Using the Faba Me sharing functionality, you can upload a .wav file directly to the MyFaba cloud and associate it with your Faba Me robots (white, blue, or red).

To upload audio, you’ll need an “Invite to Record” URL link. To generate one from the MyFaba mobile app:

1. Select: Faba Me > FABA Me White (or Red/Blue)
2. Tap + Add New Track and select Invite to Record
3. Copy the last 10 characters of the URL generated (e.g., 8K3TzYl2WB for https://studio.myfaba.com/record/8K3TzYl2WB) as share_id

Use the following Python command to upload the file:

python3 myfaba_upload.py [-h] <share_id> <author> <title> <wav_file>

e.g.:

python3 myfaba_upload.py 8K3TzYl2WB "Author Name" "Audio Title" ./audio/test.wav

To convert .mp3 files to .wav format, you can use these commands:

• Using VLC:

vlc.exe --sout "#transcode{acodec=s16l,channels=2,samplerate=44100}:std{access=file,mux=wav,dst=audio\test.wav}" audio\test.mp3

• Using FFmpeg:

ffmpeg -i ./audio/test.mp3 -acodec pcm_s16le -ac 2 -ar 44100 ./audio/test.wav

You can manually add .mp3 files to an existing playlist (character) or create a new one using a customized character (new NFC tag). This requires:

1. Physical access to the microSD card by opening the Faba+ and adding content manually
2. Optional: A custom NFC tag for a new character with a unique ID

1. Place all your .mp3 files in a folder, numbering the filenames in order
2. Select a character ID to associate with the new playlist (e.g., 3101)
3. Run the mp32faba.sh script as follows:

./mp32faba.sh ./mp3 3101

4. Copy the newly created folder (e.g., K3101) to the PLAYER folder on the microSD card, then insert the card back into the Faba+
5. Generate a new NFC tag using the selected character ID (e.g., 3101) to play the newly added playlist

1. Create a local backup of the microSD content.
2. Identify or read the character ID of an existing NFC tag (e.g., 0190 for the FABA Me White robot).
3. Browse to the corresponding folder on the microSD card (e.g., PLAYER\K0190) and check the last file name (e.g., 02.faba). The next file should be numbered 03.faba.
4. Place the new .mp3 files you want to add in a folder and number the filenames accordingly. Run the mp32faba.sh script:

./mp32faba.sh ./mp3 0190 3

5. Add the contents of the newly created folder (e.g., K0190/03.faba) to the original folder on the microSD and replace the info file with the new one. Reinsert the microSD card into the Faba+ and test the playlist with the existing character.

The mp32faba.sh script uses eyeD3 to edit mp3 ID3 tags. To install it, run:

pip install eyeD3

Custom characters can be created using compatible NFC tags. The following tags have been tested and are supported: NTAG203, NTAG213, NTAG215, and NTAG216.

The script faba_ntag.py can be use to read, dump, edit, erase, and create NTAG2xx compatible with Faba+.

usage: faba_ntag.py [-h] [-r | -w ID | -d | -e] [-c UID TYPE ID] [-p PORT] [-v]

options:
  -h, --help                             Show this help message and exit
  -r, --read                             Read NTAG and decode Faba folder ID
  -w ID, --write ID                      Write NTAG with Faba folder ID (4-digit ID)
  -d, --dump                             Dump NTAG content and save to Flipper Zero (.nfc) and NXP TagWriter (.ndef)
  -e, --erase                            Erase NTAG restoring default values
  -c UID TYPE ID, --create UID TYPE ID   Create manually Flipper Zero (.nfc) file. Requires UID (7-byte hex), TYPE (NTAG203/213/215/216), ID (4-digit)
  -p PORT, --port PORT                   NFC reader serial port (e.g. COM1 or /dev/ttyUSB0)
  -v                                     Enable debug logging

Managing custom audio content on the Faba+ requires access to the microSD card, but disassembling the device each time is not ideal. The firmware does not include a setting to enable USB mass storage, and while the Faba Me cloud functionality works, it is limited - especially when using custom NFC tags. One option would be to relocate the microSD card slot by creating a hole in the case and using an extension cable. However, this is not recommended, as the microSD card could be easily removed, lost, or even swallowed.

So, I came up with my own over-engineered solution: a custom PCB that controls access to the microSD card and makes its contents manageable remotely via Wi-Fi. The custom PCB fits on top of the Faba+ board, requires no additional power supply, and can be manually switched on only when needed by placing a magnet on the case - eliminating the need for an external switch.

I currently have a working prototype and finalizing the design and code.

Faba remote access board - Prototype v2

Terminal output:

[*] Taking control of microSD...
  [!] microSD is already in use
  [!] Please turn off Faba first

[*] Taking control of microSD...
  [+] microSD access granted
  [+] WebDAV server started: \\faba@6126\PLAYER

[*] Release microSD control...
  [+] WebDAV server stopped
  [+] microSD released

Remote access to files via File Explorer: