v2.1.0

CleanText Studio v2.1.0

CleanText Studio v2.1.0 is the Document Fidelity and Cross-Platform Closure
release. It keeps the mature Windows behavior and adds real macOS and Linux
builds, tests, and desktop packages without changing the v2.1.0 version.

Highlights

• Opens native DOCX through DocxSourceAdapter -> DocumentTree and cleans the
  canonical tree directly.
• Preserves merged table cells, HTML/Word table spans, supported OMML, and
  document order through Preview and DOCX export.
• Adds real Windows, macOS, and Linux GitHub Actions runners for tests,
  GUI initialization, package builds, and packaged-app smoke checks.
• Adds platform-aware paths, resource loading, fonts, shortcuts, system theme
  handling, and Linux Qt runtime setup.
• Keeps the existing cleaning, formula, table, export, i18n, theme, AI BYOK,
  and Windows packaging behavior unchanged.

Platform support

Platform	Architecture	Status	Package
Windows	x86_64	Supported	Setup EXE / Portable ZIP
macOS	Apple Silicon (arm64)	Supported	ZIP with unsigned .app
Linux	x86_64	Supported	Standalone tar.gz

Each platform was tested on its real runner:

• Windows: windows-latest
• macOS: macos-14 Apple Silicon
• Linux: ubuntu-latest x86_64

All three runners execute the same unit, regression, import/export, coverage,
dependency, translation, screenshot, freeze, GUI, package, and packaged-app
smoke gates. The current run reports 465 passed on each platform with
combined coverage gates passing around 89.1% to 89.2% depending on runner
measurement.

Installation

Windows

Install CleanText-Studio-v2.1.0-Windows-x64-Setup.exe over the current
per-user installation, or extract
CleanText-Studio-v2.1.0-Windows-x64-Portable.zip into a new folder.

macOS

Download CleanText-Studio-v2.1.0-macOS-arm64.zip, extract it, and open
CleanText Studio.app.

This is an unsigned build because no Apple Developer signing or notarization
certificate is available. macOS may show a Gatekeeper warning on first launch.
Do not disable system security. Open the app from the extracted bundle after
reviewing the warning, or use Finder's Open action for the downloaded app.

Linux

Download CleanText-Studio-v2.1.0-Linux-x86_64.tar.gz and extract it:

tar -xzf CleanText-Studio-v2.1.0-Linux-x86_64.tar.gz
./CleanText-Studio-v2.1.0-Linux-x86_64/CleanText-Studio.sh

The Linux package is a PyInstaller onedir bundle with a launcher, README,
LICENSE, and third-party license file. It requires standard desktop Qt
runtime libraries such as GL/EGL and XCB; Ubuntu runners install those in CI.

What's changed

• Added macOS support.
• Added Linux support.
• Added cross-platform packaging.
• Added cross-platform CI.
• Improved path handling.
• Improved system integration.
• Improved platform-aware shortcuts.
• Improved resource loading.
• Improved packaging reliability.

Compatibility

• The v1.4.2 ordinary-cleaning freeze remains unchanged.
• FormulaShield, Formula AST, OMML, DocumentTree, Preview, DOCX/TXT export,
  AI BYOK, themes, settings, and the 12-language UI remain supported.
• Windows users can keep the existing workflow; no new version or migration
  step is required.

Known limitations

• The macOS package is unsigned and not notarized.
• macOS Intel x86_64 is not claimed in this release because only an Apple
  Silicon runner was verified.
• The Linux package targets x86_64 desktop Linux and was validated on the
  Ubuntu 24.04 runner image.
• Supported OMML and LaTeX are safe subsets; unsupported formulas remain
  visible as whole-formula fallbacks.
• DOCX import preserves supported structure but not every original Word
  layout, embedded object, page setting, or style.

Assets and checksums

The v2.1.0 Release assets are:

• CleanText-Studio-v2.1.0-Windows-x64-Setup.exe
• CleanText-Studio-v2.1.0-Windows-x64-Portable.zip
• CleanText-Studio-v2.1.0-macOS-arm64.zip
• CleanText-Studio-v2.1.0-Linux-x86_64.tar.gz
• CleanText-Studio-v2.1.0-SBOM.cdx.json
• SHA256SUMS.txt

Verify downloads against SHA256SUMS.txt on the Release page.