Skip to content

Run WebUI most easily on Mac OS. Crafted with a beautiful UI by graphic designer.

License

Notifications You must be signed in to change notification settings

xtower-studio/WebUI-Launcher

Repository files navigation

Github

WebUI Launcher for macOS

The most elegant way to launch AUTOMATIC1111's Stable Diffusion WebUI on your Mac.

Say goodbye to the command line. WebUI Launcher is a lightweight, native macOS application that provides a seamless, one-click experience to start the WebUI. Launch it instantly from Spotlight, the Dock, or your Desktop, just like any other app.

Platform: macOS Language: Swift Latest Release


Why WebUI Launcher?

If you've ever felt that opening Terminal, navigating to a directory, and running a script felt like a clumsy interruption to your creative workflow, this app is for you. We've replaced that friction with a beautifully designed, native macOS experience.

Key Features

  • Elegant & Intuitive UIe UI: Crafted by a graphic designer, this app is built with meticulous attention to detail. It's not just functional; it's a pleasure to use.
  • 🚀 Instant Launch: Access the WebUI instantly via Spotlight (⌘ + Space), the Dock, or Launchpad. No more terminal commands.
  • natively written in 100% Swift & SwiftUIftUI, ensuring optimal performance, low resource usage, and a look and feel that's perfectly at home on macOS.
  • 🔗 Seamless Integration: The launcher simply executes your existing webui.sh file. Any custom arguments or modifications you've made will work out of the box.
  • 💡 Simple, One-Time Setup: Point the app to your stable-diffusion-webui directory on the first launch, and you're all set.

Security & Trustrust

Your security is paramount. We understand that running a new application requires trust, which is why WebUI Launcher has been built to meet Apple's rigorous security standards.

✅ Apple Notarized & Developer ID Signedgned

This application is officially signed with an Apple Developer ID registered to xtower studio and has been notarized by Apple.

When you open WebUI Launcher for the first time, you will see a confirmation from macOS that "Apple checked it for malicious software," instead of the common "unidentified developer" warning. You can run this app with complete peace of mind.

Prerequisites

This application does not include AUTOMATIC1111's stable-diffusion-webui. You must have it installed and working on your machine already.

Installation

The easiest way to get started is by downloading the latest release from the Releases page.

  1. Go to the Releases section.
  2. Download the latest .dmg file.
  3. Open the .dmg file and drag WebUI Launcher.app into your Applications folder.

Getting Started

  1. Launch the App: Open WebUI Launcher for the first time.
  2. Select Your Directory: You'll be prompted to locate your stable-diffusion-webui folder. Select the root folder that contains the webui.sh file.
  3. Done!: The app will now launch your WebUI. From now on, simply opening the app will start the WebUI directly.

Your terminal window will open automatically to show the startup progress, just as it would if you ran the script manually.

How It Works

WebUI Launcher is a simple yet powerful wrapper. When you open the app, it executes the webui.sh script located within the directory you specified during setup. This approach ensures maximum compatibility with your existing setup and any custom launch arguments you've configured within the script itself.

Contributing & Feedbackback

This project is complete but currently in a testing phase. Your feedback is invaluable! If you encounter any bugs, have a feature suggestion, or want to contribute to the code, please feel free to:

  • Open an Issue to report a bug or request a feature.
  • Fork the repository and submit a Pull Request.

License

This project is comprised of two parts with different licenses: the source code and the design assets.

Source Code

The source code is licensed under the MIT License. This means you are free to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the software. It is completely open-source and can be used for commercial purposes without restriction. See the LICENSE file for full details.

Design & Brand Assetssets

All design and brand assets, including but not limited to the application icon, logo, banner, and overall user interface design, are licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License (CC BY-NC-ND 4.0).

xtower_studio_logo

Copyright ©2025 xtower studio.

This license allows you to copy and distribute the material in any medium or format in unadapted form for non-commercial purposes only, provided you give appropriate credit to xtower studio. See the LICENSE file for full details.


Made with ❤️ for the macOS and Stable Diffusion communities.

About

Run WebUI most easily on Mac OS. Crafted with a beautiful UI by graphic designer.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages