Open the dictation formats that stayed locked for thirty years — Olympus DS2/DSS and now Grundig DSS — on any Linux box. No Windows, no GUI, no commercial software. A production recipe and the reverse-engineering trail behind it. 🔓
A handful of strangers who never met picked a thirty-year-old lock — a proprietary voice codec that doctors, lawyers and police dictated billions of seconds into, and that no open tool on Earth could read. One person reverse-engineered the first piece. Others made it portable, then universal. We put it in production over a weekend — and then a lawyer in Germany dug an old recorder out of a drawer and handed us a codec even the commercial software couldn't decode. So we cracked that one too, in an afternoon, by interrogating the manufacturer's own decoder inside a debugger we built from its DLLs.
All of it is in here: the working code, and exactly how it was done.
| 📖 Read it like a thriller | The Story → — no code, ~10 minutes. A locked format, a relay of strangers, a bug that turned out to be a human being, and a German lawyer's drawer. It really happened, and every twist links to the chapter that proves it. |
| 🔧 Follow the technical trail | Go deeper ↓ — from "what even is a .ds2 file" up to running a closed-source decoder under a debugger. Built to be readable if you've never reverse-engineered anything. |
| 🌐 Decode one right now | Open the in-browser decoder → — drop a .ds2/.dss (Olympus, Grundig, even encrypted) and get audio back. Nothing uploaded, nothing installed. |
| 🛠 Run it yourself | 30 seconds ↓ — drop a file in, get an MP3 out. |
git clone https://github.com/Guillain-RDCDE/DS2-Anywhere
cd DS2-Anywhere
docker compose up --build
# Web UI: http://localhost:8080/convertisseur.php
# HTTP API: http://localhost:8765/healthDrop a .ds2 or .dss into examples/ and convert it from the web UI. Or one file from the CLI:
conv-dss-ds2-to-mp3 recording.ds2
# [ds2_qp 16000Hz, 31.8min] recording.mp3 OK (14.55 Mo en 10.3 s)Production install (config + cron + systemd + web UI): sudo ./src/bin/install.sh, or docs/02-integration.md.
BEFORE AFTER
.ds2 ─► SSHFS ─► Windows VM ─► Switch.exe .ds2 ─► cron (Linux)
│ │
▼ ▼
.wav (mono) .mp3 (mono 64k)
│ │
▼ ▼
SSHFS back Whisper API
│ │
▼ ▼
glue script ready for transcription
GUI app + Windows VM + SSHFS round-trip bash + native binary, all local, ~10s/file
A Windows VM with commercial software in the loop, replaced by a bash wrapper, a cron, and a native binary — all local, ~10 s per file.
New to any of this? A .dss/.ds2 file is a voice recording squeezed tiny by
a secret algorithm (a "codec"). "Decoding" it means rebuilding the original sound
from those bytes — and to do that you need the algorithm, which the manufacturers
never published. The whole trail below is the story of getting it anyway. You don't
need a background in audio or reverse-engineering to follow it; each chapter starts
from the ground.
Climb at your own pace:
- The ten-year lock — what a DS2 file is, why it resisted, and how Kieran Hirpara reverse-engineered the codec from the Olympus DLLs (the genius part — not ours).
- Putting it in production — turning a decoder into a real pipeline: CLI, cron, daemon, the encode chain. The engineering part.
- The empty-block bug — a decoder that was bit-exact on every file we tested and still wrong on paused recordings. Ten dead ends, a twelve-line fix. A detective story worth reading even if you never touch DS2.
- Cracking the re-sync block — the sequel: we ran the closed-source Olympus decoder inside a debugger we built from its own DLLs, and read the format's last undocumented rule straight off the silicon.
- The bug that wasn't — the twist, and the chapter we're proudest of. A rigorous case for a "last bug" (the research paper), then overturned — there was no bug; it was a person stepping away from the mic. How careful work can be confidently wrong, and how to catch it.
- Cracking the Grundig SP codec — the finale. The Grundig grandfather format that nobody decoded — not us, not FFmpeg, not even Olympus's own software. We extracted Grundig's decoder, ran it under a debugger, patched out the instruction it used to delete its own evidence, and rebuilt the codec bit-exact. Now a native Python decoder, an FFmpeg patch, and a PR to the upstream codec.
Short on time? 5 min → this page · 20 min → chapter 1 · 30 min → the two detective stories (3 & 4) · the twist → 5 · the finale → 6 · everything → docs/ in order, "impossible for thirty years" to "production in a weekend."
The decision to ship rested on an A/B against the reference Windows implementation on the same source file, not a count of successful decodes:
- A/B vs Switch.exe (same
.ds2, both chains, both MP3s through the same Whisper API): transcripts functionally identical — 16.2 % vs 17.2 % low-confidence words, inside Whisper's own run-to-run variance. The chains are interchangeable downstream. - 35 / 35 real production dictations decoded (6 h 48 of audio), zero failures.
- ~3 200 cron passes since go-live, zero errors. The Windows VM stays on standby, untouched.
For the Grundig codec: byte-for-byte identical to Grundig's own decoder on every sample. Full methodology →
- 📖 docs/ — the full didactic trail above, plus the benchmarks.
- 🛠 src/ — the integration code: CLI, cron, HTTP daemon, admin web UI. Sanitized; the patterns are reusable as-is.
- 🎙 grundig/ — the native Grundig DSS-SP decoder (pure Python, bit-exact) + its tables.
- 🎬 ffmpeg-upstream/ — the FFmpeg patches (DS2 container generalization + the Grundig SP decoder), staged for upstream.
- 📐 the formal spec — the world's first public specification of the Grundig DSS-SP codec (bit-exact), plus a PRONOM submission so digital-preservation tools can identify these files at all.
The intellectual heavy-lifting belongs to the people who opened the locks:
- Kieran Hirpara — hirparak/dss-codec — the reverse-engineering that started all of it. MIT, February 2026.
- Gaspard Petit — dss-codec-wasm + dss-codec fork (the Rust crate our Dockerfile uses). MIT.
- Patrick Domack — the FFmpeg C port of the spec. MIT / public domain.
- JulsRX — the Grundig Digta owner who reported the file nobody could decode, and supplied the public sample that made cracking the Grundig codec possible.
- lamejs (LGPL) and FFmpeg (LGPL) — the MP3 encoders.
This repo is a recipe; the recipe needs the ingredients above to exist at all. Full breakdown: CREDITS.md.
MIT, same as the upstream codec. Fork, adapt, deploy — please keep attribution to the codec authors. We publish the clean reimplementations and the recovered specs, never the vendors' proprietary code.
Thirty years of locked, one bash command later. The chain has to keep going. 🔓