Riffado Docs

Riffado is an open-source companion app for AI voice recorders. Sign up at riffado.com for the hosted instance, or run the same codebase on your own infrastructure with Docker Compose. Bring any OpenAI-compatible API key, keep your recordings, leave whenever you want.

Currently supports the Plaud Note family — Note, Note Pro, and NotePin. More device support is on the way.

For everyone

These guides apply whether you're on hosted or self-host — they're about using Riffado as a product.

• Connect your Plaud account — email-and-code login, plus the Google/Apple workaround.
• AI providers — wire up OpenAI, Groq, OpenRouter, Ollama, LM Studio, or anything else OpenAI-compatible.
• Notifications — Bark, browser, and email backends.
• Automation API and webhooks — personal API keys and signed webhook deliveries.
• Backup and restore — export every recording, transcript, and audio file so you can leave.

For self-hosters

You run the stack yourself with docker compose up. These pages cover install, configuration, and ongoing operation.

• Install — one-line Docker Compose installer.
• Environment variables — every knob Riffado reads at boot.
• S3-compatible storage — AWS, R2, MinIO, B2, and friends.
• Email (SMTP) setup — wire up outbound mail for the email notification backend.
• Upgrading — image tags, the upgrade command, and what to back up first.

Reference

Concepts, contracts, and the public API surface.

• Public API — the stable read surface for external integrations.
• Architecture — how the pieces fit together.
• Security model — authentication, tokens, and trust boundaries.
• Encryption at rest — what's encrypted in the database, what isn't, and how to rotate keys.

How it ships

Riffado is AGPL-3.0 software. The hosted instance at riffado.com is multi-tenant SaaS we operate; self-host deployments run the same image under your control. Both modes are first-class.