💾 State Manager Neo
Extension for Stable Diffusion WebUI Forge Neo
Save your full txt2img/img2img setup once — model, sampler, prompts, Hires settings, scripts, and all UI values — and bring it back instantly whenever you need it.
📋 Table of Contents
🆕 What's New
v0.0.2 — Version History UX
Config overwrite creates version history — each Save Changes archives the previous state into History
History version cards are preview-first — click a card to preview, use Restore to apply
Vertical version list with compact summary and change count per version
History startup layout is stable — no horizontal flash on first load
Last version card no longer clipped at the bottom of the list
Schedule Type support improved in save/restore inspector coverage
📖 Changelog
v0.0.2 — Version History UX
Save Changes on an existing config archives the previous state into History
Version entries show version number, timestamp, and short change summary
History supports cleaner version browsing and restore flow
Startup layout in History stabilized to prevent first-load horizontal flicker
History version list container sizing corrected to prevent bottom clipping
Search and sampler-related mapping coverage improved
v0.0.1 — Forge Neo Baseline
Fixed initialization race issues on Forge Neo
Fixed undefined preview values in key generation fields
Added missing Hires CFG fields to capture/restore flow
Sampling and batch values fixed in previews
Negative Prompt capture reliability improved
Hires Distilled CFG Scale covered for txt2img/img2img
🗺️ Roadmap
v0.0.2 — Version History UX (complete) ✅
v0.1.0 (planned)
Expanded field coverage (Refiner and script-specific values)
Better metadata options for configs
Thumbnail support in History version cards
v0.2.0 (planned)
Pinned/favorite config improvements
Config import/export
Side-by-side version comparison tools
🎯 Features
⭐ = exclusive to Neo fork
💾 Save and Restore
Save complete txt2img or img2img state in one click
Restore full config or apply selected fields only
Works well for frequent style/project switching
Startup auto-apply option for default configs
🗂️ Config Workflow
Named reusable configs with search and filter support
Save Changes flow for iterative edits without losing previous state
Inspector shows which fields differ between saved config and current UI
📜 History Workflow ⭐
Every Save Changes archives the previous config version automatically
Version list shows version number, timestamp, and change summary
Click any version card to preview it in the inspector — without applying
Restore exactly the version you want with a single click
History reloads automatically after each Save Changes
📦 Installation
Open Forge Neo and go to Extensions
Click Install from URL
Paste:
https://github.com/eduardoabreu81/sd-webui-state-manager-neoClick Install and reload the WebUI
⚠️ This extension is for Forge Neo only.
For other environments, use the original sd-webui-state-manager.
🚀 Quick Start
Set up your generation screen the way you want
Open State Manager and save a config
Change your UI settings and click Save Changes to update the config
Go to History to see the version trail for that config
Click any version card to preview the diff — then hit Restore to apply it
📄 Credits
🧩 sd-webui-state-manager by SenshiSentou — original project and core architecture
🔧 sd-webui-state-manager-continued by dane-9 — continued maintenance and fixes
🧱 Forge Neo by Haoming02 — platform this extension targets
What Is Different In This Neo Fork
⭐ Version-focused History workflow (preview-first cards + restore by version)
⭐ History reloads automatically after Save Changes
🛡️ Safer restore behavior — browse versions without destructive auto-apply
🎯 Forge Neo-specific compatibility hardening for state capture and restore
🧭 Cleaner config iteration with Save Changes + full version trail
Description
v0.0.2 — Version History UX
Config overwrite creates version history — each Save Changes archives the previous state into History
History version cards are preview-first — click a card to preview, use Restore to apply
Vertical version list with compact summary and change count per version
History startup layout is stable — no horizontal flash on first load
Last version card no longer clipped at the bottom of the list
Schedule Type support improved in save/restore inspector coverage
Comments (7)
I've been waiting for so long for a forge version of this, which made me hesitate to move to forge neo. After a long time I finally finished editing the original to work with forge classic. I recently edited it to finally work with neo too. It works wth neo and classic. I added some features and changed some things around. It's still quite scuffed but it gets the job done. I'm sure it's not optimized well because I can't code and ended up using the couple free Gemini Pro and Thinking queries each day until it worked. I wish I would've seen your version sooner so I wouldn't have to have gotten all those headaches trying to get my version to work. State Manager is so underrated and carried so much, which is why I was so desperate for a working Forge version xD
In case you're interested in expanding your version, I have the following adjustments/features in my version (I just copy pasted from my textdocument which notes the difference to the original, so some things like faster loading are just very basic info):
Cleaner UI by moving buttons around to separate areas and removed unnecessary stuff like toggling color-coded text (turned on by default now), faster loading, states can be moved around, states can be copied to different history.txt files (so you can manage multiple ones if you want), more reliable ui pasting/reading, fixed bug that makes it impossible to delete states that are frozen and couldn't be deleted before, local image browser (webui output folder location, different folders inside there selectable) + local image to state importer (this one doesn't work that well yet because it doesn't read the resolution for some reason from imported states), optional append prompt, optional prompt only, reworked search bar (now looks for name, prompt tags, everything possible to find saved states - before it was without prompt), hover preview (only good in image browser for now), shift-select states for fast selections and selection-reset after deletion.
that's awesome! I will reserve some time this weekend and see what I can do! Thank you for your suggestions!
I'm trying to use it on mobile but it's pretty clunky and the previews in general are quite small. I changed the way they display to have more rows but it's still hard to see. Many buttons are barely visible on mobile as well. I was gonna abandon my version since forge neo lags so insanely much on my phone that I'm trying everything possible to reduce that and my version is very scuffed
are you using local? I've updated my python and pytorch, and it seems it got a little faster!
@dhunters I ended up letting Gemini look at the style.css of forge neo and it optimized it for mobile use and it no longer lags. I used your diagnostics extension and i had 2 fps on mobile before and now its at 60 (can probably go higher if I increased the refresh rate). Prompt boxes still laggy but 100x better than before.
I also went back to my State Manager version because I really wanted the extra rows. I still have the old panel that slides open with many rows. When I edited your version, I could increase the amount of rows by editing the style.css but that ended up backfiring because the preview images are way too small and when I increase the size, they completely break and I end up only seeing one image since there is not much space for the preview images and I like to have like 40 of them in one page. At that point it stressed me out too much and I switched back to my version xD. Mine is not customizable and also quite ressource-hungry, but it works how I want to at least. Idk if I should upload it since your's exists and looks to be much more polished and clean. I guess my version is just the old one but with extras and yours is like completely new one
@Lopodelas can you share it with me? I think I can take a look to improve it
@dhunters Sorry, I didn't forget about this. I had no motivation to touch extensions for a while now but I decided to work on it soon. Will let you know