1. Prerequisites
- Your computer needs to run Windows 10 or higher. Perhaps ZTX37 might also work on earlier versions. We didn't test that, but ZTX37 doesn't do anything wild, so that might just work.
- You need to have the dot net 8 framework installed on your computer. Any reasonable modern up-to-date computer will have this. If not, Windows will notice and help you getting it installed. You can download the .Net 8 desktop runtime separately from Microsoft. In case you don't know if you have dot net 8, assume you do.
- You need to have a working version of
Automatic1111
installed on your computer. Thus a screen as shown here to the right looks familiar to you. In case you don't have,
here is an installation guide. Make sure you can generate images with it.
.
2. Get ZTX37
The installer is straightforward, allowing you to choose to install it for one user or all users, create a shortcut, and select the installation folder.
If you already have ZTX37 installed and want to update to the latest version, the installer will detect the existing installation and perform the update.
Please note that both the installer and ZTX37 are unsigned, so Windows
will display some warning messages. I apologize for this inconvenience. Obtaining a digital signature is quite costly, and I haven’t been able to prioritize it yet. If you would like to support this effort, please consider making a
donation to help overcome this hurdle.
.
3. Config A1111
ZTX37 uses Automatic1111 for generating its images. Automatic1111 has an API through which ZTX37 can communicate with it. This will only work if you enable that API.
For doing so you must edit the file webui-user.bat. This file contains a line with COMMANDLINE_ARGS, looking like this:
set COMMANDLINE_ARGS=--xformers --no-half-vae
Leave this line as you found it, with one argument added,
--api
Thus than the example line looks like this:
set COMMANDLINE_ARGS=--xformers --no-half-vae --api
If you have Automatic1111 running, restart it, and you are done.
.
4. Done!
You can now start working with ZTX37.
ZTX37 can run independent from Automatic1111, but it won't generate any images if Automatic1111 isn't running.
Thus normally you need to start both Automatic1111 and ZTX37.
.
5. Ini File
Normally you would not be busy with the ZTX37.Ini file, but I explain it here, for those with special needs.
For those new to ZTX37, or not used to edit Ini files, Ignore this:
ZTX37 does store its information, among which generated images, in its data file. This file can become pretty big. It is located in %appdata%\ztx37.
This database can become pretty big. Think about gigabytes when keeping 1000's of images in it.
You can specify a different location. For that find ZTX37.ini and follow the instructions in that file.
ZTX37.Ini can also come in handy for those who want two copies of ZTX37 running on their computer. This can be done following these two steps:
- Copy all files from the installation folder to a different folder
- In the new folder specify a different database location in ZTX37.ini
.
Troubles?
It doesn't generate images!
You do have Automatic1111 running, with the --api command line parameter?
ZTX37 by default connects to the default URL of Automatic1111. Click the A1111 button in ZTX37 to check if that opens the Automatic1111 user interface. If you have configured Automatic1111 to use a different URL, go to the System tab in ZTX37 and provide that URL.
Clicking that button tests that you have Automatic1111 running and ZTX37 has the correct URL. It does not test if the --api command line argument is present. But if the button shows Automatic1111 and you still can't generate images, than, the only remaining cause can be a missing --api argument.
All I get is an error message on startup
A nerdy message about objects, pointers, references or any like that? Your PC might not have dot net 8 installed or ZTX37 is in a folder where it can't write its data.
It looks complicated
Oh! And we tried so hard making it look simple. Installation with its commandline arguments can be a challenge, making perfect prompts can be too, but using this software should be not.
Take the quick tour!
And join us on discord, where we all help each other.
.
