Lobe Theme
The modern theme for stable diffusion webui
Legacy verison a.k.a kitchen theme
English · [简体中文](./README-zh_CN.md) · [Changelog](./CHANGELOG.md) · [Report Bug][issues-url] · [Request Feature][issues-url]
[![release][release-shield]][release-url]
[![releaseDate][release-date-shield]][release-date-url]
[![ciTest][ci-test-shield]][ci-test-url]
[![ciRelease][ci-release-shield]][ci-release-url]
[![contributors][contributors-shield]][contributors-url]
[![forks][forks-shield]][forks-url]
[![stargazers][stargazers-shield]][stargazers-url]
[![issues][issues-shield]][issues-url]
> 📦 After **Version 2.0.0** Kitchen theme was renamed to **Lobe Theme**. The legacy version can be accessed at [sd-webui-kitchen-theme-legacy](https://github.com/canisminor1990/sd-webui-kitchen-theme-legacy)
Table of contents
#### TOC
- [✨ Features](#-features)
- [📦 Installation](#-installation)
- [🤯 Usage](#-usage)
- [🖥 Environment Support](#-environment-support)
- [⌨️ Local Development](#️-local-development)
- [🤝 Contributing](#-contributing)
- [🔗 Credits](#-credits)
####
## ✨ Features
- [x] 🌗 Supports light and dark themes, with the ability to quickly switch in the navigation bar
- [x] 🌈 Supports custom theme colors and neutral colors, with the option to customize the logo
- [x] 🪄 Supports one-click formatting of the prompt, with a simple tag editor provided
- [x] 🎛️ Highly customizable sidebar, with a quick settings sidebar on the left and a model sidebar on the right
- [x] 🖼️ Adjustable canvas ratio, ensuring that generated images are always displayed at the top
- [x] 📱 Mobile-friendly, with partial optimization for mobile screens
- [ ] 📝 Syntax highlighting in the prompt input box
- [ ] 🆗 Multilingual support with i18n
[![][back-to-top]](#readme-top)
## 📦 Installation
#### Method 1
Search for `Lobe Theme` or `Kitchen Theme` in the stable diffusion webui plugin market and install it.
> 👉 Note: **Version 2.0.0** was renamed to **Lobe Theme**
#### Method 2
As an extension (recommended), clone the repository to your extension folder:
```shell
git clone "https://github.com/canisminor1990/sd-webui-lobe-theme" extensions/lobe-theme
```
> 👉 Note: minimum requirements gradio-3.23.0 & sd-webui [4c1ad74](https://github.com/AUTOMATIC1111/stable-diffusion-webui/commit/4c1ad743e3baf1246db0711aa0107debf036a12b)
[![][back-to-top]](#readme-top)
## 🤯 Usage
#### Light and Dark Themes
> 👉 Tip: You can quickly switch between light and dark themes in the upper-right corner of the navigation bar.
The current theme supports both light and dark themes. If you want to force dark mode, use the `--theme=dark` argument to launch your WebUI. For example, on Windows, your `webui-user.bat` should include:
```shell
set COMMANDLINE_ARGS= --theme=dark
```
Alternatively, you can switch directly through URL Props:
```shell
http://localhost:7860/?__theme=light
http://localhost:7860/?__theme=dark
```
[![][back-to-top]](#readme-top)
#### Theme Customization
> 👉 Tip: Click the `⚙` icon in the upper-right corner to open the settings panel. The current available settings are as follows:
- **Theme**
- Primary color: Currently offers `13` theme color combinations
- Neutral color: Currently offers `6` different grayscale color combinations
- Logo type: `Lobe`, `Kitchen`, `Custom`
- Custom logo: Supports `img url`, `base64`, and `emoji`. When a single emoji is entered, it will be automatically replaced with 3D Fluent Emoji.
- Custom title: Customize the site name.
[![][back-to-top]](#readme-top)
#### Sidebar Customization
> 👉 Tip: Click the `⚙` icon in the upper-right corner to open the settings panel. The current available settings are as follows:
- **Prompt Textarea**
- Display mode: `scroll fixed height` | `resizable by text lines`
- **Sidebar**
- Default expand: `true`
- Display mode: `fixed` | `float`
- Default width: `280`
- **ExtraNetwork Sidebar**
- Enable: `true`
- Default expand: `true`
- Display mode: `fixed` | `float`
- Default width: `340`
- Default card size: `86`
Recommended System Settings
#### Extra-Networks
- thumbs
- width: 86
- height: 128
#### Quick-Setting
```txt
sd_model_checkpoint, sd_vae, CLIP_stop_at_last_layers, img2img_background_color, img2img_color_correction, samples_save, samples_format, grid_save, return_grid, n_rows, live_previews_enable, show_progress_every_n_steps, live_preview_refresh_period
```
[![][back-to-top]](#readme-top)
#### Mobile Adaptation
Partial convenience adaptation design has been completed for mobile devices, including breadcrumb foldable navigation bar, sidebar adaptation, etc. However, due to the high complexity and fixed values of the stable diffusion interface, it is difficult to ensure the same user experience as the desktop version. Feedback is welcome for more ideas.
[![][back-to-top]](#readme-top)
#### Prompt formatting
Click the 🪄 button below Prompt to format the prompt words with one click.
> 👉 Tip: Convert full-width punctuation to half-width, remove extra spaces, add missing commas, and move the Extra-Networks model to the end.
Before formatting:
```text
photorealistic photo of a handsome male (wizard :1.2）， short beard, white wizard shirt, (with golden trim:0.8),
```
After formatting:
```text
photorealistic photo of a handsome male, (wizard:1.2), short beard, white wizard shirt, (with golden trim:0.8), ,
```
[![][back-to-top]](#readme-top)
## 🖥 Environment Support
| [
](http://godban.github.io/browsers-support-badges/)
Chrome | [
](http://godban.github.io/browsers-support-badges/)
Edge | [
](http://godban.github.io/browsers-support-badges/)
Safari |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| last 2 versions | last 2 versions | last 2 versions |
> ⚠️ There is currently a known compatibility issue with styles on Firefox browser.
[![][back-to-top]](#readme-top)
## ⌨️ Local Development
You can use Gitpod for online development:
[][gitpod-url]
Alternatively, you can clone it for local development. To enable hot-reloading mode, you need to start stable diffuison on port `7860` in advance.
```bash
$ git clone https://github.com/canisminor1990/sd-webui-lobe-theme.git
$ cd sd-webui-lobe-theme
$ npm install
$ npm start
```
[![][back-to-top]](#readme-top)
## 🤝 Contributing
> 📊 Total: **7**
[![][back-to-top]](#readme-top)
## 🔗 Credits
- stable-diffusion-webui：
- gradio-theme-gallery:
- cozy-nest:
- _before `1.0.0` version_
- sd-web-ui-quickcs:
- Dark-Themes-SD-WebUI-Automatic1111:
[![][back-to-top]](#readme-top)
---
#### 📝 License
Copyright © 2023 [CanisMinor][profile-url].
This project is [MIT](./LICENSE) licensed.
[profile-url]: https://github.com/canisminor1990
[gitpod-url]: https://gitpod.io/#https://github.com/canisminor1990/sd-webui-lobe-theme
[back-to-top]: https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square
[release-shield]: https://img.shields.io/github/v/release/canisminor1990/sd-webui-lobe-theme?style=flat&sort=semver&logo=github
[release-url]: https://github.com/canisminor1990/sd-webui-lobe-theme/releases
[release-date-shield]: https://img.shields.io/github/release-date/canisminor1990/sd-webui-lobe-theme?style=flat
[release-date-url]: https://github.com/canisminor1990/sd-webui-lobe-theme/releases
[ci-test-shield]: https://github.com/canisminor1990/sd-webui-lobe-theme/workflows/Test%20CI/badge.svg
[ci-test-url]: https://github.com/canisminor1990/sd-webui-lobe-theme/actions/workflows/test.yml
[ci-release-shield]: https://github.com/canisminor1990/sd-webui-lobe-theme/workflows/Build%20and%20Release/badge.svg
[ci-release-url]: https://github.com/canisminor1990/sd-webui-lobe-theme/actions/workflows/release.yml
[contributors-shield]: https://img.shields.io/github/contributors/canisminor1990/sd-webui-lobe-theme.svg?style=flat
[contributors-url]: https://github.com/canisminor1990/sd-webui-lobe-theme/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/canisminor1990/sd-webui-lobe-theme.svg?style=flat
[forks-url]: https://github.com/canisminor1990/sd-webui-lobe-theme/network/members
[stargazers-shield]: https://img.shields.io/github/stars/canisminor1990/sd-webui-lobe-theme.svg?style=flat
[stargazers-url]: https://github.com/canisminor1990/sd-webui-lobe-theme/stargazers
[issues-shield]: https://img.shields.io/github/issues/canisminor1990/sd-webui-lobe-theme.svg?style=flat
[issues-url]: https://github.com/canisminor1990/sd-webui-lobe-theme/issues/new/choose