A camera-aware macOS notch companion: expression feedback, animal memes, and a small meeting calendar.
Needs macOS 13+, Apple Command Line Tools, and your own Jev API key. Compatibility is still being tested.
xcode-select --install # First time only; finish the installer first.
git clone https://github.com/maxim-kich/WhySourFace.git
cd WhySourFace
zsh scripts/install.shInstalls in /Applications and opens settings. Add your key, allow camera access, and start a video call. Open at login is on by default; you can turn it off in settings. macOS may ask you to approve it in Login Items. Settings open whenever the app starts. Full Xcode and a paid Apple developer account aren't needed.
Click Update in settings after your call. Terminal checks the latest GitHub release, builds it locally, and restarts the app. Developer tools must stay installed. Failed builds keep your existing app. Updates execute code from this repository; only use a copy you trust.
An agent can help: “Build and install WhySourFace from this repository using scripts/install.sh. Let me enter my API key in the app.”
Camera frames go to TypeSafe Jev for analysis. Frames aren't saved locally. Only final meeting results are stored. Your API key stays in a local file restricted to your user (not encrypted). Scores describe visible expression, not actual mood.
Memes download from animal communities through Meme API; images remain third-party content and aren't included in the source release. Internet access is required. Code: MIT.
zsh scripts/build.sh
build/WhySourFace.app/Contents/MacOS/WhySourFace --self-testTo release: bump the version in Info.plist, tag the commit vX.Y.Z, and publish a GitHub Release. The updater follows published stable releases, not every commit. Builds are locally ad-hoc signed, not Apple-notarized.