- C# 72.9%
- C 23%
- PowerShell 2.2%
- Inno Setup 1.8%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
- Settings -> Window -> "Show on": primary monitor, monitor with the mouse pointer, same monitor as the app, or a specific display, plus the corner. Placement uses the screen's work area in physical pixels via SetWindowPos (no activation), done twice so a DPI change on the target screen is accounted for. Unplugged displays fall back to the primary. Tested on 3 monitors incl. negative coordinates; focus stays on the foreground app. - Pop-up checkbox row no longer overflows the Settings tab (Test button was clipped on narrow windows). Co-Authored-By: Claude Opus 5.5 <[email protected]> |
||
| docs | ||
| installer | ||
| pc-app/CallRecDesk | ||
| release-notes | ||
| src | ||
| streamdeck-plugin | ||
| website-project | ||
| .gitignore | ||
| build.ps1 | ||
| CMakeLists.txt | ||
| partitions.csv | ||
| platformio.ini | ||
| README.md | ||
| release.ps1 | ||
| sdkconfig.defaults | ||
| sdkconfig.desktop.defaults | ||
ESP32 Call Recorder
Take phone calls on your PC, and record them, through an ESP32 Bluetooth bridge. Download CallRec Desk
| Incoming call | In a call, recording | Contacts |
|---|---|---|
![]() |
![]() |
![]() |
| Messages | Conversation | Recent calls |
![]() |
![]() |
![]() |
| Settings (dark) | Settings (light) | 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
- Flash the desktop firmware (close any serial monitor first):
pio run -e desktop -t upload - 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. - On the phone, pair with CallRec. For calls, iPhone lists it like a headset.
- 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>.wavinDocuments\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/.
Updates, releases and links
- 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
fg.ttdk.eu/api/v1/repos/tomtom/esp32-call-recorder/releases/latestfor a newer version. If there is one, the notice bar offers Update. The installer is downloaded, checked against the release'sSHA256SUMS.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>inCallRecDesk.csproj, writerelease-notes/v<version>.md, commit, then run.\release.ps1(-DryRunto only build). It tags, pushes, creates the Forgejo release and uploads the installer, the plugin andSHA256SUMS.txt, using the fg.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/Rto 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),FLTandDEMP → GND. *Many PCM5102A boards take 3.3–5 V on VIN; check yours. - MAX98357A: leave
GAINunconnected (9 dB) or tie to GND for 12 dB. The firmware drivesSDdirectly. - Jack detect: if your jack's switch opens on insert instead, set
JACK_INSERTED_LEVELto1insrc/config.h. With no detect wired, setPIN_JACK_DETECTto-1and 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)









