explaingit

punk2898/punktype

Analysis updated 2026-05-18

27SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A macOS menu bar app that turns your speech into cleaned-up typed text using AI, or runs voice commands on selected text.

Mindmap

mindmap
  root((PunkType))
    What it does
      Voice to text dictation
      AI text cleanup
      Voice commands on text
    Tech stack
      Swift
      SwiftUI
      macOS speech recognition
      DeepSeek API
    Use cases
      Dictate emails and reports
      Summarize selected text
      Translate selected text
    Audience
      Mac users
      Writers
      Developers

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

Dictate text into any Mac app and have AI clean it up into polished writing.

USE CASE 2

Turn spoken notes into a formatted email, report, or list of action items.

USE CASE 3

Select text in any app and speak a command like summarize or translate.

USE CASE 4

Build a personal dictionary of technical terms and names for more accurate recognition.

What is it built with?

SwiftSwiftUIAVFoundation

How does it compare?

punk2898/punktyperonaldo-avalos/mayaaymandakir-gh/gh-notch
Stars272728
LanguageSwiftSwiftSwift
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencegeneralgeneralvibe coder

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires macOS 14 or later and your own API key from DeepSeek or another compatible provider.

Released under the MIT license, so anyone can use, modify, and share the code freely, including for commercial purposes.

In plain English

PunkType is a macOS menu bar app that lets you speak instead of type. You press a keyboard shortcut, say what you want to write, press the shortcut again to stop, and the text is automatically cleaned up by AI and pasted wherever your cursor is. It runs in the background as a small icon in the menu bar and requires macOS 14 or later. The app works in two modes. In standard dictation mode, your voice is converted to text by your Mac's built-in speech recognition, then sent to DeepSeek (an AI service you connect with your own API key) to turn spoken language into polished written text. There are three output styles: a fast mode that types the raw transcription with no AI processing, a polished mode that removes filler words and cleans up informal speech, and a formatted mode that restructures your words into something like an email, a report, a summary, or a list of action items. In command mode, you first select some text in any app, then press the shortcut and speak an instruction, such as "summarize this" or "translate to English." The result appears in a popup where you can copy it or replace the selected text directly. This works across any application on your Mac. The app also builds a personal dictionary from your usage, extracting technical terms, names, and product names to help the recognition avoid errors on words specific to your work. You can also enable OpenAI's cloud transcription service as a fallback if the local recognition is inaccurate. All data goes directly from your machine to the AI provider using your own API key, with no intermediate server involved. The README is written in Chinese with a linked English version. The project is released under the MIT license and the code is auditable and compilable from source.

Copy-paste prompts

Prompt 1
Help me set up PunkType with my own DeepSeek API key on macOS.
Prompt 2
Explain the difference between fast, polished, and formatted output modes in PunkType.
Prompt 3
Show me how command mode works to summarize or translate selected text in any app.
Prompt 4
Walk me through compiling PunkType from source using the make commands.

Frequently asked questions

What is punktype?

A macOS menu bar app that turns your speech into cleaned-up typed text using AI, or runs voice commands on selected text.

What language is punktype written in?

Mainly Swift. The stack also includes Swift, SwiftUI, AVFoundation.

What license does punktype use?

Released under the MIT license, so anyone can use, modify, and share the code freely, including for commercial purposes.

How hard is punktype to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is punktype for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.