Skip to content
BranchesTags

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
.gitignore
.gitignore
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
contributing.md
contributing.md
 
 

Repository files navigation

Awesome Even Realities G2 Awesome

A curated list of SDKs, tools, apps, and resources for developing on the Even Realities G2 smart glasses.

The Even Realities G2 are everyday display smart glasses with dual micro-LED displays, no camera, and no speaker, paired with the R1 control ring. G2 apps are web apps: your code runs on a server, the iPhone Even App loads it in a WebView, and display and input are relayed over BLE to the glasses. This list collects the best community and official resources for building them.

Scope: This is a resource for building on the G2 — every entry is open source or an official resource you can read, clone, and learn from. Closed-source apps aren't listed in these sections; if you've built one, open an issue and we can look at adding a separate app directory for owners down the line.

Contents

Official

Documentation and Guides

  • even-g2-notes - Community-maintained SDK reference covering architecture, the display and container model, input events, page lifecycle, device APIs, and packaging. The de facto documentation hub for G2 development.
  • even-hub-devguide - Community-maintained, battle-tested guide to building apps on Even Hub for the G2.

SDK, Tooling, and Simulators

  • even-dev - Even Hub simulator and multi-app test environment for building and testing G2 apps locally.
  • even-toolkit - Shared SDK utilities: design system, web components, pixel-art icons, an STT module, and pixel-accurate G2 text measurement.
  • even-realities-ui - Foundation UI package (components, icons, and design tokens) for building G2 apps aligned to Even Realities' design guidelines.
  • even-realities-g2-glasses - Starter template for building G2 plugins with TypeScript and Vite.
  • even-voice-shim - Push-to-talk speech-to-text shim with a Cloudflare Worker template, working around the missing on-device STT API.
  • appsbridge - Off-SDK companion bridge that exposes the phone's magnetometer, step count, and GPS to the WebView over a local WebSocket, enabling compass and navigation apps.
  • droidbridge - Bridges the G2 BLE connection over the network so a desktop can talk to the glasses.
  • faceclaw - Native desktop dashboard for driving the G2 display outside the WebView.
  • even-publisher - Tool for packaging and publishing G2 apps to Even Hub.
  • g2-icon-studio - Browser tool for creating the 24x24 monochrome app icons Even Hub requires, with a 1-bit image converter and pixel editor.
  • MentraOS - Open-source smart-glasses OS and app SDK that drives the G2, among other glasses, over BLE.
  • OpenEvenSdk - Local-first G2 toolkit with Python, Swift, and Kotlin BLE bridges and protocol documentation.
  • Hermes Glass - Vite and TypeScript starter for G2 apps with R1 ring input and a debug panel.
  • evenhub-app-ui - Even Hub design system packaged as a Claude Code skill, with color tokens, typography, layout rules, and 193 SVG icons.
  • Even Terminal Launcher - macOS and Windows tray app for managing Even Terminal connection profiles and supervising agent sessions.
  • even-card-platform - Reusable framework for G2 card-game packs with card primitives, deck and hand rendering, a gesture model, and a shared style guide.
  • even-development - Reference monorepo of G2 apps and utilities, including a HUD with gesture routing, weather, clock, and reminders.
  • xg-glass-sdk - One API for camera, mic, display, and audio across the G2, Rokid, Meta Ray-Ban, Brilliant Labs Frame, RayNeo, and INMO, with a simulator.
  • create-even-app - Scaffolder for G2 apps with six starter templates built on even-toolkit.
  • even-demo - Interactive showcase of the even-toolkit design system with 55+ components, 191 icons, and light and dark themes.
  • evenhub-playground - Development playground for experimenting with Even Hub G2 apps.
  • even-notifications - Draws simulated notification popup overlays so you can design around them without a live phone notification.
  • g2mirror - Rust utility for mirroring a terminal session to the G2 display.
  • even (CLI) - Swift command-line tool for sending text to the G2 over Bluetooth.
  • even-ui-builder - Simple UI builder and code generator for the Even Hub SDK.
  • even_g2_picoruby - Runnable example of writing a G2 app in Ruby via PicoRuby compiled to WebAssembly.
  • eveng2-demo - Feature demo app exercising the display, input, audio, IMU, and storage APIs.
  • takemotions-gps-bridge - Android helper supplying phone GPS to Even Hub apps, working around the in-app browser's lack of location access.
  • takemotions-media-bridge - Android helper exposing now-playing media and R1 ring playback controls to glasses apps over localhost.
  • Glance-Companion - Android media control companion for the G2.
  • even-img-benchmark - Benchmark harness for the G2 image pipeline, useful for tuning against the SDK 0.0.12 compressed image path.

