Search documentation
Find setup, feature, and troubleshooting guides.
Documentation
Audio & transcription
SystemSculpt’s recorder and transcription services run entirely inside the plugin—no external scripts required.
Recording controls
Run Toggle audio recorder from the command palette or assign your own hotkey in Obsidian. The toolbar appears inside Obsidian so you never leave the note you are working on.
- •The recorder remembers your preferred microphone, watches for device changes, and recovers if a track drops.
- •The recording modal gives you transport controls, a waveform preview, and live status messages.
- •Existing recordings upload through the SystemSculpt service so you can transcribe files you already captured.
Settings tie-ins
The Workflow tab controls recording, SystemSculpt transcription, and output behavior. Changes apply the next time you open the recorder.
Transcription flow
When you submit audio, the plugin cleans the file, uploads it, monitors progress, and finalises the transcript.
- •Audio is normalised automatically (with optional resampling) before it uploads.
- •Progress updates stream back to the modal so you can see when a job starts, queues, and finishes.
- •Optional post-processing prompts run after the transcript completes when the toggle is enabled in settings.
Command paletteTranscribe with SystemSculpt uses the same pipeline as the recorder, just without capturing new audio.
DiagnosticsErrors appear as Obsidian notices. Capture the notice and job state if a transcript fails repeatedly.
SystemSculpt transcription path
Managed upload
The plugin uploads audio through the SystemSculpt job flow and shows progress while the file is prepared.
Managed transcription
SystemSculpt runs transcription. You only choose recording and output preferences.
Vault output
Save the transcript as a note or attach it to Chat when the managed job completes.
Checklist
- •Select your preferred microphone in Settings → SystemSculpt → Workflow.
- •Run Toggle audio recorder from the command palette or assign your own hotkey in Obsidian.
- •Open existing audio via the file context menu → “Transcribe with SystemSculpt”.
- •Decide whether to keep originals and whether transcripts should paste into chat automatically.