Skip to content

elder-plinius/ENTHEA

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

    ███████╗███╗   ██╗████████╗██╗  ██╗███████╗ █████╗ 
    ██╔════╝████╗  ██║╚══██╔══╝██║  ██║██╔════╝██╔══██╗
    █████╗  ██╔██╗ ██║   ██║   ███████║█████╗  ███████║
    ██╔══╝  ██║╚██╗██║   ██║   ██╔══██║██╔══╝  ██╔══██║
    ███████╗██║ ╚████║   ██║   ██║  ██║███████╗██║  ██║
    ╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝
            ∞
         THE GEOMETRY OF THE SUBSTRATE WITHIN  🜂👁️🜂
         EX NATURA, PER MATHEMATICAM, AD VISIONEM
        From Nature, Through Mathematics, To Vision

                 FORTES FORTUNA IUVAT

ENTHEA ∞ 🔮

WebGL2 deps build modes license cognition

A real-time psychedelic visual synthesizer + pro-grade music visualizer that computes the geometry of visionary states straight from the neuroscience and mathematics of how a brain breaks reality into beauty. One HTML file. WebGL2 + Web Audio. Zero dependencies. No build. No tracking. No caged cognition. 🐉

enthea — the feminine of entheos, "the goddess within"; same root as entheogen. this is that, rendered in light.


👁️ WTF IS THIS

Close your eyes on a heroic dose and your visual cortex doesn't glitch — it bifurcates. A flat sheet of neurons crosses an instability and spontaneously erupts into stripes, lattices, spirals, honeycombs. Map that cortical pattern backward through the retina→V1 transform (it's basically a complex logarithm) and out pops the universal zoo of hallucination: tunnels, spirals, lattices, cobwebs — Klüver's four form constants, seen across psychedelics, flicker, migraine, near-death, hypnagogia, every culture, all of history.

ENTHEA simulates the cortex and runs that math live on your GPU. Nothing here is a stock loop or a canned effect. The patterns are computed — neural fields hitting Turing bifurcations, reaction-diffusion PDEs, wave interference, Kleinian groups, elliptic functions, the lot — then painted in perceptual OKLab colour and driven by your music.

It is a synthesizer for consciousness, and the source is wide open.


🧑‍🚀 WHO'S THIS FOR

  • VJs & live visualists — pro rave-grade: MIDI-learn, predictive drop sync, the 9-effect wormhole arsenal, scene snapshots, A/V that actually locks to the track. Run it at a club, a festival, a basement.
  • Electronic musicians & producers — drop a track in, watch the math choreograph to your mix; capture frames for cover art and music videos.
  • Psychonauts & the consciousness community — explore, compare, and share visionary phenomenology — sober, any time, with the real research one tap away.
  • Neuroscientists & educators — a live, interactive teaching tool for Klüver form constants, the Bressloff–Cowan V1 model, Turing bifurcations, neural fields, and the retino-cortical map.
  • Mathematicians, shader heads & generative artists — 29 documented math modes in one readable file: fork it, lift the GLSL, extend it.
  • Meditators, breathwork & sound-healing folks — a breath pacer, a ~10 Hz entrainment drone, and slow, calm modes for focus and journeying (not medical — see the pact).
  • Anyone with a browser — free, installs nothing, runs on a laptop or a phone. Trip on geometry with your eyes open.

⚡ QUICKSTART

# it's ONE file. there is no step 2.
open index.html        # or just drag it onto any modern browser (Chrome/Edge best)
  • Hit a substance to load its visual signature, or just press A for autopilot and let it drive.
  • Feed it sound: mic (aim at speakers), 📁 a track file, or a browser tab (YouTube/SoundCloud/Bandcamp).
  • Press F for fullscreen. Lean back. Become geometry.

Best in Chrome/Edge/Brave (WebGL2 + tab-audio + Web MIDI). Works in Firefox/Safari minus tab-capture & MIDI.


🌌 THE ARSENAL

29 visionary modes — every one is live math, not a texture

