Stenny Docs

Reference

Commands

Every command of the stenny tool.

The menu bar app covers everyday use. The stenny command does everything else. Wherever a course is needed, you can use its name or an alias, like da.

Transcribe files

CommandDescription
stenny add FILE --course daTranscribe a recording now, at low priority.
stenny refresh da DATERedo only the AI step of a lecture, for example after adding slides or glossary terms. Use "DATE (2)" for a second lecture that day.
stenny refresh --event "TITLE" DATEThe same for a talk or event.

Options for add

OptionDescription
--nowFull speed instead of low priority.
--laterQueue it. Runs on power, or at night if you set that up.
--slides FILE.pdfStore the slides with the lecture and use them.
--lang enForce a language for this file.
--date 2026-10-13T09:15Set the date if the file's timestamp is wrong.
--no-llmSkip the AI step and stay fully offline.
--event "TITLE"A talk or event instead of a course.

Record live

CommandDescription
stenny live --course daRecord and transcribe live, without the menu bar app.
stenny live --event "TITLE"Record a talk or event.
stenny pausePause the running recording. The microphone is off.
stenny resumeResume it.
stenny togglePause or resume.
stenny stopStop and make the final transcript.
stenny statusShow the state of the running recording.
stenny devicesList the microphones you can use.
stenny mic "NAME"Switch the running recording to another microphone.
stenny checkCheck the latest recording for gaps and missing audio.

Options for live

OptionDescription
--device "NAME"Record from this microphone.
--backup offDon't record a backup microphone.
--no-draftOnly record. The transcript is made after the lecture.
--file FILE --speed 3Rehearse with a recording instead of the microphone.

Courses and Claude

CommandDescription
stenny coursesList your courses.
stenny match-course "TITLE"Show which course a calendar event belongs to.
stenny project-instructionsPrint the instructions to paste into each course's Claude project.
stenny course-filesRebuild the course files in _Course Files.

Queue and automation

CommandDescription
stenny queue listShow the jobs waiting.
stenny queue runProcess them now.
stenny schedule installProcess the queue every 15 minutes while plugged in.
stenny watch --course daWatch the Lectures folder in iCloud Drive, for example for Voice Memos, and queue new recordings.

Setup

CommandDescription
stenny init --vault "PATH"Create config.toml from the example.
stenny migrateMove files from an older setup into place, once. Add --dry-run to preview.