whatisgithub

What is lume?

beyondlevi/lume — explained in plain English

Analysis updated 2026-05-18

0KotlinAudience · developerComplexity · 4/5LicenseSetup · hard

In one sentence

An Android app pair that turns Rokid AR glasses into a wearable speed reader, flashing text one word at a time.

Mindmap

mindmap
  root((Lume))
    What it does
      RSVP speed reading
      One word at a time display
      350 to 700 wpm
    Tech stack
      Kotlin
      Android
      Bluetooth BLE and SPP
    Use cases
      Read PDFs on AR glasses
      Import shared text from apps
      Hands-free reading
    Audience
      Rokid glasses owners
      Android developers
    Platform
      Phone host app
      Glasses client app
      Bilingual UI

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

Read PDF and TXT documents hands free through Rokid AR glasses.

USE CASE 2

Share text or PDFs from any Android app straight into a speed-reading queue.

USE CASE 3

Practice rapid reading at adjustable speeds with sentence-level context on pause.

What is it built with?

KotlinAndroidBluetoothGradle

How does it compare?

beyondlevi/lumeandroosio/thortuneazcomp2000/battery-sentinel
Stars000
LanguageKotlinKotlinKotlin
Setup difficultyhardeasymoderate
Complexity4/52/52/5
Audiencedevelopergeneraldeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Rokid AR glasses, Android SDK/JDK, and manual APK sideloading, no packaged release yet.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Lume turns Rokid AR glasses into a wearable speed reader. It works using a technique called RSVP, short for Rapid Serial Visual Presentation, where text is shown one word at a time at a fixed point in your field of view instead of scrolling across a line. A single letter in each word is highlighted so your eyes lock onto that spot and never have to scan back and forth. Reading speed starts around 350 words per minute and can be pushed up to 700. The project is a paired two-app system. A phone app acts as the reading library: you can add PDF and TXT files, paste in text directly, or share text and PDFs into it from any other Android app using the normal share menu. All text extraction happens on the phone itself, nothing is sent anywhere else. The phone then streams the text to the glasses over Bluetooth in small word-by-word chunks. On the glasses side, a simple display shows the reading. Tapping starts or pauses the current document, and swiping changes speed while reading or steps sentence by sentence while paused. When paused, the surrounding sentence is shown with the current word highlighted so you can find your place again. Reading progress is saved automatically for each document and picks up where you left off, even after reconnecting the glasses. Other touches include adaptive pacing that holds longer on long words and sentence endings so fast reading stays comfortable, a bilingual English and Portuguese interface, and a connection system that tries several Bluetooth methods at once and keeps whichever connects first, reconnecting automatically if the link drops. The project has a public backlog of planned features including EPUB support, importing readable text from web articles, chapter navigation, bookmarks, and reading statistics. There is no packaged release yet. Building it requires Android development tools including a JDK and the Android SDK, and the resulting apps are installed manually onto the phone and sideloaded onto the glasses. It is released under the MIT license and is written in Kotlin.

Copy-paste prompts

Prompt 1
Walk me through building the Lume phone and glasses APKs from source.
Prompt 2
Explain how Lume's word-window streaming over Bluetooth keeps reading from stalling.
Prompt 3
Help me understand the shared-contracts module that both Android apps compile against.
Prompt 4
What would I need to add EPUB import support to Lume's backlog?

Frequently asked questions

What is lume?

An Android app pair that turns Rokid AR glasses into a wearable speed reader, flashing text one word at a time.

What language is lume written in?

Mainly Kotlin. The stack also includes Kotlin, Android, Bluetooth.

What license does lume use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is lume to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is lume for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.