discrec 0.1.1

Records Discord's audio. Press record.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

# DiscRec


A small native app that records your Discord calls. Open it, press record, it
finds Discord and captures the call. Press stop, you get one file.

Not a background service. Not a bot. Not a scene collection.

**Status: Windows app (download the exe). macOS: clone and `bash scripts/macos/run.sh`.**

---

## Why this exists


OBS can already do this — Application Audio Capture pointed at Discord. It is
free and excellent.

It is also ~200 MB, needs a scene and source configured before it records
anything, and is a video production suite you are using for one small job.

DiscRec is that one job, as one binary you press a button in. The Windows
release is under 1 MB.

The honest comparison, including when you should just use OBS:
[docs/09-alternatives.md](docs/09-alternatives.md).

## What it does


- Captures **Discord's audio only** — music, games and notifications stay out
- Mixes in **your microphone**, so the recording is the whole conversation
- Captures **screenshare and Go Live audio**, because it records what you hear
- Writes one Ogg/Opus file per session (`Downloads/DiscRec/` by default)
- Survives a crash with a playable file

## What it deliberately does not do


Auto-start, per-person tracks, video, transcription, cloud anything, mobile.
Each was considered and cut; the reasoning is in
[docs/04-requirements.md](docs/04-requirements.md) and `docs/adr/`.

## Download (Windows)


1. Get `discrec.exe` from the latest
   [Release](https://github.com/Sayandeep1013/DiscRec/releases).
2. Start Discord, join a call, open DiscRec, press Record.
3. Stop when you are done. The file lands in `Downloads\DiscRec\` unless you
   pick another folder in the app.

First launch reminds you that everyone in the call is being recorded. Discord's
Terms require you to tell them; the app cannot say it for you.
→ [docs/06-legal-and-consent.md](docs/06-legal-and-consent.md)

Windows 10 (build 20348+) or Windows 11. No installer, no extra runtime.

## Install with Cargo


If you already have Rust, CMake and a C compiler (the Opus encoder is built
from C source):

```sh
cargo install discrec
```

Most people should use the exe above instead.

## Building


```bash
cargo build --release      # builds for whatever OS you are on
cargo run --release        # the app (Windows)
cargo test
```

Pass any argument and you get the development harness instead of the window
(`discrec --help`). That path is how soaks and crash tests run.

Windows contributors on this machine's GNU toolchain: start at
[docs/HANDOFF.md](docs/HANDOFF.md).

**Mac:** the app is in the tree. On macOS 14.2+:

```bash
bash scripts/macos/run.sh
```

Human playbook: [docs/CONTRIBUTING-macos.md](docs/CONTRIBUTING-macos.md).
If your Cursor/Claude session is on the Mac, point it at
[docs/AGENT-macos-e2e.md](docs/AGENT-macos-e2e.md) and tell it to execute
that file in order.

## How it's built


Rust. One repo. Capture is the only platform-specific part.

```
src/discord.rs     find Discord's root process
src/capture/       WASAPI process loopback (Windows) · Core Audio process tap (macOS)
src/session.rs     preview meters; mix + write on Record
src/mixer.rs       Discord is the timeline; the mic is resampled to match
src/writer.rs      Opus in Ogg, pages committed as they are made
src/ui.rs          Win32 window + tray
src/macos_ui.rs    AppKit window (same product; compiled as `ui` on macOS)
```

Picking this up cold? [docs/HANDOFF.md](docs/HANDOFF.md) is the operational
entry, then [docs/PROJECT-LOG.md](docs/PROJECT-LOG.md) for why the decisions
are what they are.

| Doc | For |
|---|---|
| [docs/README.md](docs/README.md) | The full document tree |
| [docs/03-architecture.md](docs/03-architecture.md) | How it works |
| [docs/07-roadmap.md](docs/07-roadmap.md) | What to build, in order |
| [docs/CONTRIBUTING-macos.md](docs/CONTRIBUTING-macos.md) | Setting up the Mac side |
| [docs/AGENT-macos-e2e.md](docs/AGENT-macos-e2e.md) | Mac agent: build, sign, prove a recording |

## Status


| | |
|---|---|
| Windows app | Works. Download from Releases. |
| macOS | Code is in the repo. Build with `bash scripts/macos/run.sh` on macOS 14.2+. |
| 4-hour drift soak (R6) | Outstanding measurement, not a missing feature |
| Release CPU vs 3% (R11) | Same |

## Licence


MIT