
   ▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
   █                                                                            █
   █             · · ·   d e e p   z o o m   f r a c t a l   · · ·              █
   █                 /\      /\      /\      /\      /\      /\                 █
   █                 _/  \  _/  \  _/  \  _/  \  _/  \  _/  \_                  █
   █                                                                            █
   █              ███████╗██████╗  █████╗ ██╗  ██╗██████╗ ██████╗               █
   █              ██╔════╝██╔══██╗██╔══██╗╚██╗██╔╝╚════██╗██╔══██╗              █
   █              █████╗  ██████╔╝███████║ ╚███╔╝  █████╔╝██║  ██║              █
   █              ██╔══╝  ██╔══██╗██╔══██║ ██╔██╗  ╚═══██╗██║  ██║              █
   █              ██║     ██║  ██║██║  ██║██╔╝ ██╗██████╔╝██████╔╝              █
   █              ╚═╝     ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚═════╝               █
   █                                                                            █
   █              F R A C T A L   M U S I C   V I S U A L I Z E R               █
   █                                                                            █
   █            real-time 3D  ·  one-click music videos  ·  8 genres            █
   █                     never renders the same video twice                     █
   █                                                                            █
   █                            >>>  frax3d.com  <<<                            █
   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

Real-time 3D fractal music visualizer. Two apps, one engine:
  FRAX3D        (F3D icon)  -> the FULL APP  - musicians, VJs, video export
  FRAX3D Player (3DP icon)  -> the PLAYER    - just press play and watch

This file is the quick manual. The full illustrated guides (EN/FI/SV/DE/ES)
live at  https://frax3d.com/help.html


1. STARTING
-----------
Windows: use the desktop shortcuts the installer made, or from this folder:
    Open-FRAX3D.cmd          full app
    Open-FRAX3D-Player.cmd   player
Mac / Linux: open frax3d.html (or player.html) directly in Chrome or Edge.

FRAX3D opens in its own window using Chrome or Edge - whichever you have.
It runs locally; after the first launch no internet is needed (built-in
music streams from frax3d.com, your own local files always work offline).

FIRST RUN: the very first launch spends a minute "Building shaders" while
your GPU compiles the visualizer. This is cached - every later launch is
fast. A black screen on a later run? Run Reset-FRAX3D.cmd once, reopen.


2. THE PLAYER IN 60 SECONDS
---------------------------
* Music bar (top): prev / play / next / stop, a folder button to open YOUR
  own music files (mp3/wav/flac...), and a magenta "swap arrows" button
  that RANDOMIZES the visual scene - tap it on the beat.
* Genre buttons (bottom): Ambient, Chill-out, Dubstep, House, Techno,
  Psytrance, Synthwave, Experimental. Each genre completely changes how
  the fractals look, move and react. Tapping the ACTIVE genre again
  reshuffles the visuals - the music keeps playing.
* Auto button: the autopilot - an invisible VJ that keeps changing scenes,
  colors and camera in sync with the music. Teal = on. Turn it off to
  freeze the current scene (Randomize still works manually).
* Effects tab / row: Fix clip (repairs a "cut open" fractal), Mirror
  (kaleidoscope folds), 8-bit (retro pixels), Rand color and more.
* Hide HUD: everything disappears except the visuals. A small control
  strip stays at the bottom; CTRL brings the full controls back.
* Fullscreen: the square icon. On the phone, install the app from the
  browser menu ("Add to Home Screen") for true fullscreen.
* Keyboard: K play/pause - J/L prev/next - X stop - Space randomize -
  A autopilot - H hide HUD - F fullscreen.

Reactivity: when a track plays, the visuals follow ITS signal. When
nothing plays, the player listens to the room through the microphone
(asked once, on your first tap). It switches automatically.


3. THE FULL APP IN 5 MINUTES
----------------------------
Everything the player does, plus the full control panel (right side):

* Visualizer tab  - genre, autopilot, audio reactivity, strobe controls.
* Fractal tab     - 36 fractal types, iterations, scale, fold, power...
                    every knob of the raw math.
* Blend tab       - morph TWO fractal types into one shape.
* Presets         - save/load your favorite looks.
* Camera          - yaw, pitch, zoom, FOV, auto-orbit.
* Colors & Light  - 30+ palettes, multi-palette morphing, glow, fog.
* VJ FX           - strobe, invert, mirror modes, 8-bit, wire mode,
                    plus a 10-slot VJ set with crossfader for live shows.
* Quality         - resolution scale, anti-aliasing, ray steps. If the
                    frame rate dips, lower Quality first, Steps second.
* Keyframes (Pro) - store up to 60 exact moments (long-press a slot to
                    delete it), then play or export them as one smooth
                    camera journey.
* Export          - one-click MUSIC VIDEO: import a track, press Music
                    video, get an mp4 with the audio muxed in. Free tier
                    exports 720p30 with a small watermark; Pro unlocks
                    4K/60, high bitrates and clean output.
* MIDI (Pro)      - map any controller knob/pad with MIDI Learn.

Spacebar randomizes the whole scene with a smooth genre-timed transition.
1-0 jump to keyframes. Arrow keys orbit. +/- zoom. Full list: Help tab.


4. MUSIC
--------
* Built-in: each genre has streamed tracks (frax3d.com) - just tap a
  genre. Requires internet.
* Your own: the folder button opens local files - they play offline and
  never leave your computer. Genre switching leaves your playlist alone.
* The visuals analyse whatever plays and react to ITS drops and beats.

Note (desktop): built-in music streams from frax3d.com, so the catalog
can grow without you reinstalling. Your own files always work offline.


5. FREE vs PRO vs VENUE
-----------------------
FREE   - everything live: all fractals, genres, autopilot, VJ effects,
         720p30 watermarked export. Forever.
PRO    - 4K/60fps clean export, high bitrates, keyframes, MIDI,
         clean VJ output. One-time purchase, enter the key in Help tab.
VENUE  - Pro for commercial spaces + priority support.
Buy at https://frax3d.com - the same install upgrades in place.


6. TROUBLESHOOTING
------------------
Black screen / WebGL error   Run Reset-FRAX3D.cmd, reopen. Still bad?
                             Close ALL Chrome/Edge windows, try again.
No built-in music            You need internet for streamed tracks. Your
                             own files (folder button) always work.
Music plays, no reaction     Tap the screen once (browsers require one
                             tap before audio analysis), and check the
                             Audio reactive switch is on.
Choppy / slow                Quality tab: lower Quality to ~0.6, reduce
                             Steps. Close other GPU-heavy apps.
Mic permission denied        The player then only reacts to loaded
                             tracks - reload and allow the mic to react
                             to room sound.
Window has no F3D icon       Windows sometimes groups app-mode windows
                             under the browser icon - harmless.

WHAT'S IN THIS FOLDER
  frax3d.html              the full app
  player.html              the player
  Open-FRAX3D.cmd          launches the full app (Windows)
  Open-FRAX3D-Player.cmd   launches the player (Windows)
  Reset-FRAX3D.cmd         clears the GPU shader cache
  tracks.json              built-in music catalog (updates from the web)
  sw.js, manifest, icons   support files - keep them next to the app

frax3d.com  -  hello@frax3d.com  -  (c) 2026 FRAX3D
