whatisgithub

What is easy-write?

onekapisch/easy-write — explained in plain English

Analysis updated 2026-05-18

27SwiftAudience · generalComplexity · 2/5LicenseSetup · moderate

In one sentence

A free, open-source Mac menu-bar app that translates and rewrites selected text in place, using Apple's on-device AI with no cloud or account needed.

Mindmap

mindmap
  root((repo))
    What it does
      In-place text translation
      Formal or informal tone
      Read mode popup
    Tech stack
      Swift menu bar app
      Apple Intelligence on-device model
      Accessibility permission
    Use cases
      Translate emails and messages
      Read untranslatable web text
      Personal style and glossary
    Audience
      Mac users
      Multilingual writers

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

Translate and replace selected text in place inside any Mac app using a keyboard shortcut.

USE CASE 2

Switch between formal and informal tone when translating into languages like German, French, or Spanish.

USE CASE 3

Translate foreign text you cannot edit, such as a webpage or chat message, into English via a popup.

USE CASE 4

Teach the app your preferred wording so translations sound consistent with your own writing style.

What is it built with?

SwiftApple IntelligencemacOSFoundation Models

How does it compare?

onekapisch/easy-writepunk2898/punktyperonaldo-avalos/maya
Stars272727
LanguageSwiftSwiftSwift
Setup difficultymoderateeasymoderate
Complexity2/52/52/5
Audiencegeneralgeneralgeneral

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Apple Silicon, macOS 26 with Apple Intelligence enabled, building from source with the included scripts, and granting Accessibility permission.

MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

So what is it?

Easy Write is a small Mac menu bar app that translates and rewrites text anywhere on your computer. You select some text in any app, press a keyboard shortcut, and that selection is replaced in place with the translation, entirely on your device. It uses the AI model already built into recent versions of macOS, called Apple Intelligence, so there is no account to create, no API key to paste in, and no cloud service involved. Nothing you type or select ever leaves your Mac. The project explains its reasoning like this: cloud translators such as DeepL or Google Translate require sign-ups, have usage limits, and send your private text off your machine. Tools built around local AI models solve the privacy problem but usually make you install something like Ollama and download a separate model first. Easy Write avoids both problems by relying on the translation model Apple already ships with the operating system. Beyond plain translation, it can switch between formal and informal tone, such as choosing the formal or informal way to say the word for you in German, French, or Spanish, which a basic dictionary translator cannot do. It also has a read mode that pops up an English translation of foreign text you cannot edit, such as a webpage or a chat message. It supports 13 languages, lets you teach it your preferred wording through a personal style guide, and lets every keyboard shortcut be rebound. The whole app is described as roughly 600 lines of Swift code with no network code at all. To use it, you need a Mac with Apple Silicon running macOS 26 or later, with Apple Intelligence turned on in System Settings. Since it is not distributed through the Mac App Store, due to how it simulates keystrokes to swap text in other apps, you build it yourself from source using two included scripts, then grant it Accessibility permission so it can read your selected text and paste the translated result back. The project is open source under the MIT license.

Copy-paste prompts

Prompt 1
Walk me through building and installing Easy Write from source on my Mac using its setup scripts.
Prompt 2
Explain why Easy Write needs Accessibility permission and what that permission lets it do.
Prompt 3
Help me set up a personal style guide in Easy Write so translations match my usual wording.
Prompt 4
Explain how Easy Write's system-wide text replacement works without any network code, based on HOW_IT_WORKS.md.

Frequently asked questions

What is easy-write?

A free, open-source Mac menu-bar app that translates and rewrites selected text in place, using Apple's on-device AI with no cloud or account needed.

What language is easy-write written in?

Mainly Swift. The stack also includes Swift, Apple Intelligence, macOS.

What license does easy-write use?

MIT license: free to use, modify, and distribute, including commercially, as long as the copyright notice is kept.

How hard is easy-write to set up?

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

Who is easy-write for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.