Spectacles Templates

A comprehensive collection of templates and examples for building Lens experiences on Spectacles.

What you'll find here

This repository contains multiple template projects showcasing different features and capabilities available when building for Spectacles. Each template is a complete, working example that you can use as a starting point for your own projects.

Prerequisites

Git LFS Required

This repository requires Git LFS (Large File Storage) to be installed and configured. The templates contain large assets including 3D models, textures, images, and media files that are tracked using Git LFS.

Installing Git LFS

macOS (using Homebrew):

brew install git-lfs

Windows: Download and install from git-lfs.github.com

Linux:

# Debian/Ubuntu
sudo apt-get install git-lfs

# Fedora/Red Hat
sudo dnf install git-lfs

Setting Up Git LFS

After installing Git LFS, you need to set it up:

git lfs install

Cloning This Repository

When cloning this repository, Git LFS will automatically download the large files:

git clone <repository-url>
cd Spectacles-Templates

If you've already cloned the repository without Git LFS installed, you can fetch the LFS files:

git lfs install
git lfs pull

Verifying Git LFS

To verify that Git LFS is working correctly:

git lfs ls-files

This will show you all files tracked by Git LFS.

AI

AI-powered experiences and integrations

AI Playground Sample project for AI in using Spectacles Remote Service Gateway.	Agentic Playground Advanced AI playground demonstrating agentic behaviors and autonomous interactions using Spectacles platform.	Crop Sample project showing how to "crop" the environment using hand gesture.
Depth Cache Cache depth frames for pixel-to-3D projection with cloud-based vision models.	AI Music Gen Generate AI music using Google's Lyria model. Combine genres, vibes, and instruments to create custom music tracks with 3D visualizations.

Getting Started

Essential projects to get you started with Spectacles development

Fetch Sample project using the Spectacles Fetch API.	Essentials Collection of foundational concepts for creating lenses in Lens Studio.	Material Library Experimental project collecting Materials tested on Spectacles.
Public Speaker Teleprompter lens for public speaking practice and presentation delivery.	Spatial Image Gallery Convert your 2D images to 3D.	Throw Lab Sample project demonstrating realistic throwing mechanics in AR.
Spatial Persistence Template project using Spectacles Spatial Anchor API.	Voice Playback Sample project for recording and playing back audio on Spectacles.	Path Pioneer Sample project for path creation and path walking experience.
Snap Cloud Database, real-time sync, cloud storage, and serverless functions using Snap Cloud (powered by Supabase).	Spectacles Mobile Kit SDK for seamless communication between mobile applications and Lenses running on Spectacles via BLE.

SnapML

Machine learning projects using SnapML

SnapML Starter Demonstrates how to leverage SnapML on Spectacles for object detection using custom machine learning models.

SnapML Chess Hints AI-powered chess move suggestions using computer vision and SnapML to detect pieces and provide intelligent assistance.

SnapML Pool Uses SnapML to detect a pool table with all 16 balls and pocket holes.

Navigation

Location-based and navigation experiences

Custom Locations Map real life areas and create AR experiences around those locations.

Outdoor Navigation Outdoor navigation system using Map Component and Places API.

Navigation Kit An example project for indoors or outdoors navigation.

Connected Lenses

Multi-user collaborative experiences

Shared Sync Controls Real-time collaborative AR experience for shared controls.	Tic Tac Toe Sample Connected Lens project using Spectacles Sync Kit.	Laser Pointer Create laser pointers on a virtual object that are visible to all connected users.
High Five Real-time collaborative AR experience for high-five interactions.	Air Hockey Sample Connected Lens project using Spectacles Sync Kit.	Think Out Loud Social AR networking application with floating status panels and real-time connections.
Spectacles Sync Kit Minimal example of Spectacles Sync Kit transform synchronization across Connected Lenses.

BLE (Bluetooth Low Energy)

Bluetooth Low Energy connectivity projects

BLE Arduino Arduino board with an IMU sending euler angles from Arduino to Spectacles via BLE.

BLE Playground General BLE playground for experimenting with Bluetooth Low Energy features on Spectacles.

BLE Game Controller Interactive 3D character experience using Bluetooth game controllers with movement, animations, and haptic feedback.

Additional Resources

• Spectacles Developer Documentation - Complete guides and API references
• Design Guidelines - Best practices for Spectacles design
• Lens Studio - Download the latest version of Lens Studio
• Community Forum - Connect with other developers and get support

Getting Started

1. Install Git LFS (see Prerequisites section above)
2. Clone this repository with Git LFS enabled
3. Open any project folder in Lens Studio
4. Explore the templates and start building!

⚠️ Important: Make sure Git LFS is installed before cloning, otherwise large assets won't download correctly.

Contributing

We welcome contributions on existing project! Feel free to submit pull requests or open issues.

---

Built with 👻 by the Spectacles team