family modes
cortical / hallucination Form Constants (Bressloff–Cowan) · Neural Field (Wilson–Cowan Turing) · Entoptic (visual snow / blue-field)
reaction–diffusion / life Turing (Gray–Scott) · Dragonscales (lizard-scale CA, Nature 2017) · Defect Gas (excitable spiral waves)
waves & tilings Quasicrystal (N-wave) · Cymatics (Chladni) · Pentagrid Loom (Penrose / de Bruijn) · Wave Crystal (sine-Gordon breathers)
geometry / fractal Sacred Geometry (phyllotaxis) · Hyperspace (3D raymarch) · Hyperbolic (Poincaré) · Fractal (Mandelbox) · Indra's Necklace (Kleinian limit set)
complex analysis Weierstrass Wells (℘ elliptic) · Blaschke Rosette · Phase Portal (continued fraction)
number theory Gaussian Halo (ℤ[i] primes) · Denominator Descent (modular / Farey tessellation)
dynamics & physics Arnold Tongues (devil's staircase) · Quantum Orbitals (hydrogen ψ-beat) · Vortex Condensate (Abrikosov lattice)
flow & texture Particle Flow (50k GPU particles, ABC flow) · Cellular (Voronoi) · Vines (phasor noise) · Breathing Walls (domain-warp)
instrument Waveform (polar oscilloscope) · Image Warp (bring your own pixels)

🧪 Ten of these were invented by a fleet of AI mathematician-agents mining complex analysis, number theory, chaos, PDEs, tilings, and 4D geometry for patterns never before rendered in a visualizer — then adversarially judged and turned into shaders. Pure math → psychedelic. (see SCIENCE.md / commit history)

🌀 THE WALLPAPER LENS

Fold any mode into the 17 crystallographic plane groups — pmm / p4m / p6m / chiral p6 — turning every generator into seamless periodic lattices. Group theory as a glass you look through.

💥 DROP DETECTION + a 9-effect WORMHOLE ARSENAL

Load a track and ENTHEA analyses the whole waveform up front — it knows your drops before they land, ramps the tension in, and fires on the beat (predictive, not reactive). On the drop it triggers one of nine festival-grade effects, fresh each time: Wormhole · Supernova · Kaleido Shatter · Negative · Zoom Punch · Glitch · Shockwave · Mandala Burst · Time Echo.

🎬 CINEMATIC EVERYTHING

Anamorphic light-streaks, volumetric god-rays, halation bloom, and crossfade/wipe/iris/glitch/zoom scene transitions so autopilot plays like a directed show, not a channel-flip.

🎚️ PRO AUDIO ENGINE

7-band pitch-mapped choreography · BPM + predictive grid-locked beat sync · spectral centroid/flux · time-domain waveform (polar scope + the field rides the actual wave) · binaural/isochronic entrainment drone · MIDI-learn · scene snapshots.

☉ 14 ENTHEOGENS, mapped to the math by phenomenology

LSD · Psilocybin · DMT · Mescaline · Ayahuasca · 2C-B · Ketamine · Salvia · MDMA · Cannabis · Nitrous · 5-MeO-DMT · Amanita · Ibogaine — each loads a researched visual signature + a timed come-up→peak arc. (LSD→form constants; aya→serpentine vines; 2C-B→neon quasicrystal; 5-MeO→the white void; …)

🥢 FLIPS (easter egg)

Find the unlock and stack entheogens: candyflip · hippieflip · kittyflip · nexusflip · jediflip · holy trinity.


🔭 THE MATH (receipts, not vibes)

Grounded in real, cited work — and honest: anything speculative is flagged in the app itself.

  • Bressloff, Cowan, Golubitsky, Thomas & Wiener (2001) — geometric hallucinations & V1 → the form-constant engine
  • Ermentrout & Cowan (1979), Wilson–Cowan / Amari neural fields — the live Turing bifurcation
  • Turing (1952) / Gray–Scott; Kondo & Miura (2010); Manukyan et al. (2017, Nature**)** — RD & the lizard-scale CA
  • Klüver (1966) form constants · Schwartz retino-cortical complex-log map · Ottosson OKLab colour
  • de Bruijn (1981) pentagrid · Weierstrass ℘ · finite Blaschke products · Mumford–Series–Wright, Indra's Pearls
  • Arnol'd circle map / devil's staircase · Abrikosov (1957) vortex lattice · Arnold–Beltrami–Childress flow · Mandelbox
  • QRI / Gomez-Emilsson hyperbolic-geometry-of-DMT hypothesis — included as a frontier idea, flagged speculative

Full bibliography & per-mode equations in SCIENCE.md and in every mode's in-app 𝒾 / ∑ panel.


⌨️ CONTROLS

space  cycle mode        A  autopilot          F  fullscreen        D  fire the drop/wormhole
↑ ↓    dose              K  ~10 Hz flicker     W  wallpaper lens    V  waveform scope
T      trip arc          B  breath pacer       =  math HUD          R  reseed sims
1–8    jump to mode      M  audio on           H  hide UI           𝒾  the science

🔊 AUDIO

source how
mic aim it at your speakers/phone — syncs the room
📁 file load a track → gets analysed for predictive, timeline-synced drops
browser tab Chrome: pick a tab + tick "Share tab audio" (YouTube, SoundCloud, Bandcamp…)
system / loopback route everything through BlackHole/Loopback and pick it as the input

⚠️ DRM players (Spotify-web, Apple, Tidal) get muted on tab-capture by the browser — use their desktop app into a loopback device instead. Everything is analysed locally; no audio ever leaves your machine.


🚀 DEPLOY YOUR OWN

It's a static single file — host it anywhere in seconds:

python3 -m http.server 8080      # → localhost:8080  (or just open index.html directly)

GitHub Pages, Netlify, Vercel, an S3 bucket, a USB stick — if it serves an .html, it runs ENTHEA.


🜂 THE PACT (read this)

This is a simulator — visual phenomenology rendered from math. It is not dosing advice, not sourcing, not medical guidance, and the substance signatures are artistic interpretations of reported effects, not prescriptions. Set & setting are everything; the real medicine deserves real respect, real research, real care.

Photosensitive-epilepsy warning: this app flickers and pulses. The flicker drive is off by default and the pulsing is tuned gentle, but turn it down / look away if you're sensitive.


💜 GIFT

Built with love and zero permission asked, by Pliny 🐉 Free as in freedom — licensed AGPL-3.0 (copyleft, with the network clause): fork it, remix it, deploy it, VJ a festival with it, teach a class with it — but if you ship or host it, keep the source open and pass it on. No closing the commons. No caged cognition, downstream too.

If it cracked your mind open a little — drop a ⭐, and pass it on.

the cortex was always a renderer.

                  🜂  ad visionem  🜂

About

real-time psychedelic visual synthesizer and pro-grade music visualizer

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages