explaingit

maddylaneeee/shengji

Analysis updated 2026-07-26

7SwiftAudience · generalComplexity · 2/5Setup · moderate

TLDR

A free macOS app that turns audio and video into text and subtitles entirely on your own machine. It keeps your data private by working offline without requiring an account.

Mindmap

mindmap
  root((repo))
    What it does
      Transcribes audio files
      Live microphone captions
      Offline translation
    Engines
      Apple Speech
      whisper.cpp
      SenseVoice
      NVIDIA Parakeet
    Use cases
      Create subtitles
      Transcribe lectures
      Edit and search text
    Tech stack
      Swift
      SwiftUI
      macOS app
    Audience
      Mac users
      Privacy focused

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Transcribe a recorded lecture or meeting into searchable text without uploading it anywhere.

USE CASE 2

Generate SRT or WebVTT subtitle files for a video using local speech recognition.

USE CASE 3

Dictate notes through your microphone and have the app type them out in real time.

USE CASE 4

Translate a transcribed audio file to another language completely offline.

What is it built with?

SwiftSwiftUIwhisper.cppMetal

How does it compare?

maddylaneeee/shengjiakshaymaloo/filamentcrafcat7/peakmon
Stars777
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyeasy
Complexity2/52/53/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires macOS 15.5 on an Apple silicon Mac, and the first launch needs a manual security override because the app is not notarized by Apple.

The explanation does not mention a specific software license, so the exact permissions are unknown.

In plain English

ShengJi, also called LocalScribe, is a free and open source macOS application that turns audio into text and subtitles on your own machine. It works with microphone input, audio and video files, and audio playing directly from your Mac. The app does not require an account or an internet connection to do its core work, so your audio stays private. It requires macOS 15.5 or later and an Apple silicon Mac. What sets ShengJi apart is its choice of speech recognition engines. Instead of locking you into one system, the app offers Apple Speech, whisper.cpp with Metal acceleration, SenseVoice, and NVIDIA Parakeet. Apple Speech handles microphones, files, and live captions, while the others currently focus on file transcription. The app also includes optional offline translation through Apple Translation and NLLB, so you can convert speech to text and then translate it without sending anything to a remote server. The app is built as a long-task tool. It supports progressive results as audio is processed, pause and resume for recordings, and session recovery journals so you do not lose work on long sessions. Transcripts are fully editable with search, find and replace, trimming, and deletion. You can import and export in several formats, including TXT, Markdown, JSON, PDF, SRT, and WebVTT, which covers most subtitle and document needs. The interface is written in SwiftUI and switches automatically between English and Simplified Chinese based on your Mac language preference. The localization system is designed so that adding another language does not require changes to the feature code. A command-line interface is also available for running models, transcription, export, and translation from the terminal. The project is actively developed but has some limitations. Apple SpeechAnalyzer and floating live captions require macOS 26, while older versions fall back to the other engines. The release build is ad-hoc signed rather than notarized by Apple, so first launch requires a manual override in System Settings. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I have a video file on my Mac that I need subtitles for. How do I use ShengJi to generate an SRT file completely offline?
Prompt 2
Help me choose the best speech recognition engine in ShengJi for transcribing a long audio file on my Apple silicon Mac.
Prompt 3
How can I use ShengJi's command-line interface to transcribe an audio file and export it as Markdown?
Prompt 4
I want to transcribe a live meeting using my microphone and then translate the text to another language offline. What are the steps in ShengJi?

Frequently asked questions

What is shengji?

A free macOS app that turns audio and video into text and subtitles entirely on your own machine. It keeps your data private by working offline without requiring an account.

What language is shengji written in?

Mainly Swift. The stack also includes Swift, SwiftUI, whisper.cpp.

What license does shengji use?

The explanation does not mention a specific software license, so the exact permissions are unknown.

How hard is shengji to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is shengji for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.