ScreenMage

A tiny image-editing application that uses Mage-Flow-Edit-Turbo.

Currently, only Windows with NVIDIA GPUs are supported.

Usage

Windows

1. Download the latest release from Releases.

2. Extract the release archive.
   The extracted directory should look similar to this:

   ScreenMage/
   |-- ScreenMage.exe
   |-- ScreenMageBatch.exe
   |-- models/
   |   |-- qwen/qwen_encoder_int8.onnx
   |   |-- dit/mage_transformer_int8.onnx
   |   |-- vae/mage_vae_encoder.onnx
   |   |-- vae/mage_vae_decoder.onnx
   |   `-- qwen3vl_4b/
   `-- *.dll
   

GUI

3. Double-click ScreenMage.exe to launch the GUI.

4. Select a region of the screen, then click [512], [1024], [1536], or [2048].

Notes

Loading the model can take a while, so grab a coffee while you wait for the first screen refresh.

The screen automatically refreshes whenever roughly 10% of the captured area changes. Placing the capture window over a video or other constantly moving content is an excellent way to turn your GPU into a space heater.

Batch Mode

3. Alternatively, run ScreenMageBatch.exe from the command line to process PNG images in batch mode.

4. The command-line syntax is as follows:

   ScreenMageBatch.exe --input DIR --output DIR --prompt TEXT [--size 512|1024|1536|2048] [--seed N] [--models-root DIR]
   

   Example:

   ScreenMageBatch.exe --input "input" --output "output" --prompt "Turn the images into watercolor paintings" --size 1024 --seed -1

   A negative seed generates a new random seed for each PNG image.

Other Platforms

If you are not using Windows, you will need to ask an LLM something like, "Please modify the code to support my PC."

Information

At least 8 GB of VRAM is required, while 16 GB is recommended.

The ScreenMage.exe included in the latest release is a fat binary that supports GPU architectures from sm_80 through sm_120.

Build Requirements

Building ScreenMage requires:

• Visual Studio
• CUDA Toolkit 13.3
• cuDNN 9.23 SDK

License

ScreenMage is licensed under the MIT License.
For information about third-party licenses, see NOTICE.