No description
  • C# 75.3%
  • C 20.5%
  • PowerShell 1.8%
  • Inno Setup 1.5%
  • HTML 0.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
TomTom 7fcdb80b05 CallRec Desk 1.7.1 (bridge firmware v7)
Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-18 01:15:15 +01:00
docs Text messages over Bluetooth MAP (1.5.0, firmware v4, plugin 1.2) 2026-10-01 14:54:04 +02:00
installer Add built-in updater, About tab, tabbed layout and release script 2026-10-01 00:52:52 +02:00
pc-app/CallRecDesk CallRec Desk 1.7.1 (bridge firmware v7) 2026-11-18 01:15:15 +01:00
release-notes CallRec Desk 1.7.1 (bridge firmware v7) 2026-11-18 01:15:15 +01:00
src Firmware v7: keep the phone pairing when Bluedroid deletes it 2026-11-18 00:02:10 +01:00
streamdeck-plugin Choose which Stream Decks switch to the call/contacts profiles (plugin 1.4.2) 2026-10-08 20:18:37 +02:00
website-project Move to git.ttdk.eu/tomtom/CallRec 2026-11-01 07:53:11 +01:00
.gitignore Stream Deck call profile: XL and + switch to a call profile during calls (1.7.0, plugin 1.3.1) 2026-10-07 12:33:24 +02:00
build.ps1 Add built-in updater, About tab, tabbed layout and release script 2026-10-01 00:52:52 +02:00
CMakeLists.txt ESP32 Bluetooth call recorder: firmware, desktop app, Stream Deck plugin, installer 2026-10-01 00:33:54 +02:00
partitions.csv ESP32 Bluetooth call recorder: firmware, desktop app, Stream Deck plugin, installer 2026-10-01 00:33:54 +02:00
platformio.ini ESP32 Bluetooth call recorder: firmware, desktop app, Stream Deck plugin, installer 2026-10-01 00:33:54 +02:00
README.md Move to git.ttdk.eu/tomtom/CallRec 2026-11-01 07:53:11 +01:00
release.ps1 release.ps1: wait for the pushed tag before creating the release 2026-11-01 07:58:24 +01:00
sdkconfig.defaults ESP32 Bluetooth call recorder: firmware, desktop app, Stream Deck plugin, installer 2026-10-01 00:33:54 +02:00
sdkconfig.desktop.defaults Text messages over Bluetooth MAP (1.5.0, firmware v4, plugin 1.2) 2026-10-01 14:54:04 +02:00

ESP32 Call Recorder

Take phone calls on your PC, and record them, through an ESP32 Bluetooth bridge. Download CallRec Desk

CallRec Desk demo: an incoming call is answered, recorded and muted; contacts, recent calls, a text message arrives and gets a reply, settings with a live light/dark theme switch, and About

Incoming call In a call, recording Contacts
Incoming call In a call, recording Contacts
Messages Conversation Recent calls
Messages A conversation Recent calls
Settings (dark) Settings (light) About
Settings, dark theme Settings, light theme About

The GIF and screenshots come from the app's demo mode (CallRecDesk.exe --demo [light|dark]). It uses made-up contacts, calls, messages and recordings, never connects to a bridge and never reads or writes your real settings, contacts or recordings.

Two builds from the same firmware:

  • Desktop (env:desktop): the NodeMCU sits on your PC's USB port. The phone connects to it over Bluetooth, and the CallRec Desk app plays the call on your PC headset, sends your PC mic back, and records to a folder on the PC. No extra hardware is needed.
  • Pocket (env:pocket): standalone battery device with its own mic, speaker, earpiece jack and microSD recording. See below.

Desktop version

Phone ──Bluetooth HFP──► NodeMCU ESP-32S ──USB serial 921600──► CallRec Desk ──► PC headset + mic
                                                                  └──► WAV recordings
  1. Flash the desktop firmware (close any serial monitor first): pio run -e desktop -t upload
  2. Run pc-app/dist/CallRecDesk.exe (needs the .NET 8 Desktop Runtime). It finds the bridge automatically, or you can pick the COM port under Settings.
  3. On the phone, pair with CallRec. For calls, iPhone lists it like a headset.
  4. Under Settings, pick your headset and microphone (the default is the Windows communications device).