Protocol and Reverse Engineering

  • even-g2-protocol - Community effort to reverse-engineer the G2 BLE protocol, with characteristic mapping and Python examples.
  • g2-kit-unofficial - Unofficial reverse-engineering kit including R1 ring authentication and 27 decoded protobuf definitions.
  • even-g2-patched - Patched Even app build that bypasses voice-intent interception so every G2 voice command routes to a custom AI agent.
  • g2flash - Custom firmware for the G2 that adds compressed image transfer, full-screen 576x288 single-image support, per-lens stereo output, and beeper tones, paired with matching custom send-side software.
  • evenRealities-openCFW - Reverse-engineering documentation of the G2 firmware and BLE protocol, paired with a custom-firmware effort.
  • ffs-os - Clean-room Swift BLE driver and glasses OS for the G2, independent of the official stack.
  • men-g2-ble-gateway - Python gateway exposing the G2 over HTTP, WebSocket, and MCP, with a local browser UI.
  • g2_helloworld - Minimal sideload app and WebSocket demo for the G2, useful as a bare-metal starting point.
  • men-g2-atoms3-hello - Arduino sketch for the M5AtomS3 that connects to the G2 over BLE, authenticates, and boots an Even Hub page.
  • Even-G2-RE - Reverse-engineering effort covering the Even G2 app and its BLE system.

