git404hub

what is shengji fr?

maddylaneeee/shengji — explained in plain English

Analysis updated 2026-07-26

7SwiftAudience · generalComplexity · 2/5Setup · moderate

tl;dr

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.

vibe map

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 make with this?

VIBE 1

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

VIBE 2

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

VIBE 3

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

VIBE 4

Translate a transcribed audio file to another language completely offline.

what's the stack?

SwiftSwiftUIwhisper.cppMetal

how it stacks up fr

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 i run it?

Difficulty · moderate time til it works · 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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.