App features:

  • Answer / hang up / reject, and caller number display

  • Dial a number or redial the last one from the PC

  • Record button, plus an optional "record every call automatically" setting. Files are named yyyy-MM-dd_HH-mm-ss_<number>.wav in Documents\Call Recordings: stereo 16 kHz, left = caller, right = you.

  • Mute mic, level meters, call volume (synced with the phone's volume buttons)

  • Mic volume slider, 0–400% (double-click to reset to 100%). It sets what the caller hears and what gets recorded, and it is remembered between sessions

  • "Audio to phone" / "Audio to PC" moves the call between the PC and the handset

  • The window pops to the front on an incoming call

  • Theme: System (follows Windows) / Light / Dark, including a dark title bar

  • Tray: the notification-area icon changes colour (grey no bridge, blue ready, green ringing, teal in call, red recording). Right-click it for answer / hang up / record / mute / exit. Options: minimize to tray, close to tray, start minimized, start with Windows, pop up on incoming calls. Only one instance runs; launching it again shows the existing window.

  • Firmware check / flash (Settings → Firmware): the app bundles the desktop firmware and flashes it itself, with no PlatformIO or esptool needed. It checks that the chip is an original ESP32, compares the MD5 of what's on the board with each bundled image, and writes only the parts that differ. Running it again on an up-to-date board writes nothing. When a connected bridge reports an older version, or an ESP32-style USB device (CP210x/CH34x/FTDI) doesn't answer as a bridge, a notice offers to flash it.

  • Text messages (firmware v4): a Messages tab with conversations (contact names, unread dots), a chat-style thread and Send, plus New message (a number or a contact name). New texts arrive live through MAP notifications and pop up in the tray; opening a conversation marks it read on the phone too. The bridge connects to the phone's MAP message service and runs a MAP notification server; the app speaks OBEX/MAP over the bridge's RFCOMM pipe. Messages are kept on the PC in %APPDATA%\CallRecDesk\messages.json, because phones only share their newest messages.

    • iPhone: turn on Show Notifications for CallRec (Settings → Bluetooth → ⓘ). iOS shares only the ~10 newest incoming texts and doesn't share messages you sent from the phone itself, so the app's history fills in as texts arrive and as you send from the PC. Sending works for SMS (tested).
    • Android: most phones share all folders after you allow "message access".
  • USB driver check: if a CP210x, CH340/CH341, CH343/CH9102 or FTDI chip is plugged in but Windows has no working driver for it (Device Manager "driver not installed" or another error), the notice bar offers Get driver, which opens the manufacturer's official download page. Install it, then unplug and replug the board.

  • Stream Deck plugin install (Settings → Stream Deck): installs or updates the bundled plugin and shows the installed version.

  • Bluetooth sleep (firmware v2): the app sends a heartbeat every second. If the bridge hears nothing for 5 s (app closed, PC off or asleep) it disconnects the phone and stops accepting connections, so calls stay on the phone. It also boots asleep, so on a plain USB charger it never takes calls. When the app is back it wakes up and reconnects to the phone. Exiting the app puts it to sleep straight away. The LED shows a tiny blip every 5 s while asleep.

Build everything (firmware → plugin → app with both bundled → installer): .\build.ps1

Building from source

The repository holds sources only. Ready-made downloads (installer, Stream Deck plugin) are on the Releases page. To build everything yourself you need PlatformIO, the .NET 8 SDK and Inno Setup 6, then run .\build.ps1. These are generated and kept out of git: .pio/, bin/, obj/, pc-app/dist/, pc-app/CallRecDesk/Firmware/ (firmware copied into the app), the plugin's bin/, imgs/ and dist/, and installer/output/.

  • About tab: version, Check for updates, and links to the website, a PayPal support link, the source code, issues and releases. Links live in pc-app/CallRecDesk/AppInfo.cs, and any left empty are hidden.
  • Built-in updater: at startup (after 8 s) and then daily, the app asks git.ttdk.eu/api/v1/repos/tomtom/CallRec/releases/latest for a newer version. If there is one, the notice bar offers Update. The installer is downloaded, checked against the release's SHA256SUMS.txt, and run silently; the app closes, updates and starts again. Bundled firmware and Stream Deck plugin updates follow automatically, because the app offers those itself.
  • Publishing a release: bump <Version> in CallRecDesk.csproj, write release-notes/v<version>.md, commit, then run .\release.ps1 (-DryRun to only build). It tags, pushes, creates the Forgejo release and uploads the installer, the plugin and SHA256SUMS.txt, using the git.ttdk.eu login saved in Git's credential manager.

Installer

installer\output\CallRecDesk-Setup-<version>.exe (about 3 MB, built with Inno Setup 6 from installer\CallRecDesk.iss):

  • Installs per-user by default (no admin prompt); "install for all users" is offered.
  • Start menu shortcut, an optional desktop shortcut, and an optional "start with Windows".
  • .NET check: if the .NET 8 Desktop Runtime is missing, setup asks to install it and does so with winget install Microsoft.DotNet.DesktopRuntime.8. If winget fails or isn't available, it offers the Microsoft download page instead. The same runtime also covers the Stream Deck plugin.
  • Upgrading: run the new setup. A running CallRec Desk is closed cleanly (CallRecDesk.exe --exit).
  • Finish page: install the Stream Deck plugin (if Stream Deck is present) and launch the app.
  • The uninstaller also removes the "start with Windows" entry. Settings and recordings are kept.

The setup isn't code-signed, so Windows SmartScreen may show "Windows protected your PC". Click More info → Run anyway.

Stream Deck plugin

streamdeck-plugin/dist/CallRecDesk.streamDeckPlugin: double-click it to install. The CallRec Desk category then appears in the Stream Deck app with:

Action Key shows Press
Answer / Hang up blinking green "Answer" + caller while ringing, red "Hang up" + call time answer / hang up (opens the app when idle)
Record red "REC mm:ss" while recording start / stop recording
Mute mic "Mic on 100%" / red "Muted" toggle mute
Audio PC / Phone where the call audio is move audio
Open CallRec Desk app status show the window (starts the app if needed)
Mic volume (Stream Deck + dial) volume % and bar on the touch strip turn: ±5% per click, press/tap: mute

The keys also work on the Stream Deck Pedal. The plugin talks to the app over its local control API (ws://localhost:47810, localhost only; connections from browser pages are refused). If the app isn't running, pressing any key starts it. Plugin log: %APPDATA%\CallRecDesk\streamdeck-plugin.log.

Rebuild the plugin:

dotnet publish streamdeck-plugin/CallRecStreamDeck -c Release -r win-x64 --self-contained false -p:PublishSingleFile=true -o streamdeck-plugin/com.callrecdesk.streamdeck.sdPlugin/bin
streamdeck-plugin/com.callrecdesk.streamdeck.sdPlugin/bin/CallRecStreamDeck.exe --generate-images streamdeck-plugin/com.callrecdesk.streamdeck.sdPlugin

then zip the .sdPlugin folder and rename the zip to .streamDeckPlugin.

The on-board blue LED (GPIO2) shows the same patterns as the pocket LED. A button from GPIO32 to GND works as an answer/hang-up button.

Link protocol: see src/serial_link.h. In the desktop build the USB port carries only binary frames (the ESP-IDF console is disabled). Firmware log lines appear in the app's log panel, prefixed esp:.

Rebuild the app: dotnet publish pc-app/CallRecDesk -c Release -r win-x64 --self-contained false -p:PublishSingleFile=true -o pc-app/dist


Pocket version

Pocket-sized Bluetooth hands-free device for phone calls, with a record button. The phone sees it as an ordinary Bluetooth headset/car kit (works with iPhone and Android, no app needed). Press REC during a call to save it to microSD as a stereo WAV: left = caller, right = you.

  • Board: NodeMCU ESP-32S (original ESP32 — required for Classic Bluetooth HFP)
  • Audio: speaker (MAX98357A) and 3.5 mm earpiece (PCM5102A); plugging in the earpiece mutes the speaker
  • Wideband (mSBC, 16 kHz) calls when the phone supports it, otherwise narrowband (8 kHz)
  • Toolchain: PlatformIO, ESP-IDF framework

Recording law: in Denmark you may record a conversation you take part in. Other countries differ (some require everyone's consent) — check before recording calls with people abroad.

Parts

Qty Part Notes
1 NodeMCU ESP-32S any original-ESP32 devkit works
1 INMP441 I2S MEMS mic module 3.3 V only
1 MAX98357A I2S amp module + 8 Ω 1–2 W speaker, ~28–40 mm
1 PCM5102A I2S DAC module the purple one with a 3.5 mm jack is fine
1 3.5 mm jack with insert-detect switch (PJ-307 / PJ-313) only if your PCM5102A board's jack has no detect pin
1 microSD SPI module (3.3 V type, or one with level shifter) FAT32 card, ≤ 32 GB
2 6 mm tactile buttons CALL and REC
1 3 mm LED + 330 Ω status
1 1000 mAh LiPo (e.g. 503450)
1 LiPo charger + 5 V boost module (e.g. IP5306 or "TP4056 + boost" combo) feeds NodeMCU VIN
1 slide switch power

Wiring

NodeMCU ESP-32S            Module
---------------            ------
GPIO26 (BCLK)  ─────┬───── INMP441 SCK
                    ├───── MAX98357A BCLK
                    └───── PCM5102A BCK
GPIO25 (WS)    ─────┬───── INMP441 WS
                    ├───── MAX98357A LRC
                    └───── PCM5102A LCK
GPIO22 (DOUT)  ─────┬───── MAX98357A DIN
                    └───── PCM5102A DIN
GPIO33 (DIN)   ─────────── INMP441 SD
GPIO21         ─────────── MAX98357A SD   (HIGH = on, LOW = mute/shutdown)

GPIO5          ─────────── SD CS
GPIO18         ─────────── SD SCK
GPIO19         ─────────── SD MISO
GPIO23         ─────────── SD MOSI

GPIO32         ── [CALL] ── GND
GPIO27         ── [REC]  ── GND
GPIO13         ── jack detect switch ── GND   (closes when plug inserted)
GPIO4          ── 330Ω ── LED ── GND

3V3            ─────────── INMP441 VDD, PCM5102A VIN*, SD VCC (3.3 V type)
5V / VIN       ─────────── MAX98357A VIN (louder than 3.3 V)
GND            ─────────── all GNDs, INMP441 L/R

Module pin notes:

  • INMP441: L/R to GND (left channel). VDD is 3.3 V only.
  • PCM5102A: solder jumpers/pins SCK → GND (internal PLL), FMT → GND (I2S), XSMT → 3.3 V (unmute), FLT and DEMP → GND. *Many PCM5102A boards take 3.3–5 V on VIN; check yours.
  • MAX98357A: leave GAIN unconnected (9 dB) or tie to GND for 12 dB. The firmware drives SD directly.
  • Jack detect: if your jack's switch opens on insert instead, set JACK_INSERTED_LEVEL to 1 in src/config.h. With no detect wired, set PIN_JACK_DETECT to -1 and use a long press on REC to switch outputs.

Power

LiPo → charger/boost module → 5 V → NodeMCU VIN + MAX98357A VIN. Don't feed the LiPo straight into the NodeMCU: its AMS1117 regulator needs about 4.4 V in. Expect about 6–8 hours of talk time from 1000 mAh.

Controls

Button Press Action
CALL short answer (ringing) / hang up (in call) / reconnect (not connected)
CALL long reject (ringing) / pull audio back from phone (in call)
REC short start / stop recording (only while call audio is on the device)
REC long toggle forced earpiece mode (speaker off)
LED Meaning
slow blink (1/s) not connected, pairable as CallRec
short blip every 3 s connected, idle
fast blink incoming call
solid in call
1 Hz 50% blink recording
3 rapid flashes can't record (no SD card)

Recordings are saved as CALL0001.WAV, CALL0002.WAV, … and CALLS.CSV logs file,caller number,seconds. Recording stops automatically when the call ends or the audio is moved back to the phone. The file header is updated every 5 s, so a recording cut short by power loss is still playable.

About 3.8 MB per minute, so a 16 GB card holds about 70 hours.

Build and flash

pio run -e pocket -t upload -t monitor

Pair from the phone's Bluetooth settings: the device shows up as CallRec. After that it reconnects to the same phone at power-up.

Tuning (src/config.h)

  • MIC_SHIFT: mic loudness (lower = louder).
  • SPK_MAX_GAIN_Q8: speaker loudness at full phone volume.
  • ECHO_DUCK_*: speakerphone echo suppression. Raise the threshold if your voice gets cut off; lower it if the caller hears their own echo.

Status / to verify on hardware

Desktop build:

  • Firmware compiles; app builds; frame parser and PC audio path tested without hardware
  • Bridge detected by the app, iPhone pairs and connects
  • Call audio both ways, no dropouts or drift over a long call
  • Recording lines up (caller vs. you)

Pocket build:

  • Pairing + HFP connect (iPhone, Android)
  • Wideband (mSBC) vs narrowband audio both clean
  • Earpiece jack detect switching
  • Echo level in speakerphone mode
  • Recording during long calls (no dropped frames logged)