Your Android phone and your Windows PC, working as one. Local-first, end-to-end encrypted, no account.
Voice recorder (recorder)
Records a voice note on the phone and sends it to a paired PC through the
resumable files stream (docs/protocol/files.md), along with any markers
added during recording.
1. Capability & toggle
| Item | Value | Notes |
|---|---|---|
| Desktop capability | recorder |
Announced in hello.caps / hello.update by PCs that save and convert voice recordings |
| Phone capability | files.transfer |
Base capability on every build |
| Per-device toggle | recordings |
Default true on both devices |
| Feature ID | files.recordings |
Available when phone offers files.transfer, desktop offers recorder, and recordings toggle is on |
2. Wire format
Voice recordings travel on the files stream (nectarlink/1/files,
op: "send", v: 1) as a single-file files.offer with recording: true
and optional markers:
{
"t": "files.offer",
"id": 1,
"b": {
"id": "AbCdEfGhIjKlMnOpQrStUv",
"files": [
{ "name": "Recording 2026-10-07 14.32.m4a", "size": 194560 }
],
"recording": true,
"markers": [
{ "at_ms": 4200 },
{ "at_ms": 18500, "label": "Action item" }
]
}
}
Validation rules
- When
recordingistrue:filesmust contain exactly 1 entry, and itsfoldermust beNone.markersmay contain0..=256(MAX_MARKERS) entries.- Each
RecordingMarkerhasat_ms: u64(elapsed recording milliseconds, excluding paused time) and optionallabel: Option<String>(1 to 256 UTF-8 bytes after trimming, with no control characters).
- When
recordingisfalse(or omitted):markersmust be empty.
Refusal codes
Before accepting a files.offer with recording: true, the receiver checks:
- Capability: If the receiver does not advertise
recorder, it replies witherr(code: "unsupported") and closes the stream. - Toggle: If the
recordingsper-device toggle is off for this sender, it replies witherr(code: "denied") and closes the stream.
Resumability & offline queueing
Because recordings use files.offer and files.accept, an interrupted
recording transfer resumes from files.accept.have when the connection returns,
and a recording stopped while the PC is offline waits in Waiting state and
transfers automatically once the PC reconnects.
3. Desktop storage & conversion
When a recording transfer (recording: true) completes on the PC:
- Folder & naming: Saved in the user's configured Recordings folder
(default
Documents\Nectarlink Recordings) under the name the phone gave it, from when recording started (so one that waited for the PC keeps its time), or else the time it arrived:Recording YYYY-MM-DD HH.MM.<ext>(orRecording YYYY-MM-DD HH.MM (2).<ext>if that name is already taken; existing files are never overwritten). - Format conversion: Converted off the UI thread with Windows Media
Foundation to the user's chosen format (
m4aas recorded without re-encoding,mp3,wav, orflac). If conversion fails, the original.m4ais kept in the Recordings folder. - Markers file: When
markersis non-empty, a companion UTF-8 text file<stem>.markers.txt(for example,Recording 2026-10-07 14.32.markers.txt) is written next to the audio file, one marker per line (MM:SS.mmm <label>orHH:MM:SS.mmm <label>; one without a label readsMarker <n>). - Notification: A Windows toast
"Recording from <phone> saved"is shown with Open and Show in folder actions, and the transfer entry's saved path is updated to the final file in the Recordings folder.