hello there 🐠

openOutpaint creating some undersea... well, stuff

silly demo example current as of 9b174d6 / v0.0.8 / 2022-12-03 //TODO UPDATE SRSLY

this is a completely vanilla javascript and html canvas outpainting convenience doodad built for the API optionally exposed by AUTOMATIC1111's stable diffusion webUI, operating similarly to a few others that are probably more well-known. this simply offers an alternative for my following vain desires:

• avoiding the overhead of an additional virtual python environment or impacting a pre-existing one
• operates against the API exposed by A1111's webUI
• no external dependencies, extremely boring vanilla
• no external connectivity, self-hosted and offline
• unobfuscated (cough cough)
• i am terrible at javascript and should probably correct that
• i have never used html canvas for anything before and should try it out

features

• now available as an extension for webUI! you can find it under the default "available" section in the webUI extensions tab
  • NOTE: extension still requires --api flag in webui-user launch script
• intuitive, convenient outpainting - that's like the whole point right
• queueable, cancelable dreams - just start a'clickin' all over the place
• arbitrary dream reticle size - draw the rectangle of your dreams
• an effectively infinite, resizable, scalable canvas for you to paint all over
  • NOTE: v0.0.10 introduces a new "camera control" modifier key - hold [CTRL] ([CMD] on mac) and use the scrollwheel to zoom (scroll the wheel) and pan (hold the wheel button) around the canvas
• a very nicely functional and familiar layer system
• inpainting/touchup mask brush
• prompt history panel
• optional (visibly) inverted mask mode - red masks get mutated, blue masks stay the same, but you can't take both pills at once
• inpainting color brush to bring out your inner vincent van bob ross
• dedicated img2img tool with optional border masking for enhanced output coherence with existing subject matter
• marquee select tool to select regions and arbitrarily scale, create stamps, move chunks, peek at lower layers, do all sorts of damage
• optionally decoupled cursor size and output resolution
• interrogate tool
• floating control panel to easily change models/samplers/steps/prompts/CFG/etc options for each dream summoned from the latent void (NOTE: model switching requires A1111 webUI to be on commit 5a6387e or more recent)
• floating toolbox with handy keyboard shortcuts
• optional grid snapping for precision
• optional hi-res fix for blank/txt2img dreams which, if enabled, uses image width/height / 2 as firstpass size
• optional overmasking for potentially better seams between outpaints - set overmask px value to 0 to disable the feature
• import arbitrary images and scale/stamp on the canvas whenever, wherever you'd like
• upscaler support for final output images
• saves your preferences/imported images to browser localstorage for maximum convenience
• reset to defaults button to unsave your preferences if things go squirrely
• floating navigable undo/redo palette with ctrl+z/y keyboard shortcuts for additional maximum convenience and desquirreliness
• all this and much more for the low, low price of simply already owning an expensive GPU!

operation

prerequisities

you'll obviously need A1111's webUI installed before you can use this, thus you're presumed to have an operational python install up and running to boot.

A1111 webUI must be launched with the --api flag enabled, and the --cors-allow-origins= flag set with the host where openOutpaint will be running.

NOTE: the commandline flag --gradio-debug disables custom API routes and completely breaks openOutpaint. please remove it from your COMMANDLINE_ARGS before running openOutpaint.

surprising incompatibilities

If anything goes wrong with openOutpaint, try running it on another browser and disable all extensions and try again. If a new incompatible extension is found, please open an issue so we can notify other users of extension incompatibilities.

• microsoft editor extension for chrome/edge seems to disable the overmask slider
• duckduckgo privacy extension for firefox breaks outpainting, resulting in pure black output - add an exception for your openOutpaint host (likely localhost or 127.0.0.1)
• same for dark reader

quickstart speedrun

1. edit your cors-allow-origins to include https://zero01101.github.io and run webUI
2. go to https://zero01101.github.io/openOutpaint/ and fill in the host value with your webUI API address
3. click things and do stuff

step-by-step actually useful instructions

please see the quickstart wiki article and comprehensive manual.

pull requests/bug reports

please do! see contributing for details!

warranty

lmao