Apps - Productivity and Utilities

  • weather-even-g2 - Five-screen weather forecast driven by the free Open-Meteo API, with no backend server required.
  • epub-reader-g2 - Read EPUB ebooks on the G2 display.
  • rdt-even-g2 - Reddit client for the G2.
  • even-stars - Star and sky viewer for the G2.
  • Glance - Glasses web reader that renders clean article text from any URL across a three-layer source, article, and reader view.
  • wordpeek-g2 - Reading companion that shows the meaning or translation of a spoken or typed word.
  • PRLens - Reads your open GitHub pull requests on the G2.
  • Pulse - Multi-card personal dashboard with calendar, tasks, weather, and GitHub activity.
  • even-messages - Unified inbox client bringing messages from multiple services to the glasses.
  • powerslides - Control presentation slides and read speaker notes from the G2.
  • even_score - Live score tracker for the G2.
  • tmux-on-g2 - Streams a tmux pane to the glasses with double-tap voice input.
  • g2sidian - View and voice-capture Obsidian notes on the G2 through a self-hosted Tailscale backend.
  • even-aozora-reader - Reader for Japanese public-domain literature from Aozora Bunko on the G2.
  • ER Markdown Notes - Markdown notes browsed on the G2 HUD and edited on the phone, stored in IndexedDB.
  • Visionote - Displays photos and illustrations on the G2 with real-time greyscale conversion and brightness and contrast controls.
  • Nutshell - Reads PDFs, articles, and links on the G2 with AI-generated summaries and question answering.
  • Simple HUD - Minimalist heads-up display showing clock, weather, and microphone level on the G2.
  • My Pomodoro - Pomodoro timer for the G2 with adjustable work and break cycles and session persistence.
  • even-matrix - Matrix messaging on the G2 with voice input and message-history browsing.
  • G2Terminal - Terminal emulator for the Even Realities G2.
  • even-menu - App launcher that manages and displays Even Hub apps by priority, configured from the phone.
  • NBA Pulse - Live NBA game tracker for the G2 with a play-by-play timeline and multi-game navigation.
  • even-prayer - Prayer journal and daily-needs reflection app for the G2.
  • Daily App - Multi-screen G2 app with a dashboard, RSS reader, and shopping list, with persisted state and navigation.
  • even-docs - Local document editor for the G2 with multiple documents, version-history snapshots, and bridge-backed storage.
  • even-g2-apps - Collection of custom Even Hub SDK apps for the G2, including a Telegram HUD, calendar events, and dashboard notifications.
  • x-for-even-g2 - Browse your X (Twitter) home timeline on the G2 with ring or touchpad navigation.
  • matrix-g2 - Matrix client that reads chats on the HUD and dictates replies by voice through a Python bridge.
  • even-scribe - Japanese note-taking app for the G2 with a kana-kanji IME.
  • even-g2-obsidian - Browse and edit an Obsidian vault on the G2 with live editor mirroring and IME composition support.
  • even-kitchen - Cooking assistant with recipes, step-by-step guidance, and timers on the lens.
  • Bring-Lens - Displays Bring! shopping lists on the glasses.
  • EvenAware - Real-time notification hub aggregating alerts from multiple sources onto the G2.
  • NOSnieuws_G2 - Unofficial NOS (Dutch public broadcaster) news reader for the G2.
  • Glance G2 - Personal dashboard aggregator with an Expo mobile companion feeding calendar, health, weather, and finance data.
  • BreakMate - Lifecycle-aware health and break reminders fronted by an animated pixel-art character.
  • SolarWorldClock - World clock for the G2 for tracking time across multiple zones.
  • even-simple-calendar - Hands-free month-view calendar navigated entirely with the R1 ring.
  • even-simple-timer - Hands-free countdown and count-up timer for the G2.
  • whisprompt - Offline Android teleprompter that drives scripted text onto the G2.
  • notion-ultimate-brain-even-g2 - Ultimate Brain Notion template surfaced as a G2 interface.
  • flipctl - Mirrors a Flipper Zero on the G2 HUD with R1 ring control and a one-tap launcher.
  • Even-G2-Sentinel-Ops - Fully offline IT security toolkit for the G2 and R1 ring with eight operator tools.
  • even-browser - Web browser for the G2: enter a URL on your phone and read pages hands-free with scroll, link navigation, history, and bookmarks.
  • G2-Gmail - Gmail reader for the G2.
  • G2-md-browser - Markdown file reader with folder browsing, search, and phone-managed favourites.
  • even-todoist - Todoist tasks on the G2, with a phone WebView for settings and a HUD focus display.
  • EvenG2_GoogleKeep - Projects Google Keep notes and checklists onto the G2 via a Flask and gkeepapi backend.
  • 2FA-for-G2 - TOTP authenticator that runs on your face.
  • Even-R-Clock - Unified clock app combining stopwatch, countdown timer, and alarm.
  • level-even-g2 - Spirit level for the G2.
  • reddit-feed-even - Full-featured Reddit client rendering feeds, posts, and comments through a Cloudflare Worker proxy.
  • Birdie - Real-time ambient bird identification that listens and names the species in your view.
  • Smokeless - Cigarette tracker and quit companion logging each smoke with a tap on the frame.
  • even-traeger - Monitor and control a Traeger pellet smoker from the G2.
  • fronius-even-g2 - Real-time Fronius Solar.web PV system data as a hands-free HUD.
  • even-g2-aviation-weather - Live METAR and TAF aviation weather on the G2.
  • Sun-Scout-Pro - Cinematography sun-tracking HUD with solar position, golden-hour timing, and a rotating sun-path map.
  • bible-memory-g2 - Scripture memory app with AI verse suggestions and fill-in-the-blank practice.
  • even-g2-calendar-companion - Next-event calendar notifications on the G2 over an optimized BLE path.
  • SalesEye - Real-time sales coach that detects objections and buying signals on live calls and surfaces cues on the lens.
  • evenG2 - Collection of G2 apps including MoonWalker, a minimalist AR navigation app with dual map services.
  • even-my-news-hub - Personal news hub for the G2, built as a dependency-free HTML, CSS, and JavaScript app.

Apps - Navigation and Transit

  • even-transit - Public transit information on your glasses.
  • wander - Surfaces nearby points of interest on the G2.
  • World-Monitor - 3D globe world-monitor demo for the G2.
  • moto-hud - Motorcycle heads-up display that scrapes turn-by-turn directions and media from the Android notification tray.
  • G2 Drive Nav - Turn-by-turn driving navigation for the G2 using Mapbox directions and live GPS.
  • MetroTracker - Real-time DC Metro arrivals board on the G2 lens with a phone map companion.
  • Perron-NS - Dutch Railways (NS) journey planner for the G2 with live departure boards and station search.
  • JapanTrainTransit - Voice-activated Japan train routing for the G2, backed by the Transit API.
  • even-g2-geocache - Geocaching on the G2 showing nearby caches, direction, and distance from the OpenCaching OKAPI.
  • Checkin - Foursquare Swarm check-in app that surfaces nearby venues on the G2.
  • EUC-G2-Hud - Electric-unicycle telemetry HUD showing real-time speed, battery, and ride metrics on the G2.
  • even-adventure-hud - Heads-up display for hiking and biking on the G2 with live GPS speed and distance.
  • G2BusTracker - Real-time Taiwan bus arrivals on the G2 with location-based stop finding.
  • RoadView-G2 - Live WSDOT highway camera feeds on the G2, browsable by highway.
  • HUD-Navigation-Integration-Even-Hub - Live turn-by-turn navigation and OBD-II vehicle metrics on the G2 via a Swift bridge.
  • Wondereye - Landmark exploration app surfacing context about places around you.
  • StoryWalk - GPS-tracked point-of-interest storytelling for tourism and running, with an Expo companion.
  • Hunter - Place discovery with pixel-art icons, an offline cache, and OSRM walking routes.
  • even-simple-compass - Minimal compass HUD for the G2.
  • apexline-g2 - Motorcycle-first navigation app for the G2.
  • EvenGo-Paris - Paris public transport, all modes in one app.
  • HUD-KVV-Depatures-G2 - Next Karlsruhe (KVV) tram departures from your nearest stop, located by GPS.
  • glass-transit-511 - SF Bay Area BART and Muni arrivals via the 511.org feed.
  • subwaylens - Real-time NYC subway arrivals on the G2.

Apps - Smart Home and Car

Apps - Fitness and Health

  • hevy-g2 - Drives Hevy gym workouts from the glasses: pick a routine on your phone and see sets and reps on the display.
  • even-workout - Guided workout tracking on the G2.
  • evenhub-running-tracker - GPS and accelerometer running pace tracker for the G2.
  • EyeFit - Eye-exercise app driven by IMU head tracking, with a scheduling companion app.
  • golf-caddie-glasses - Live round data and shot logging on the G2, paired with an iOS and watchOS tracker.
  • G2 Gym App - Workout tracking app for the G2 via Even Hub.

Apps - Finance and Markets

Apps - Voice and Speech-to-Text

  • stt-even-g2 - Real-time on-glasses speech-to-text via Soniox.
  • soniox-translate - Real-time speech translation with live captions, powered by Soniox.
  • ERGram - Server-free push-to-talk voice messaging to a Telegram group from the G2.
  • G2 Captions - Accessibility-first real-time captioning prototype for the G2 using AssemblyAI and OpenAI Realtime.
  • Convo Exchange - Real-time transcription and keyword detection on the G2 via Deepgram.
  • even-bridge - Transcribes G2 speech and sends it on to Telegram, Slack, or Gmail.
  • speechcoach-g2 - Real-time speech-pacing coach for the G2 with an STT backend, a VU meter, and an animated pixel mascot.
  • Lingua Franca - Live language conversation coach for the G2 that suggests next phrases in a target language during face-to-face dialogue.
  • even-app-one - Interactive Q&A assistant for the G2 with audio capture, live transcription, and preset questions.

