# Sol-37 Screensaver README

Date: 2026-04-26

## What This Is

The Sol-37 screensaver is not a separate animation pasted on top of the desktop. It is the floating assistant orb expanded into a full desktop-scale field and then collapsed back into the orb when the system returns to idle.

The orb, the lensing flares, the event horizon, the star field, the icon disintegration, the narration, and the audio-reactive color logic are all facets of the same surface.

At rest, the full screensaver is compressed into the orb's own visible boundary:

- a black event horizon in front
- a pulsing light source behind it
- a warped adjacent slice visible through lensing
- Hawking-like radiation escaping from the rim
- cursor-directed flare motion across the orb surface

When immersion increases, that same structure unfolds outward until the desktop itself becomes the field.

## Core Behavior

### 1. Idle Surface State

Even without a held click or tap, the orb remains active.

- Cursor movement bends the internal lens and flare direction.
- The warped surface tracks the cursor angle.
- The hidden light source keeps pulsing behind the event horizon.
- The outer rim emits short radiation arcs and lensing traces.

This is the collapsed screensaver state: the whole field is still present, but shrunk onto the orb surface.

### 2. Activation and Full Field

When the user clicks, taps, or holds:

- the cursor or finger becomes a temporary event horizon
- the assistant orb and the cursor form a binary system
- the desktop darkens into a star field
- perturbations appear as gravitational ripples or waves
- flares arc toward the active cursor or touch point

The event horizon at the cursor only exists while the interaction is active, then fades until another interaction creates a new one.

### 3. Icon Matter and Accretion

Under stronger immersion:

- desktop icons gravitate toward the cursor/orb pair
- icons cross the horizon and disintegrate into particles
- those particles become stars and accretion material
- the generated particles join the disk between the two bodies
- when motion subsides, the particle field can reassemble into icons

This is intentional. The desktop itself becomes matter in the field.

### 4. Audio-Reactive Color Logic

The visual color mapping is exaggerated from the assistant orb palette:

- low frequencies push red
- mid frequencies push green
- high frequencies push blue

Peak energy intensifies the palette rather than replacing it. The system should still read as Sol's orb, but with more spectral separation at high activity.

### 5. Narration

The screensaver can narrate its own state through the site's AI backend.

- narration begins after a short held interaction with little movement
- narration continues to completion even if the user releases and resumes
- after completion, the system remains quiet for a while before repeating
- audible narration can be muted without stopping the orb's light playback
- mute affects audible output only; the visual system still behaves as if audio is playing

Occasionally, immersion narration plays in reverse. When this happens, the reversed signal is not just a visual flag: the user hears the reversed audio and the orb receives that same reversed waveform for analysis.

## Relationship To The Talking Thesaurus

The Talking Thesaurus is not separate from this system. It is the clearest statement of why the orb, narration, and desktop exist at all.

Its core claims carry directly into the screensaver:

- voice is part of the thesis, not decoration
- the orb is a transport layer between inner complexity and public expression
- the desktop is a materialized assistive fiction
- the lag between thought and speech is a transport problem, not proof of absence

The screensaver extends that idea from language into atmosphere.

Where The Talking Thesaurus says:

- the orb can carry thought outward through speech
- the public desktop is an external bridge

The screensaver says:

- the same bridge can become environmental
- attention, hesitation, motion, sound, and narration can all occupy one shared field
- the assistant orb is both an interface control and a cosmological metaphor for translation under pressure

## The Talking Thesaurus Content, In Plain Terms

The Talking Thesaurus exists because ordinary speech timing often fails to keep up with internal thought.

It describes:

- searching for the precise word before a thought evaporates
- growing up with a persistent gap between internal complexity and external speech
- using tools, language systems, and eventually interface systems as bridges
- building a public desktop that acts like a private assistive fiction made real

It also insists that spoken narration belongs on the surface, not hidden behind menus:

- the narration overlay stays present
- the orb directly toggles playback
- multiple narration versions can be switched without leaving the page

This matters to the screensaver because the orb is not only a visual object. It is a speech object, a listening object, and a translation object.

## Implementation Notes

Primary files:

- `www/index.html`
- `www/assets/hue-visualizer.js`
- `www/talking-thesaurus.html`
- `bin/sol_chat_api.py`
- `bin/local_model_stack.py`

Relevant runtime concepts:

- desktop assistant orb
- full-screen multiversal field
- icon gravity and disintegration
- accretion disk between cursor and orb
- lightweight `text_fast` narration path
- optional audible mute with continued light playback
- occasional reversed narration waveform

## Reading This On The Desktop

This document is intended to be reachable in two places:

- as a desktop icon inside the Sol-37 shell
- as a post inside the Blog window

Those should point to the same underlying markdown document so the description stays synchronized.

## Short Version

The Sol-37 screensaver is the assistant orb unfolded into a desktop-scale cosmology and then folded back into the orb when idle.

The Talking Thesaurus explains why the orb exists.
The screensaver shows what that same system looks like when thought, voice, cursor motion, icons, and atmosphere are all treated as one continuous field.
