Skip to content

v0.3.0 — Desktop for Windows, Linux & macOS

Latest
Latest

Choose a tag to compare

View all tags
@nazmiefearmutcu nazmiefearmutcu released this 11 Jul 10:58
v0.3.0
13e4c2d

Awareness v0.3.0 — Cross-platform desktop

Native desktop shells for Windows, Linux, and macOS. Same product model as the Swift macOS app: auto-start local awareness-api, open the loopback dashboard in an embedded window (no system browser required).

Downloads

Asset Platform Notes
Awareness-0.3.0-arm64.dmg macOS 14+ Apple Silicon Swift + WKWebView shell
Awareness-0.3.0-win-x64.exe Windows x64 NSIS installer (Electron)
Awareness-0.3.0-win-x64.zip Windows x64 Portable zip (Electron)
Awareness-0.3.0-linux-x86_64.AppImage Linux x64 AppImage
Awareness-0.3.0-linux-amd64.deb Debian/Ubuntu .deb package
Awareness-0.3.0-linux-x64.tar.gz Linux x64 Portable archive
SHA256SUMS-linux.txt / SHA256SUMS-windows.txt — Checksums

Install

macOS: Open the DMG → drag Awareness.app to Applications → first launch: right-click → Open (ad-hoc signed).

Windows: Run Awareness-0.3.0-win-x64.exe, or extract the zip.

Linux:

chmod +x Awareness-0.3.0-linux-x86_64.AppImage
./Awareness-0.3.0-linux-x86_64.AppImage
# or:
sudo dpkg -i Awareness-0.3.0-linux-amd64.deb

Python engine (required on all platforms)

The desktop app is a thin shell over the local API — same contract as macOS:

git clone https://github.com/nazmiefearmutcu/awareness.git
cd awareness
uv sync   # or: python3 -m venv .venv && pip install -e .

# optional discovery path the app looks for:
#   macOS/Linux:  ln -s "$PWD" ~/awareness_dev
#   Windows:      mklink /J %USERPROFILE%\awareness_dev %CD%

Env overrides: AWARENESS_API_BIN, AWARENESS_REPO, AW_API_HOST, AW_API_PORT (default 127.0.0.1:8085).

What's new

  • Electron desktop for Windows & Linux (desktop/) with API lifecycle parity (attach / spawn / health / restart / stop)
  • GitHub Actions Desktop Release workflow (native runners)
  • macOS Swift app version 0.3.0 (DMG included)

Build from source

# macOS
./macos/Awareness/Scripts/make-dmg.sh

# Windows / Linux (on target OS or CI)
cd desktop && npm ci && npm test && npm run dist:win   # or dist:linux

Docs: desktop/README.md

Tag: v0.3.0 on feat/desktop-win-linux
CI: https://github.com/nazmiefearmutcu/awareness/actions/runs/29150194266

Assets 12
Loading