Apps - Games and Learning

  • EvenChess - Chess for the G2.
  • EvenSolitaire - Solitaire card game for the G2.
  • snake-even-g2 - Classic Snake game.
  • pong-even-g2 - Pong, player versus AI, controlled by swipes.
  • tetris-even-g2 - Tetris for the G2.
  • arkanoid-even-g2 - Arkanoid brick-breaker for the G2.
  • flappy-g2 - Flappy Bird clone for the G2.
  • gloss - Type or dictate text and view it as a stack of American Sign Language slides.
  • G2 Flashcards - Flashcard app for the G2 with FSRS scheduling.
  • SMRTi - Spaced-repetition flashcards for the G2 with FSRS v6, an ambient mode, and pre-meeting prep.
  • Lenski - Spaced-repetition flashcards for the G2 with Anki import, phone deck management, and AI deck generation.
  • Heads or Tails - Animated coin-flip game for the G2 with a running tally counter.
  • HoppyRoads - Crossy Road-style crossing game for the G2 with deterministic text-first gameplay.
  • Vault Zero - First-person dungeon crawler with textured raycast 3D rendering on the G2.
  • Card Pack - Seven classic card games, including Hearts, Spades, and Cribbage, for the G2.
  • House Games - Four casino games for the G2: Blackjack, Video Poker, Three Card Poker, and Roulette.
  • even-doom - Doom E1M1 raycaster rendered as ASCII art on the G2.
  • EvenFoundryVTT - D&D 5e on the G2 and R1 ring, synced with FoundryVTT via a phosphor-green tactical HUD.
  • darts-even-g2 - Darts checkout counter for the G2.
  • Quiz Flashcards - Multiple-choice quiz flashcards with JSON, CSV, and plain-text deck import.
  • lingua-lens - Ambient English coach that offers full phrases when you stall and stays silent when you don't.
  • even-sliding-puzzle - Sliding puzzle in 3x3 and 4x4 for the G2.
  • even-japanese-map-quiz - Silhouette quiz covering all 47 Japanese prefectures, played entirely with the R1 ring.
  • evenTaipan - Taipan-style trading game for the G2.
  • EVEN-G2-Tamagotchi - Tamagotchi-style virtual pet for the G2.

Apps - Media and Music

  • lyrics-glow - Time-synced karaoke lyrics on the G2 display, backed by LRCLIB.
  • DisplayPlusMusic - Spotify now-playing viewer for the G2.
  • HUD-Music-Integration-Even-Hub - Apple Music now-playing display via a local Mac bridge.
  • Even-G2-Guitar-Tuner - Guitar tuner that shows detected pitch on the glasses.
  • MuSe - Ambient music identification on the G2 showing song, artist, and cover art with searchable history.
  • Sudden Karaoke - Song recognition and time-synced karaoke lyrics on the G2 via the AudD and LRCLIB APIs.
  • spotify-g2 - Spotify playback control plugin driven by the R1 ring.
  • even-now-playing - Now-playing media display and ring control, paired with an Android media bridge.
  • even-g2-matrix - Matrix-style digital rain animation for the G2 display.
  • orpheus-g2 - Synced lyrics and now-playing for both Apple Music and Spotify.
  • even-g2-media-remote - Media remote driven by the G2 and R1 ring, with an Android helper.
  • g2-multi-instrument-tuner - Cross-platform tuner for guitar, bass, and ukulele with alternate tunings.

Apps - Streaming

  • EvenTwitchChat - Twitch chat client for the G2 with configurable display and username filtering.
  • g2-twitch-hud - Twitch chat HUD for outdoor IRL streaming with priority and alert filter modes.

