whatisgithub

What is ocula?

revolutionarybukhari/ocula — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A free browser-only tool that lets you control your cursor with your eyes using a webcam, including a demo AAC communication board.

Mindmap

mindmap
  root((repo))
    What it does
      Webcam eye tracking
      Dwell to click
      AAC board demo
    Tech stack
      Vanilla HTML CSS JS
      MediaPipe Face Mesh
    Use cases
      Hands-free cursor control
      Assistive communication board
      Accessibility research
    Audience
      ALS and RSI users
      Accessibility developers
    Privacy
      Runs fully client-side
      No camera data uploaded

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Control a cursor hands-free using only eye movements and a webcam.

USE CASE 2

Use the included AAC board demo to test gaze-based communication with 6 tiles.

USE CASE 3

Prototype accessible input for people who cannot use a mouse or keyboard.

USE CASE 4

Study how MediaPipe Face Mesh landmarks can be turned into a gaze-based cursor.

What is it built with?

HTMLJavaScriptMediaPipe

How does it compare?

revolutionarybukhari/oculaamureki/sweatbucksanikchand461/ragbucket
Stars00
LanguageHTMLHTMLHTML
Last pushed2025-08-15
MaintenanceQuiet
Setup difficultyeasyeasyeasy
Complexity2/51/52/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Just open index.html or serve it locally, camera access is restricted on file:// in some browsers.

Free for personal, educational, clinical, and commercial use, as long as you keep the copyright notice.

So what is it?

OCULA is a free, browser-based tool that lets you control your computer cursor using only your eyes and a standard webcam, with no special hardware, no installation, and no account required. It was built to give access to gaze-based input to people who cannot use a mouse or keyboard, such as ALS patients, people with RSI, or those with cerebral palsy, for whom dedicated commercial eye trackers costing USD 200 to 3000 or more are often out of reach. The way it works: your webcam captures a video stream, which is processed by MediaPipe Face Mesh, a library that identifies 468 landmarks on your face including dedicated iris landmarks. OCULA measures the relative position of each iris inside its eye socket and maps that to a screen coordinate. A 5-point on-screen calibration step ties your gaze direction to specific points on the screen. The resulting coordinates are smoothed to keep the cursor stable, and clicking is done by dwelling, meaning holding your gaze on a target for a configurable amount of time, 0.8 seconds by default. A progress ring around the cursor shows how close to a click you are. Included is a demonstration AAC (Augmentative and Alternative Communication) board, a simple 6-tile grid that you can activate with your gaze, showing that a no-hands communication aid can run entirely in a browser tab. Everything runs client-side in vanilla HTML, CSS, and JavaScript with no framework, no bundler, and no backend. Camera frames and iris data never leave your browser. The project is licensed under MIT and explicitly notes it is a research and educational prototype, not a medical device.

Copy-paste prompts

Prompt 1
Help me run OCULA locally and complete the 5-point calibration.
Prompt 2
Explain how OCULA turns MediaPipe Face Mesh iris landmarks into cursor coordinates.
Prompt 3
Walk me through customizing the dwell-to-click speed in OCULA.
Prompt 4
Show me how OCULA's AAC communication board tiles are wired to gaze clicks.

Frequently asked questions

What is ocula?

A free browser-only tool that lets you control your cursor with your eyes using a webcam, including a demo AAC communication board.

What language is ocula written in?

Mainly HTML. The stack also includes HTML, JavaScript, MediaPipe.

What license does ocula use?

Free for personal, educational, clinical, and commercial use, as long as you keep the copyright notice.

How hard is ocula to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ocula for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.