How to transfer files to/from the SD/LittleFS memory?

Use the WebUI

Default passwords?

For AP mode wifi network the password is brucenet.

For the WebUI, username=admin, password=bruce

IR/RF transmitter/receiver not working?

• IR requires a line-of-sight between the transmitter and the receiver, which can be easily blocked by solid objects. Light can bounce off some surfaces and still reach the receiver, but don't rely on that too much. Other IR light sources like the sun can also cause interferences. RF signals propagate in all directions and does not require a line of sight, but can still be blocked by solid objects, especially if made of metal.
• try putting the transmitter and receiver closer (<10cm), many cheap modules have poor ranges, or may be too noisy.
• if using unofficially supported modules, double-check that the used pins are correct. These can be changed in the Settings.
• check if the module is active and working during transmission:
  • for IR, you can use a smartphone camera to check if the IR LED is blinking.
  • use a multimeter or an oscilloscope to check activity on the data pin/LED/antenna.
  • use another device to check and compare the signals. e.g. rtl_433 for RF, Tasmota or a Broadlink RM4 Pro for both IR and RF.
• most RF modules only supports the 433MHz frequency with ASK/OOK modulation. Check if your .sub file or source signal is compatible.
• check the serial log for errors, some signals may fail to decode.

Feature X is missing in my device?

Check the table here.

e.g. BadUSB is only available on ESP32-S3-based devices.

Port to other boards?

For unsupported boards you have to manually add a new configuration environment in the platformio.ini, and define the pins for the modules to be connected, buttons and LCD. Then, compile the firmware for your new env. Depending on the board more code changes may be needed.

For boards that do not have a display and buttons, an headless mode was added. Headless boards can be controlled only via the WebUI and serial commands, and provide a subset of all the Bruce features.

A sample env for the esp32-s3-devkitc-1 board is defined here, it should work with any headless ESP32-S3 boards.

What kind of files i need to put on the SD card?

There is some file examples of what you can do in here, including evil portal templates, nfcs and infrared

How do i customize Bruce?

You can choose a startup gif or image other than Bruce's default by adding your image as 'boot.jpg' or 'boot.gif' on the root of the filesystems, you can also choose a startup sound if you have a file named 'boot.mp3' for it. Also its possible to render images and gifs on the Bruce itself via the LittleFS or SD Card manager