AI and Agent Integrations

  • claude-code-g2 - Run Claude Code hands-free from the G2 via voice and temple taps, billed against a Claude subscription.
  • cc-g2 - Control a Claude Code session from the G2: approve or deny prompts and enter voice commands.
  • g2-caduceus - FastAPI bridge connecting G2 voice input to any OpenAI-compatible chat endpoint (bring your own model).
  • Cue - Real-time conversation coach suggesting responses live, powered by Deepgram speech-to-text and Claude.
  • g2-channels - Two-way terminal for Claude Code sessions: talk to a session and read its replies on the glasses.
  • Even-Voice-AI - Wake-word voice assistant using the browser's speech recognition, GPT-4o-mini, and streaming text-to-speech routed to the phone.
  • evenai-gemini-bridge - Rewrites the built-in Even-AI voice intents to Google Gemini, with request deduplication.
  • even-g2-local-agent - Local-first voice agent using Even Terminal Mode, Android, and Ollama.
  • openclaw-g2-hud - Heads-up display for monitoring OpenClaw agents, with voice capture and tap and scroll navigation.
  • Even Reality Memory System - Ambient AI memory for the G2 that captures thoughts, answers queries, and transcribes meetings with on-lens cues.
  • Cue (ambient memory) - Ambient social-memory app for the G2 that captures voiceprints and speaker context locally with Resemblyzer and Whisper.
  • Unofficial Even G2 Local Assistant - Local-first voice assistant for the G2 with Whisper STT and dual-model routing between local Qwen and a cloud fallback.
  • even-g2-agentic-app - Agentic framework for the G2 with voice input, MCP tools, and interactive widgets on the display.
  • GlassAI - Voice-first assistant for the G2 bridging to a Hermes agent over an OpenAI-compatible API, with a companion phone app.
  • hermes-even-hub-app - G2 WebView client that drives locally running Hermes agents hands-free with voice and streaming responses.
  • even-g2-hermes - Connects the G2 to Hermes agents through AI-proxy, Terminal Mode, and Even Hub plugin integrations.
  • G2 OpenClaw - Bridges the G2 to a local OpenClaw agent via a PC gateway with Whisper STT and streaming responses.
  • even-better - Mirrors live Claude Code and Codex terminal sessions to the G2 over the Even Terminal protocol.
  • eveng2-terminal-textinput - Phone companion that adds typed text input to Claude Code sessions while keeping the G2 HUD in sync.
  • OpenVide - Remote control for Claude Code and Codex sessions with a G2 WebView client over an SSH and HTTPS bridge.
  • EvenHub-LocalLLM - Voice-controlled local LLM interface for the G2, backed by open-webui over Tailscale.
  • cos-glasses-server - Self-hosted heads-up-display server that drives the G2 from a local Claude Code CLI.
  • g2-claude-remote - Controls Claude remote-control sessions from the G2 with a HUD app, companion panel, and uvx-runnable bridge.
  • G2CC - Direct-BLE Claude Code dispatch for the G2 with DJI two-mic noise cancellation and Parakeet ASR.
  • claude-hud - Voice-driven Claude Code terminal HUD for the G2.
  • hermes-evenhub-bridge - Python adapter exposing the G2 as a Hermes agent platform.
  • even-terminal-pi - Runs the pi coding agent on the G2 as an Even Terminal provider.
  • completion-telegram-bridge - OpenAI-compatible completion API bridging the G2 to a personal Telegram agent.
  • evenglass - Real-time relay between the G2, an Android hub, a Phoenix and Elixir server, and a Windows client.
  • even-deimos - Pick your AI provider, chat from your phone, and stream replies to a minimal lens HUD, with keys stored on-device.
  • even-jarvis - OpenClaw-powered assistant with glasses-mic voice input, streamed responses, and image generation.
  • EvenCode - Voice-driven Claude Code conversations on the G2, including scrolling results and answering interactive prompts.
  • HeadLenss - Drive Claude Code on your PC by voice from the G2, plus tmux control from a phone browser.
  • evenai-anthropic-bridge - Replaces the built-in Even AI assistant with Claude via a small local server.

Related and Legacy (G1)

Community

Contributing

Contributions are welcome. Read the contribution guidelines first, then open a pull request.

About

Curated resources for building on the Even Realities G2 smart glasses.

Topics

ar-glassesawesomeawesome-listeven-g2even-hubeven-realitiesevenrealitiesg2-glassessmart-glasses

Resources

Readme
License

Contributing

Contributing
Activity

Stars

65 stars

Watchers

1 watching

Forks

6 forks
Report repository

Releases

Packages

Contributors