{"id":50152646,"url":"https://github.com/GareBear99/Voxel_Audio","last_synced_at":"2026-05-24T09:01:44.857Z","repository":{"id":353793832,"uuid":"1220816668","full_name":"GareBear99/Voxel_Audio","owner":"GareBear99","description":"Voxel Audio is a local-first, browser-based audio visualizer and export tool that turns a folder of songs into a playable voxel directory, binds artwork to tracks, previews SoundCloud-style export layouts live, and builds deterministic FFmpeg MP4 render kits for single tracks or full albums.","archived":false,"fork":false,"pushed_at":"2026-04-25T16:14:21.000Z","size":247,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-25T16:25:25.708Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GareBear99.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-25T11:23:09.000Z","updated_at":"2026-04-25T16:14:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/GareBear99/Voxel_Audio","commit_stats":null,"previous_names":["garebear99/voxel_audio"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/GareBear99/Voxel_Audio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareBear99%2FVoxel_Audio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareBear99%2FVoxel_Audio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareBear99%2FVoxel_Audio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareBear99%2FVoxel_Audio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GareBear99","download_url":"https://codeload.github.com/GareBear99/Voxel_Audio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GareBear99%2FVoxel_Audio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33427584,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-24T09:01:36.648Z","updated_at":"2026-05-24T09:01:44.850Z","avatar_url":"https://github.com/GareBear99.png","language":"HTML","funding_links":[],"categories":["Hub network","Academic / Research SEO Positioning"],"sub_categories":["Canonical product/project anchors","Citation-ready ecosystem anchors"],"readme":"# Voxel Audio\n\n## Current release status — v1.8.16\n\nThis package has been audited and aligned as a **low-weight local creator tool**:\n\n- Local-first folder audio visualizer.\n- Playable voxel directory for detected audio files.\n- Image binding per track.\n- Artist-required export metadata with 36-character cap.\n- Live export preview.\n- Browser Record for quick previews.\n- Session Export Vault with edit/re-export.\n- Deterministic FFmpeg MP4 Kit for production output.\n- Album Route Builder for multi-track render kits.\n- Lite / Eco / Auto / High performance ladder for older hardware.\n- Reset/Back button bindings corrected in v1.7.1 after audit.\n- Production hardening in v1.8.16: Lite mode, cached background render, hidden-tab pause, web-node draw caps, throttled artwork transforms, debounced resize, and automatic performance governor.\n\nThe no-server build is usable now. Google OAuth, Stripe, account quotas, and server FFmpeg rendering are roadmap systems, not active local-build features yet.\n\nSee:\n\n- `docs/EXTENSIVE_AUDIT_REPORT.md`\n- `docs/PERFORMANCE_TUNING.md`\n- `docs/SONG_TITLE_AUTHORITY.md`\n- `docs/RELEASE_STATUS.md`\n- `docs/OPERATOR_MANUAL.md`\n\n\n**Voxel Audio** is a local-first, browser-based audio visualizer and export tool that turns a folder of songs into a playable voxel directory, binds artwork to tracks, previews SoundCloud-style export layouts live, and builds deterministic FFmpeg MP4 render kits for single tracks or full albums.\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eLocal audio folder → playable voxel grid → image-bound visualizer → preview → MP4 kit\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e ·\n  \u003ca href=\"#quick-start\"\u003eQuick Start\u003c/a\u003e ·\n  \u003ca href=\"#export-workflows\"\u003eExport Workflows\u003c/a\u003e ·\n  \u003ca href=\"#album-route-builder\"\u003eAlbum Route Builder\u003c/a\u003e ·\n  \u003ca href=\"#docs-routing\"\u003eDocs Routing\u003c/a\u003e ·\n  \u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\n## Powered by Proto-Synth Grid Engine\n\nVoxel Audio is built as a creator-facing audio export platform using the design language of **Proto-Synth Grid Engine**.\n\nReference:\n\n```text\nhttps://github.com/GareBear99/Proto-Synth_Grid_Engine\n```\n\nProto-Synth Grid Engine is a deterministic, math-first, low-weight 2D simulation projected to feel visually 3D. Voxel Audio adapts that doctrine into an audio product:\n\n- folders become route surfaces\n- tracks become playable voxels\n- RGB color becomes export identity\n- album routes become renderable structures\n- Canvas2D keeps the platform no-server and lightweight\n- FFmpeg kits provide deterministic release output\n\n\n## Why Voxel Audio exists\n\nMost quick music visualizer workflows are either locked behind cloud upload tools, fragile browser screen-recording, or heavyweight video editors. Voxel Audio is designed to be:\n\n- **Local-first** — your audio and images stay on your machine.\n- **Folder-native** — drag in a folder and every valid audio file becomes a playable voxel.\n- **Release-aware** — preview visually in-browser, but generate final MP4 through deterministic FFmpeg scripts.\n- **Album-capable** — build a route from selected tracks, current folder, search results, or all loaded songs.\n- **Artist-friendly** — bind cover art, rename export titles, control colors, and produce SoundCloud-style video assets.\n\n---\n\n\n\n## Watermark and pricing policy scaffold\n\nThe browser Record renderer includes a free-tier watermark scaffold.\n\nPlanned USD tiers:\n\n- **Free** — watermarked browser Record exports, 5 exports/week.\n- **$3 USD/month** — 99 server FFmpeg exports/month.\n- **$7 USD/month** — unlimited no-watermark browser Record exports and unlimited no-watermark server FFmpeg exports.\n\n\n## Free and paid export positioning\n\nVoxel Audio is being positioned with a creator-friendly **USD** export model once accounts and server rendering are connected.\n\n### Free account plan\n\n```text\n$0 USD\n```\n\nThe free account plan is intended for:\n\n- browser **Record** exports\n- watermarked exports\n- **5 exports/week** once Google OAuth accounts are released\n- local folder playback\n- voxel directory browsing\n- image binding\n- live export preview\n\n### Server FFmpeg tier\n\n```text\n$3 USD/month\n```\n\nPlanned benefits:\n\n- **99 server FFmpeg exports/month**\n- server-side FFmpeg MP4 rendering\n- Google OAuth account login\n- Stripe subscription integration\n- better reliability than browser recording for creators who need rendered MP4 output\n\n### Unlimited Creator tier\n\n```text\n$7 USD/month\n```\n\nPlanned benefits:\n\n- **unlimited no-watermark browser Record exports**\n- **unlimited no-watermark server FFmpeg exports**\n- best fit for creators releasing polished visualizers regularly\n- removes the weekly/monthly export ceiling\n\n### Integration roadmap\n\nThe account/server plan requires:\n\n- Google OAuth login\n- Stripe subscription checkout and billing\n- account export counters\n- free weekly export limits\n- monthly paid FFmpeg export quotas for the $3 USD tier\n- unlimited entitlement checks for the $7 USD tier\n- server-side FFmpeg render queue\n- watermark policy for free browser Record exports\n- no-watermark policy for paid tiers\n\n## Features\n\n### Local folder audio router\n\n- Open a folder with the picker.\n- Drag/drop a folder anywhere on the screen.\n- Detects playable audio files:\n  - `mp3`\n  - `wav`\n  - `ogg`\n  - `m4a`\n  - `aac`\n  - `flac`\n  - `opus`\n  - `webm`\n- Preserves nested route paths for search and album building.\n- Every valid audio file becomes:\n  - a voxel in the scene\n  - a row in the Browser Hub\n  - an exportable audio source\n\n### Playable voxel directory\n\n- Click a voxel to play its track.\n- Voxel color is seeded and track-specific.\n- Selected track color syncs with:\n  - app border accent\n  - waveform accent\n  - export preview accent\n  - browser record accent\n  - FFmpeg render kit accent\n  - album segment accent\n\n### Search and panel safety\n\n- Search filters valid track rows and voxels.\n- Browser Hub is height-matched to the left panel.\n- Browser Hub scrolls internally.\n- Recenter button restores the voxel scene if the view is moved offscreen.\n\n### Image binding\n\n- Bind artwork to the selected track.\n- Drag/drop an image onto a voxel to bind directly.\n- Bound image is used by:\n  - live floating image preview\n  - Live Export Preview\n  - Browser Record Export\n  - single-track FFmpeg MP4 kit\n  - album route export kit\n\n### Live Export Preview\n\n- Opens a scaled 1280×720 preview panel.\n- Uses the same visual renderer as browser recording.\n- Updates while audio plays.\n- Uses the selected song’s voxel RGB color.\n- Uses editable Song name.\n- Shows the final single-track visualizer composition before export.\n\n### Browser Record Export\n\nBrowser Record is included as a convenience preview/export path.\n\n- `10s Record` records a short normal-speed preview.\n- `Record Full` records the full track at normal 1x speed.\n- `Record: Auto / MP4 / WebM` lets the browser pick supported output.\n- Run log explains failures when browser recording APIs are unsupported.\n\n\u003e Browser recording is useful, but final release output should use the deterministic FFmpeg kit.\n\n### Deterministic FFmpeg MP4 Kit\n\nThe production path is not browser self-recording.\n\n`Build MP4 Kit` downloads:\n\n- the selected audio source\n- the bound cover image\n- `render_manifest.json`\n- `render_ffmpeg.sh`\n- `render_ffmpeg.bat`\n- run log\n\nRun the script and FFmpeg renders a real H.264/AAC MP4.\n\n### Album Route Builder\n\nAlbum Route Builder can collect songs from anywhere in the loaded folder tree:\n\n- selected track\n- visible/search results\n- current folder\n- all loaded tracks\n\nIt then generates a full album render kit:\n\n- all routed audio files\n- per-track covers or fallback cover\n- `album_manifest.json`\n- `render_album_ffmpeg.sh`\n- `render_album_ffmpeg.bat`\n- album run log\n\nEach track segment can use:\n\n- its original voxel RGB color\n- a per-track custom album color\n- one album-wide color applied to every track\n\n---\n\n\n## No-server local mode\n\nVoxel Audio is built to work as a **no-server local app**.\n\nYou can use it by simply double-clicking:\n\n```text\nindex.html\n```\n\nNo backend is required.\n\nNo account is required.\n\nNo upload is required.\n\nNo local Node server is required for normal use.\n\nA local static server is optional only when you want more predictable browser behavior during development.\n\n### What works locally\n\n- Folder picker.\n- Drag/drop folder loading.\n- Audio playback.\n- Voxel scene rendering.\n- Search.\n- Image binding.\n- Live Export Preview.\n- Browser Record Export.\n- FFmpeg MP4 Kit generation.\n- Album Route Builder.\n- Info/docs overlay.\n\n### Browser Record feature\n\nVoxel Audio includes a no-server browser recording feature:\n\n- **10s Record** records a short normal-speed preview.\n- **Record Full** records the selected song at normal 1x playback speed.\n- **Record: Auto / MP4 / WebM** selects the browser recording preference.\n- Download Run Log explains any recording failure.\n\nBrowser Record is best for quick previews. For release-grade MP4 output, use **Build MP4 Kit**.\n\n\n## Reliability patch: Quick Dock\n\nThe app includes a fixed upper-right **Quick Dock** so critical controls remain accessible even if the top bar overflows on smaller screens.\n\nQuick Dock buttons:\n\n- `＋ Folder`\n- `＋ Image`\n- `ⓘ Info`\n- `Preview`\n- `Record`\n- `MP4 Kit`\n- `Album`\n\nA small startup diagnostic appears briefly on load and reports if required browser APIs or controls are missing.\n\n\n## Hotbar cleanup and freeze guard\n\nThe app now keeps duplicated Quick Dock actions out of the top scroll bar, making the top bar shorter and easier to use.\n\nCritical actions stay in the fixed Quick Dock:\n\n- Folder\n- Image\n- Info\n- Preview\n- Record\n- MP4 Kit\n- Album\n- Bindings\n\nRuntime error diagnostics now appear onscreen if a control or browser API fails instead of silently freezing.\n\n## Quick Start\n\n### Option A — open directly\n\nDouble-click `index.html` or open it directly in a modern browser. This is the recommended no-server path.\n\nRecommended browsers:\n\n- Chrome\n- Edge\n- Safari for MP4 experiments\n- Any browser with Web Audio and Canvas support for playback/visuals\n\n### Option B — serve locally\n\nSome browser features behave better from a local server.\n\n```bash\npython3 -m http.server 8080\n```\n\nThen open:\n\n```text\nhttp://localhost:8080\n```\n\n---\n\n## Basic workflow\n\n1. Click **Open Audio Folder**, or drag/drop a folder anywhere.\n2. Click a voxel or Browser Hub row to select/play a song.\n3. Click **Bind Image To Selected**, or drag an image onto a voxel.\n4. Edit **Song name** in the export panel if needed.\n5. Click **Preview Export**.\n6. Use **10s Record** for a quick browser preview.\n7. Use **Build MP4 Kit** for final release-quality MP4 output.\n\n---\n\n\n\n## Binding maps\n\nVoxel Audio now supports binding-map metadata:\n\n- **Export Bindings** downloads a JSON map of track/image/color binding metadata.\n- **Import Bindings** matches loaded tracks by path/name and restores metadata.\n- Image blobs may still need rebinding because browsers do not allow silent restoration of arbitrary local files.\n\n\n## Session Export Vault\n\nBrowser Record exports are now protected by a session vault.\n\nAfter **10s Record** or **Record Full** completes, Voxel Audio keeps the last **9 browser Record exports** in memory with Download buttons.\n\nThis solves the problem where a browser download prompt is missed or dismissed at the end of the recording stream.\n\nImportant notes:\n\n- The vault is session-only.\n- It clears when the page is closed or reloaded.\n- It does not upload anything.\n- It is for Browser Record outputs, not FFmpeg kit files.\n\n\n## Image-required export policy\n\nVoxel Audio now blocks visual export actions unless artwork is bound to the selected track.\n\nRequired before single-track export:\n\n1. Select/play a song.\n2. Bind or drop an image onto that song.\n3. Confirm the floating image appears.\n4. Then use Preview, Record, or Build MP4 Kit.\n\nBlocked until artwork is present:\n\n- Preview Export\n- 10s Record\n- Record Full\n- Build MP4 Kit\n\nAlbum export also requires artwork coverage: either every routed track has artwork, or a fallback album cover is set.\n\n## Export shape safety\n\nThe renderer clamps rounded-rectangle radius values so tiny progress bars and UI pills cannot explode into giant foreground shapes. This prevents the waveform/progress accent color from covering the cover image or export layout.\n\n## No foreground accent-shape policy\n\nThe export renderer now disables large RGB blob/triangle accent fills. Only subtle background glow is allowed.\n\nThis guarantees the cover image, title, description panel, waveform panel, and watermark are never covered by foreground color geometry.\n\n## Selected voxel color identity\n\nAll export visual elements now follow the selected song's voxel RGB color:\n\n- title glow\n- metadata text\n- description/capsule panel\n- cover outline\n- reactive circle\n- waveform\n- progress bar\n- watermark\n- preview/export panel borders\n- background glow\n\n## Export metadata and layering\n\nVoxel Audio export layouts now include editable metadata:\n\n- Song name\n- Artist\n- Feat\n- Description\n\nThe Description field defaults to:\n\n```text\nfull-track reactive visualizer\n```\n\nThe export renderer uses a strict layer policy so RGB accent shapes stay behind the cover image, description panel, title, and waveform panel.\n\nThe circular visual element is now a real reactive frequency visualizer using bass, mid, treble, and frequency-spoke motion.\n\n## Export Workflows\n\n### Final release workflow\n\nUse this for actual music distribution, store previews, YouTube uploads, SoundCloud visual assets, or release promos.\n\n1. Select a song.\n2. Bind artwork.\n3. Click **Preflight**.\n4. Click **Build MP4 Kit**.\n5. Move all downloaded kit files into one folder if your browser separates downloads.\n6. Run:\n\nmacOS/Linux:\n\n```bash\nchmod +x render_ffmpeg.sh\n./render_ffmpeg.sh\n```\n\nWindows:\n\n```bat\nrender_ffmpeg.bat\n```\n\nOutput:\n\n```text\n\u003csong\u003e_Voxel_Audio.mp4\n```\n\n### Browser preview workflow\n\nUse this for quick checks.\n\n1. Select a song.\n2. Bind artwork.\n3. Click **Preview Export**.\n4. Click **10s Record**.\n5. Review the downloaded preview.\n\nBrowser recording is normal 1x song speed. It is intentionally not accelerated.\n\n---\n\n## Install FFmpeg\n\n### macOS\n\n```bash\nbrew install ffmpeg\n```\n\n### Windows\n\n```powershell\nwinget install Gyan.FFmpeg\n```\n\n### Linux\n\n```bash\nsudo apt install ffmpeg\n```\n\n---\n\n## Album Route Builder\n\nOpen **Album Route**.\n\nAdd tracks by:\n\n- **Add Selected** — adds the current song.\n- **Add Visible/Search** — adds whatever the current search/filter shows.\n- **Add Current Folder** — adds tracks from the selected/current folder.\n- **Add All Loaded** — adds every loaded track.\n\nThen configure:\n\n- Album title\n- Route name\n- Fallback cover image\n- Per-track colors\n- Album-wide color\n\nClick **Build Full Album Kit**.\n\nRun:\n\n```bash\nchmod +x render_album_ffmpeg.sh\n./render_album_ffmpeg.sh\n```\n\nor on Windows:\n\n```bat\nrender_album_ffmpeg.bat\n```\n\nThe script renders each track segment and concatenates the full album MP4.\n\n---\n\n## Docs Routing\n\nThe app includes an in-app **ⓘ Info** overlay with route-based documentation:\n\n- Overview\n- Quick Start\n- Controls\n- Folder Loading\n- Search\n- Image Binding\n- Live Preview\n- Browser Record\n- MP4 Kit\n- Layout / Panels\n- Troubleshooting\n- Album Route Plan\n- Release Notes\n\nExternal docs mirror the same structure in `docs/routes`.\n\n---\n\n## Privacy\n\nVoxel Audio is local-first.\n\n- No uploads.\n- No external API required.\n- Audio files stay on your machine.\n- Images stay on your machine.\n- Export kits are generated locally in the browser.\n- Final MP4 rendering happens locally through FFmpeg.\n\n---\n\n## Browser support notes\n\nPlayback and visualizer features use:\n\n- HTML File APIs\n- Canvas 2D\n- Web Audio API\n- drag/drop APIs\n\nBrowser Record uses:\n\n- `MediaRecorder`\n- `canvas.captureStream`\n- WebAudio stream routing\n\nThese APIs vary by browser. When browser recording fails, use the deterministic FFmpeg kit.\n\n---\n\n## Project structure\n\n```text\nvoxel-audio/\n├── index.html\n├── README.md\n├── LICENSE\n├── CHANGELOG.md\n├── package.json\n├── docs/\n│   ├── routes/\n│   ├── EXPORT_WORKFLOWS.md\n│   ├── ALBUM_ROUTE_BUILDER.md\n│   ├── TROUBLESHOOTING.md\n│   └── ARCHITECTURE.md\n├── examples/\n│   └── example-render-manifest.json\n├── scripts/\n│   └── package_release.py\n└── .github/\n    ├── ISSUE_TEMPLATE/\n    └── workflows/\n```\n\n---\n\n## Roadmap\n\n- Native desktop wrapper for automatic FFmpeg rendering.\n- One-click final MP4 export without manual script execution.\n- Persisted image binding maps.\n- Saved export presets.\n- Album route import/export JSON.\n- Drag reorder album route tracks.\n- Optional waveform style presets.\n- GitHub Pages demo shell.\n- Optional WebCodecs/WebGPU renderer path.\n\n---\n\n## SEO phrases\n\nVoxel Audio targets:\n\n- local audio visualizer\n- SoundCloud style visualizer\n- MP4 music visualizer generator\n- FFmpeg audio visualizer\n- browser music visualizer\n- album visualizer export\n- local-first music video generator\n- canvas audio waveform visualizer\n- Web Audio visualizer\n- artist release video tool\n\n---\n\n## License\n\nMIT License. See `LICENSE`.\n\n\n## Compact blank-description layout\n\nWhen the Description field is left blank, Voxel Audio now uses a tighter export layout instead of leaving empty text space.\n\n- Blank Description = compact visualizer capsule.\n- Typed Description = full description panel.\n- Reactive circle stays active in both modes.\n\n## Optional description behavior\n\nThe export Description field is optional. If left blank, no description is rendered.\n\n\n## Export overlap safety\n\nThe export layout now prevents collisions between:\n- watermark and waveform/timestamps\n- metadata row and reactive circle\n- description/capsule text and circle lane\n\nLong metadata text is automatically ellipsized to stay inside the safe lane.\n\n\n\n## Admin watermark unlock\n\nThe export panel includes **Admin name** and **Admin key** inputs.\n\nLocal dev/admin key:\n\n```text\nVOXEL-AUDIO-ADMIN\n```\n\nEntering the key disables the free watermark for browser Record exports in the current local browser/session. This is a development scaffold only; production no-watermark access must be enforced server-side through Google OAuth, Stripe, and render entitlement checks.\n\n\n## TizWildin watermark branding\n\nWhen the free watermark is active, exports display:\n\n```text\nTIZWILDIN ENTERTAINMENT\nA TizWildin Entertainment Product\n```\n\nThe Admin key can still disable the watermark locally for development/testing.\n\n\n## Admin clean-export status and single export color\n\nThe export panel now includes:\n\n- Admin name\n- Admin key\n- admin clean-export status hint\n- single Export color chooser\n\nThe admin unlock removes the watermark from Live Preview and Browser Record immediately.\n\nThe Export color picker defaults to the selected voxel color, but can be changed for that single audio export.\n\n\n## Where completed Record exports show up\n\nCompleted **10s Record** and **Record Full** exports appear in the **Session Export Vault**.\n\nUse the Quick Dock:\n\n```text\nVault\n```\n\nThe Vault also opens automatically after a successful browser Record export. It keeps the last 9 completed browser Record exports from the current session, each with a Download button.\n\n\n## Vault edit and re-export\n\nCompleted browser Record exports in the Session Export Vault can now be edited and re-exported.\n\nEditable per vault item:\n\n- Song name\n- Artist\n- Feat\n- Description\n- Export color\n\nClick **Re-export** to re-run the same Record mode using the edited metadata. The original track and image binding must still be loaded in the current session.\n\n\n## Artist required before export\n\nVoxel Audio now requires an **Artist** name before Preview, Record, or MP4 Kit export.\n\nRules:\n\n- Artist is required.\n- Artist max length is 36 characters.\n- Artist is locked into export metadata when recording/export starts.\n- Vault re-export also requires Artist.\n\n\n## Voxel click color sync\n\nSelecting a voxel now always resets the export color to that voxel's RGB color.\n\nManual color override still works, but only until you select another voxel.\n\n\n## PlayTrack color sync fix\n\nClicking/playing a real audio voxel now immediately pushes that voxel color into the Export color input and export renderer.\n\nThe issue was that the real audio-file branch played the track but skipped the color-sync call.\n\n\n## Reset and Back behavior\n\n- **Reset** fully returns the app to startup state and clears the loaded session.\n- **Back** only backs out of panels, folder focus, search, selected voxel focus, or zoom. It does not delete the loaded folder/session.\n\n---\n\n## v1.8.16 production documentation map\n\nFor the current audited and production-hardened package state, use these docs first:\n\n| Document | Purpose |\n|---|---|\n| `docs/EXTENSIVE_AUDIT_REPORT.md` | Full package audit, confirmed capabilities, known constraints, and next engineering pass. |\n| `docs/PERFORMANCE_TUNING.md`\n- `docs/SONG_TITLE_AUTHORITY.md` | Weak-hardware Lite/Eco operating guide and performance governor notes. |\n| `docs/RELEASE_STATUS.md` | What is ready now vs. what is still roadmap. |\n| `docs/OPERATOR_MANUAL.md` | Straight usage manual for loading, binding, previewing, recording, vault, and FFmpeg kit workflow. |\n| `docs/ARCHITECTURE.md` | Runtime layer map and quality ladder. |\n| `docs/PRODUCTION_HARDENING_PASS.md` | v1.8.16 runtime hardening details and remaining SaaS blockers. |\n| `docs/RESET_AND_BACK_BEHAVIOR.md` | Correct Reset/Back behavior after v1.7.1 binding fix. |\n\n\n### v1.8.4 Title Render Revert\n\nThe v1.8.2/v1.8.3 title marquee experiment has been reverted. Export title rendering is restored to v1.8.1 behavior while keeping Song Title Authority intact. See `docs/TITLE_RENDER_REVERT.md`.\n\n\n### v1.8.5 Side Metadata Scroll Fix\n\nThe small `VOXEL AUDIO EXPORT • song • artist/feat` export metadata line now scrolls inside a clipped safe lane and cannot overlap the reactive circle. Main title rendering is untouched. See `docs/SIDE_METADATA_SCROLL_FIX.md`.\n\n\n### v1.8.6 Preview Scroll Clock Fix\n\nLive Export Preview now correctly shows the small metadata line scrolling because the preview renderer uses a persistent timing clock instead of resetting every frame. Main title rendering is untouched. See `docs/PREVIEW_SCROLL_CLOCK_FIX.md`.\n\n\n### v1.8.7 Side Metadata End Pause\n\nThe small side metadata scroll now holds longer at the end before resetting back to the start. Main title rendering remains untouched. See `docs/SIDE_METADATA_END_PAUSE.md`.\n\n\n### v1.8.10 MP4 Direct Audio Restore\n\nBrowser Record MP4 is restored and now tries direct `\u003caudio\u003e.captureStream()` before WebAudio capture to reduce silent MP4 exports. The recorder logs audio/video track counts before recording starts. See `docs/MP4_DIRECT_AUDIO_RESTORE.md`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGareBear99%2FVoxel_Audio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGareBear99%2FVoxel_Audio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGareBear99%2FVoxel_Audio/lists"}