Shader Library
Shelves, folders, history, covers, credits and sharing a .hexshader
Last updated: 2026-11-13
The Library is the drawer of Shaders you can open. Start with Shader Workshop for Compile, autosave and the main path through a look.
Project, My Library and Built-in
The drawer shows Project when a Project is open, and My Library otherwise. Built-in is always below that shelf. My Library is read-only while a Project is open. The message is "My Library Shaders are read-only while a Project is open. Fork it into the Project to edit, or close the Project." A read-only Project says "This Project is read-only. Its Shaders open for viewing; New and Fork cannot write here."
Built-in Shaders are read-only. The badge tooltip says "Built-in shader. Editing creates a copy." The read-only reason is "Built-in Shaders are read-only. Use Save As to edit a copy." Editing a Built-in, or a My Library Shader while a Project is open, makes a copy, opens it, and applies the edit there. The copy is named " - Copy". The suffix is not doubled when the name already ends that way. Duplicate… uses the same suffix.
Built-in folders group those Shaders. Their names are not listed here.
Save As and copies
Save As… needs a saved Shader. The dialog is Save As, with a Name field and Cancel / Save Copy. Only the current shelf is offered.
With a Project open, the destination is This Project ("Creates a new Shader in this Project and opens it for editing."). If that Project is read-only, the dialog says "This Project is read-only, so it cannot take a new Shader. Use Export Shader… to save a portable file." The menu item you use is Export Shader Bundle…. Without a Project, the destination is My Library ("Creates a new Shader in My Library and opens it for editing."). The toast is "“” saved to This Project" or "… My Library".
Save As pre-fills " Copy" with no dash, and saves the name you type. That is a different suffix from the automatic " - Copy" made by editing a Built-in or by Duplicate….
Open as Copy from History can land in This Project ("Opens for editing in this Project.") or My Library ("Opens read-only until the Project is closed."). Without a Project, My Library opens for editing. With a Project open, a copy saved to My Library opens read-only until the Project is closed.
Library drawer
The drawer title is Library. Search says "Search shaders and folders".
Views, search, sort and filter
Views are List, 1 column, 2 columns, 3 columns and 4 columns ("View:
Filter shows a count badge. Every condition must match. Changing Project clears search and filters. Active filters show as chips, and Clear filters removes them.
| Filter | What you can require |
|---|---|
| Author | Includes No recorded author. |
| Keyword | A keyword on the Shader. |
| Tags · must match all | Every chosen tag. |
| Status | All, Saved, Draft or Incomplete. |
| Favorites only | Starred Shaders. |
Folders
New folder is the folder icon, or New folder in the shelf … menu beside Refresh. Type a name of 1–120 characters. Enter accepts and Esc cancels ("Enter to accept · Esc to cancel").
A folder's … menu has Rename folder and Remove folder — keep shaders…. The confirmation "Remove folder “”?" says how many Shaders move to the top level, that Shader files are kept, and "No shader is deleted or changed. You can Undo right after." The button is Remove folder.
Move a Shader by dragging it onto a folder (Move here, Already here, or Drop for top level), with Move to…, or by pressing M on a focused card. Dragging is blocked while a search is active ("Clear search to drag") and for Built-ins ("Built-in is read-only").
Select, star and tag
Click a card's checkbox (Select ) or press Space on a focused card. Shift+click or Shift+Space selects a range. Ctrl/Cmd+A selects everything visible. Esc (Clear selection (Esc)) clears. A plain click opens the Shader.
The selection bar reads " selected · ", then Favorite / Unfavorite, Tag, Move to…, and a … menu with Select all, Duplicate…, Export to Project… and Delete…. A selection stays on one shelf.
The star is Add to favorites or Remove from favorites. Tags open as Tags for . In 4 columns those actions move into the card menu as Add to favorites and Tags.
A card's … menu has Rename, Duplicate…, Move to…, Go to folder, Export to Project… (Review Project copy result… while a copy is pending) and Delete…. Built-ins have no Go to folder or Delete….
Undo
The Undo bar shows the last change, such as "Moved …" or "Folder renamed", or "Last library change", with Undo. It lasts 15 minutes. Afterwards the messages are "Library change undone." or "Undo is no longer available."
Delete
Delete from the Library is permanent. The dialog is "Delete “”?" or "Delete Shaders?", and the button is Delete. The wording is "Deletes from the library, including revision history, checkpoints, and saved looks. Renders already made keep their frozen copy. This cannot be undone here."
From the document menu the item is Delete…: "Delete “”? Renders already made from it keep their frozen copy." Built-ins say "Built-in Shaders cannot be deleted."
Duplicate… "Creates independent copy/copies in the Project / My Library. Nothing is opened." The name uses " - Copy".
Export to Project
Export to Project… copies the saved version to another existing Project. Pick it with Choose existing Project folder… under Destination Project. The original stays where it is. "Unsaved changes aren't included." The current Project is refused: "Choose another Project. Use Save As to copy here."
New
New makes a Shader from the Native 360 starter ("New Shader from the Native 360 starter"). More New options lists Native 360 (direction), Native 360 (ray), Map, Canvas, From an image… and Paste Shader source…. The document menu calls the first four New in space.
From an image… with nothing open creates a new Shader around a chosen Render or sequence range. With a Shader open, it adds an image input instead. See Image inputs.
Paste Shader source… opens Paste Shader source. "Creates a new Shader in this Project/My Library. COMPILE runs when you ask." The buttons are Cancel and Paste. That paste turns automatic re-check off until the next Compile.
Add Hexshader opens a .hexshader, adds it to the current shelf and opens it. It is disabled when the shelf is not writable, and it is icon-only on a narrow layout.
Thumbnails and covers
Cards without a cover show No cover. While the Library is open, saved Project and My Library Shaders that have no current cover get one rendered in the background at 2048×1024 from their saved capture. A new render happens when the saved Shader changes. Built-ins use their packaged covers. The first good preview frame of a saved Shader with no cover also becomes its cover. That first-frame cover is not used for Built-ins.
Capture Thumbnail (the camera button) or Set Thumbnail keeps a manual cover, and automatic renders stop replacing it. Clear Thumbnail returns to automatic covers. Toasts are "Thumbnail saved" and "Thumbnail cleared". Set Thumbnail and Capture Thumbnail stay disabled with "Preview not ready" until a preview exists. If a capture fails, the toast is "Thumbnail could not be saved".
Document menu
The name pill sits with a back arrow, Back to shaders, and a separate Exit Workshop button. The pill shows an access badge (Editable, Built-in or Read only) and the save dot.
| Item | What it does |
|---|---|
| Library | Opens the drawer. |
| New | Submenu New in space: Native 360 (direction), Native 360 (ray), Map, Canvas. |
| Save | Saves now. The tooltip says changes also save automatically. |
| Save As… | Needs a saved Shader ("Open a saved Shader first."). |
| Retry folder placement | Only after a copy failed to land in its folder. |
| Rename… | Opens Rename Shader. |
| Save Checkpoint | "Save Checkpoint names this revision. It does not record a contribution." Field Checkpoint name, placeholder "Before color change". |
| Checkpoints | Restore and Open as Copy for each checkpoint. |
| Export Shader Bundle… | Writes the accepted .hexshader. |
| Export to Project… | Or Review Project copy result… while a copy is pending. |
| Set Thumbnail | Disabled with "Preview not ready". |
| Clear Thumbnail | Toast "Thumbnail cleared". |
| Delete… | Removes the Shader. Built-ins cannot be deleted. |
Restore : "Restores code, settings and Looks. Keeps current credits and notices." Credit history, provenance, notices, pause, and matching originals stay on this Shader. The toast is "Restored as a new revision."
History
History in the Shader header replaces the editor once a Shader is selected. Back to Editor or Esc returns.
Browse
Revisions are newest first, with "N revisions" / "N loaded". Markers are Current, Inspected, Baseline and View only, plus checkpoint name chips. The latest five always show. Older runs fold into Show N revisions / Hide N revisions. Filter with All revisions or Checkpoints. Search loaded revisions searches only the pages already loaded. Show current revision, Load older revisions and Load older checkpoints bring in more. Interrupted saves are listed on their own as "Interrupted and pending snapshots (N)".
Compare
Click a revision to inspect it. Compare with picks the baseline. The shortcuts are Previous, Current and Locate.
| Tab | What it shows |
|---|---|
| Source | A per-file line diff and a Source module picker. |
| Parameters | Values and Parameter definitions. |
| Other changes | Capture defaults, Output, Space, Extensions, Looks, Settings, Originals and Provenance. |
A field reads Changed, Unchanged, Not retained, Unreadable or Not loaded. A large source diff says "The source diff loads a limited portion. Truncated lines are not the whole file." Show more loads the rest.
Checkpoints
Checkpoint on the inspector (Add checkpoint) opens "Add checkpoint to rN". Enter a Name of at most 120 characters and click Add checkpoint. "Adds a name to this revision. It does not save a new revision." Any revision can be named. Each chip's … menu has Rename name… and Remove name…. Removing deletes only the name. With none yet: "No checkpoints yet. Name a revision you want to return to."
Restore and Open as Copy
Restore revision confirms "Restore rN": "Restores code, settings and Looks. Keeps current credits and notices." Unsaved edits are saved first. It then writes a new revision: "Restored rN as a new revision."
Open as Copy saves that revision as a new Shader in This Project or My Library, with an optional Name of at most 120 characters. The copy inherits that revision's credits and provenance. With a Project open, a copy saved to My Library opens read-only until the Project is closed.
A view-only older revision says you can inspect its source and settings, and that Restore and Open as Copy are unavailable. A save that is still pending also blocks both. An unfinished History action survives a reload, with Check result and, before the action starts, Cancel pending action.
Compact history and recovery
Compact history… is in the History actions … menu. "Keep the saved states you need. Removed history stays recoverable until you explicitly delete it." Built-in Shaders do not offer it.
Retain in History:
- Keep current and checkpoints (Recommended)
- Keep current only, which also removes recovery checkpoint names
Click Review history (or Save changes and review), then Compact history. Nothing is freed yet: "Freed now: 0 bytes. Payloads stay in recovery."
Manage recovery… says "Restore history removed by compaction, or review it for permanent deletion. Recovery has no automatic expiry." Undo compaction restores everything still recoverable. Delete recoverable history…, then Review deletion, then Delete permanently, removes eligible payloads for good. Always kept: the current revision, checkpointed revisions, newer revisions, and anything an import or an unfinished action still needs. Nothing is pruned or expired on a timer.
Looks
The Looks card says "Authored Looks include values, modulators, mappings, Master Clock and mouse input. Legacy Looks change base values only." Thumbnail sizes are S, M and L.
Save current opens Name this look (at most 120 characters) with Save / Cancel. The thumbnail comes from the current view. Include output settings ("Saves the current capture and output settings with this Look.") also stores frame and time, frame rate, pointer, seed, and output width and height. Click a thumbnail or name (Apply ) to apply that Look. A Look saved for parameters that no longer exist warns "Saved for older parameters… Nothing changed."
Each Look's menu has Rename, Capture thumbnail, Clear thumbnail and Delete… (it asks you to confirm). Hover offers Recapture thumbnail from the current view. A current Look stores parameter values, modulators, mappings, Master Clock, mouse input, conventions, the timeline and expressions. Output settings are included only when that switch was on.
Credits
Source card
The Source card says "Recorded notes about who made this and where it came from. They are not legal advice and do not grant permission to share or reuse it."
The card menu has Add my credits (it needs a saved public profile), Enter credits manually, Edit credits, Record contribution, Avatar for this Shader (Use setting, Include or Don't include), Edit profile, Show credits overlay and Show link URL.
Shader credits are Author, License and Attribution. Older values stay under Previous credits. A contributor has Profile, Role (Shader author or Shader editor) and Contribution (at most 1024 bytes). Add contributor adds a row.
Sources (at most 128) use Add source and Save credits. The fields are Title, Author, Link, What it contributed, Relationship, License, License status and AI assistance. Relationship is Original source, Adapted code or Inspired by. License status is Unknown, Recorded, unchecked or Declared by a contributor, unchecked. Warnings include "No license is recorded." and "License conflict".
Credits overlay
The overlay draws the title, "by " and, when Show link URL is on, the first web link, above the timeline for streams and screen captures. Hide credits overlay turns it off. The choice is remembered.
Pending credits
Copilot and an external agent stage credit edits in Pending credits ("Copilot proposed these recorded credit changes:" or "Local agent proposed these recorded credit changes:"). Nothing is written until you click Review pending credits, then Apply credits. That Apply is only for credits. A Shader edit does not wait for it.
shader_research_sources has no button. An agent or Copilot uses it to read one page you name plus at most four named links. It does not crawl, and it reads public addresses only. Limits are 64 KiB a page, 256 KiB in total, and 30 seconds. The text is evidence, not permission to reuse the work.
License declaration
Export Shader Bundle shows License & attribution when an export is blocked on rights. License, in this order and defaulting to MIT, is CC0-1.0, 0BSD, MIT, ISC, BSD-2-Clause, BSD-3-Clause, Apache-2.0, CC-BY-3.0, CC-BY-4.0, CC-BY-NC-SA-3.0.
The other fields are Author, Attribution, License and copyright text (required except for CC0-1.0 and 0BSD) and Additional notices. The checkbox reads "I declare this license covers all of this Shader's source, and the text and notices above are complete. 360 Hextile records this statement; it does not check legal meaning." The button is Declare and Export.
.hexshader: share the accepted snapshot
For a first working source, follow Write Your First Shader. For the package contract, see the .hexshader format page and implementer reference.
Export Shader Bundle… (shader name menu) zips the saved package. The zip is the same folder the Workshop saves: shader.json, source.glsl, modules, provenance.json, and the referenced images and originals. It includes unused modules, every Look, and every referenced frame. An original is included only when it was recorded and the rights allow it.
Export does not zip an unsaved edit or Git HEAD. A missing or corrupt member refuses the whole bundle. Add Hexshader loads the bundle into the current shelf and opens it, after path and hash checks. It is not Import: Import mints a panorama.
The CC0 minimal, composite and coordinate downloads are format-1 packages. reader.mjs read admits format 1. The version-1 inventory pins their bytes and package digests. A host may refuse a package that is valid but too large. Keep the original bytes when it does. Hashes check integrity, not rights. See the format reference.
A package the app does not know is refused, and the previous save is left as it was. Opening an older package upgrades it in memory. The upgraded form is written on the next save. Opening itself does not write.