Previewv0.2.0

BottleLite

A lightweight native macOS runner for Windows apps.

BottleLite is a SwiftUI Wine front-end for running Windows apps on macOS without Electron, accounts, telemetry, or a bundled runtime. It detects your existing Wine install, keeps bottles persistent, imports .exe files safely, and gives each program logs, settings, and stop controls.

Open source

Latest release: v0.2.0
Platform: macOS / Wine
Download: 2 release assets
Updated: Oct 30, 2026
GitHub: ★ 1 star
Stack: Swift · SwiftUI · Wine

~ $ gh repo view jx-grxf/BottleLite
BottleLite  A lightweight native macOS runner for Windows apps.

status   Preview
version  v0.2.0
stack    Swift · SwiftUI · Wine
platform macOS / Wine
repo     github.com/jx-grxf/BottleLite

~ $ git clone https://github.com/jx-grxf/BottleLite.git && cd BottleLite
~ $

Project data, read from GitHub at build time

Problem

Wine workflows on macOS tend to sprawl across Terminal commands, prefixes, logs, and runtime assumptions.

What I built

A SwiftUI app that manages bottles, validates PE executables, runs GUI and console programs through existing Wine, captures logs, and wires Sparkle update feeds for preview releases.

Highlights

Manages persistent Wine bottles with import, rename, delete, and per-program settings.
Validates .exe files by extension and MZ header before adding them to a bottle.
Runs GUI apps quietly and console tools visibly in Terminal.app, with logs for each launch.
Preview distribution includes a DMG, Sparkle appcast, and SHA256 checksums.

Developer setup

clone

$ git clone https://github.com/jx-grxf/BottleLite.git && cd BottleLite