Spectacles-Sample

Spectacles Samples [DEPRECATED]

We'll see ya at https://github.com/orgs/specs-devs if you are looking for further support https://www.reddit.com/r/Spectacles/

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 
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.

Spectacles Mobile Kit

SDK for seamless communication between mobile applications and Lenses running on Spectacles via BLE.

DJ Specs

Interactive DJ turntable experience with realistic vinyl physics and multi-track audio mixing.

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.

Snap Cloud

Cloud-powered experiences using Snap Cloud (powered by Supabase)

Snap Cloud

Database, real-time sync, cloud storage, and serverless functions using Snap Cloud (powered by Supabase).

World Kindness Day

Demonstrating Snap Cloud integration with real-time database updates and a companion web app.

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