Skip to content

TrayAuth for macOS and Linux 0.2.0 (alpha)

Pre-release
Pre-release

Choose a tag to compare

@KlowdfurrRad KlowdfurrRad released this 01 Aug 08:29
· 13 commits to main since this release

Alpha. First macOS build, plus a refreshed Linux build. Both come from one Avalonia app
(TrayAuth.Desktop) sharing its entire tested core with the Windows release - same RFC-verified
code generation, same vault document, same export files. Accounts move between all three
platforms by export then import, and the codes match digit-for-digit.

macOS

Pick your chip - arm64 for Apple Silicon (M1 and later), x64 for Intel:

tar xzf TrayAuth-macOS-0.2.0-alpha-arm64.tar.gz
cd TrayAuth-macOS-0.2.0-alpha-arm64
sh install.sh

~/Applications/TrayAuth.app/Contents/MacOS/trayauth --selftest   # must print SELFTEST OK
open ~/Applications/TrayAuth.app

Look for the keyhole icon in the menu bar. There is no Dock icon - it is a menu bar app
(LSUIElement), the counterpart of the Windows build having no taskbar button.

The vault key goes into the macOS Keychain; the clipboard uses pbcopy; start-on-login
installs a launchd LaunchAgent. Nothing else to install - the .NET runtime is inside the bundle.

Gatekeeper: the app is not signed or notarized (that needs a paid Apple Developer account),
so install.sh clears the download quarantine flag for you - the same thing right-click → Open
does. If you ever see "the developer cannot be verified", either right-click → Open, or run
xattr -dr com.apple.quarantine ~/Applications/TrayAuth.app.

Linux

Unchanged in behaviour; rebuilt from the shared project.

tar xzf TrayAuth-Linux-0.2.0-alpha-linux-x64.tar.gz
cd TrayAuth-Linux-0.2.0-alpha
bash install.sh                     # per-user, no sudo
~/.local/bin/trayauth --selftest
~/.local/bin/trayauth &

What was verified, and what was not

Verified here: 126 tests green (103 portable, 23 Windows-only), the selftest passing through
the shared code path, and 28 structural checks per macOS tarball - bundle layout, Info.plist
parsed and asserted key by key, Mach-O magic and CPU type matching the advertised architecture,
LF endings and shebangs on the scripts, the .icns chunk walk, and the bundled runtime.

Not verified: anything that needs a real Mac. The menu bar icon, Keychain access, clipboard
and LaunchAgent have never executed on macOS hardware. --selftest is the first thing to run and
the fastest way to tell me what broke.

Known alpha limitations

  • No global hotkey yet on either platform.
  • QR import reads image files only (no screen scanning).
  • On Linux the panel opens centered - Wayland does not let apps position their own windows.
  • The macOS menu bar icon is the colour icon, not a monochrome template image, so it will not
    adapt to light/dark menu bars the way native icons do.

Checksums

TrayAuth-macOS-0.2.0-alpha-arm64.tar.gz      DE1CEBC3DFA58D7E6EE81E1A753D11BEDC26F45C8DB69B2E97BEE2F6DB7497AF
TrayAuth-macOS-0.2.0-alpha-x64.tar.gz        7C8783754F2971451FD572AC988995406E1212DC3BB89A5CC064F190CDE5ED7D
TrayAuth-Linux-0.2.0-alpha-linux-x64.tar.gz  7A26E9366E16DD2A964AF514A2C57525EA15A2B662671E5D142C6032835C4D74