Monolingual
===========

#### A tool for removing unneeded language localization files for macOS

## Screenshot

<img src="Resources/README.rtfd/Monolingual-2.0.2-en.png" width="752" alt="The Monolingual main window">

## What's new in 2.0.2

A small release for 2.0: a new icon, one more language, and a search field for the two lists.

- **A new app icon.**
- **Simplified Chinese is new, and all 17 translations are complete.**
- **The language and architecture lists can be narrowed by typing.** A search field in the title
  bar filters the list of the tab you are on, which gives the language list back the behavior it
  had in 1.8.2: open the app, type "Eng", and it narrows to the English variants as you type. The
  field holds the keyboard focus as the window opens, and a list that matches nothing says so.
  What is checked stays checked, and a removal still covers the whole list, whether or not it is
  on screen.

## What's new in 2.0.1

A patch release for 2.0.

- **Monolingual can remove files again.** 2.0 asked macOS for something it does not allow, so the
  privileged helper that does the removing was never installed and the app could not free a single
  byte. macOS 27 refuses to register an unsandboxed launch daemon from a sandboxed app —
  `SMAppService target executable must be sandboxed because the app is sandboxed` — and Monolingual
  was on both sides of that rule at once: the app had been sandboxed since 2015, and the helper has
  to run unconfined because it deletes files anywhere on disk. `SMJobBless`, which 2.0 replaced with
  `SMAppService`, had no such requirement, which is why the two coexisted for a decade without
  anyone noticing. The app is no longer sandboxed.
- **Existing settings start over.** Preferences lived in the sandbox container, which an unsandboxed
  app cannot read, so the folders to thin fall back to `/Applications` and `/Library`. If you had
  added a folder of your own, add it again under Preferences.
- **Thinning a very large universal binary no longer crashes.** The architecture offsets of a fat
  file are added in 64 bits, and a file whose slices would not fit a 32-bit header is refused
  instead of trapping.
- **The disk image installs without a network.** The app inside it had no notarization ticket
  stapled to it — only the zip did — so Gatekeeper had to ask Apple about the app before it would
  run, which fails on a Mac that is offline or behind a restrictive network. The app is now stapled
  before the disk image is built.

## What's new in 2.0

2.0 is the first release since 1.8.2 and requires macOS 27 on an Apple silicon Mac.

- **A new interface.** Monolingual is rewritten in Swift 6 with a SwiftUI interface. The English
  language files can no longer be selected for removal — deleting them breaks a macOS installation
  beyond repair.
- **Removals you can watch, and stop.** A removal reports what it is doing in a sheet, showing the
  file it is working on and the space freed so far, and can be cancelled. A notification tells you
  when it is done, with the space it saved.
- **A different helper.** The privileged helper is registered with Service Management
  (`SMAppService`) instead of the deprecated `SMJobBless`; approve it once under System Settings ›
  General › Login Items & Extensions. It verifies that the processes talking to it are Monolingual,
  and it no longer follows symbolic links.
- **Updates you can trust.** Monolingual uses Sparkle 2 with EdDSA-signed updates, and the app is
  notarized.
- **Better translations.** Turkish is new since 1.8.2, and all 16 translations are complete, kept in
  a String Catalog so that no string can go stale.
- **Fixed.** A blocklist download that failed used to leave the blocklist empty, which crashed the
  next removal.

## Architecture

Monolingual consists of two parts: the Monolingual app and a privileged helper program that
is registered as a launch daemon with Service Management (`SMAppService`). Both are written in Swift and
communicate with each other using XPC.

An administrator has to allow the helper in System Settings › General › Login Items & Extensions
before it can run.

## Dependencies

Monolingual uses Swift Package Manager to manage its dependencies. Currently, the following packages
are used:

- [Sparkle](https://github.com/sparkle-project/Sparkle) — app updates
- [swift-argument-parser](https://github.com/apple/swift-argument-parser) — argument parsing for the
  bundled `lipo` tool

## Building

- Build (Debug): `make development`
- Build (Release): `make deployment`
- Release packaging (signing, notarization, disk image): `make release`
- Run the tests: `swift test` (or `xcodebuild -scheme Helper -destination 'platform=macOS' test`)

The project uses [SwiftLint](https://github.com/realm/SwiftLint) and
[SwiftFormat](https://github.com/nicklockwood/SwiftFormat); their configurations are checked in as
`.swiftlint.yml` and `.swiftformat`.

## Contributors

### Main developer
Ingmar J. Stein

### Original idea
J. Schrier

### Localization

- Croatian localization by Alen Bajo ([@abajo](https://github.com/abajo))
- Dutch localization by Tobias T. ([@Eitot](https://github.com/Eitot))
- Farsi localization by [@paymon23](https://github.com/paymon23)
- French localization by François Besoli
- German localization by Alex Thurley
- Greek localization by Ευριπίδης Αργυρόπουλος
- Italian localization by Claudio Procida
- Japanese localization by Takehiko Hatatani
- Korean localization by Woosuk Park ([@readingsnail](https://github.com/readingsnail))
- Polish localization by Mariusz Ostrowski ([@mariuszostrowski](https://github.com/mariuszostrowski))
- Romanian localization by Eugen Mihalache ([@eugeniums](https://github.com/eugeniums))
- Russian localization by [@DotTheI](https://github.com/DotTheI) and Kirill Sokolov ([@mbs0ft](https://github.com/mbs0ft))
- Simplified Chinese localization by 李子木 ([@drlcl](https://github.com/drlcl))
- Slovak localization by Richard Gráčik ([@TheMorc](https://github.com/TheMorc))
- Spanish localization by Fran Ramírez, updated by Darío Hereñú ([@kant](https://github.com/kant))
- Swedish localization by Joel Arvidsson ([@oblador](https://github.com/oblador))
- Turkish localization by Hasan Beder ([@hasanbeder](https://github.com/hasanbeder))

### Artwork
Original icon by Matt Davey
New icon in 2.0.2 by [@fingers-piano](https://github.com/fingers-piano)

## License

GNU GENERAL PUBLIC LICENSE, Version 3, 29 June 2007

## Developers

Monolingual is written in Swift 6 and requires macOS 27 on Apple silicon, with Xcode 27.0 or above to
build it.

## Status

![GitHub Build Status](https://github.com/IngmarStein/Monolingual/workflows/ci.yml/badge.svg)