UI Overview

PyBreeze provides a tabbed, dock-based interface built on PySide6 (Qt for Python). The main window is composed of several key areas.

Main Window Layout

Menu Bar

Located at the top of the window. Contains all menus for file operations, code execution, automation modules, tool installation, SSH, AI tools, plugins, and more.

The menu bar includes these top-level menus (from left to right):

• File – Open, save files, and set encoding

• Run – Execute code, run on shell, stop programs

• Text – Font and font size settings

• Check Code Style – Code formatting tools (yapf, JSON)

• Venv – Virtual environment management

• UI Style – Theme switching

• Automation – All automation module menus (AutoControl, APITestka, WebRunner, etc.)

• Install – Install automation packages and build tools

• Tools – SSH client, AI tools, diagram editor

• Plugins – Plugin browser and loaded plugins

• Run With – Run files with different compilers/interpreters

File Tree

Located on the left side of the window. Provides a file browser for navigating your project directory. You can:

• Browse files and folders

• Double-click to open files in the editor

• Right-click any file or folder to access the context menu (see below)

File Tree Context Menu

Right-clicking the file tree opens a context menu with the following actions:

Action	Description
New File	Prompts for a name and creates an empty file in the clicked directory (or the directory containing the clicked file).
New Folder	Prompts for a name and creates a new directory.
Rename	Renames the selected file or folder. If the file is currently open in an editor tab, the tab title and the editor’s stored path are updated to match.
Delete	Deletes the selected file or folder after a confirmation dialog. If the file is open in an editor tab, the tab is closed first.
Copy Path	Copies the absolute path of the selected item to the clipboard.
Copy Relative Path	Copies the path relative to the file tree’s root directory.
Reveal in Explorer	Opens the selected item’s containing folder in the platform file manager (Explorer on Windows, Finder on macOS, xdg-open on Linux).

Code Editor (Tab Widget)

The central area uses a tabbed interface. Each opened file gets its own tab. Additional tool tabs (SSH, AI, JupyterLab, automation GUIs) can also be opened here.

Features:

• Syntax highlighting for Python and automation module keywords

• Multiple file editing with tabs

• Extendable with custom tabs via EDITOR_EXTEND_TAB

Output Panel

Located at the bottom of the window. Displays:

• Program execution output

• Shell command results

• Error messages

Code Output Window

When running automation scripts, a separate Code Output Window opens to display the execution results. This window:

• Shows real-time output from subprocess execution

• Is read-only

• Sizes itself based on screen dimensions

• Can be closed independently of the main window

Dock Widgets

Several tools can be opened as dock widgets instead of tabs, allowing you to arrange them freely around the main window:

• SSH Client Dock

• AI Code-Review Dock

• CoT Prompt Editor Dock

• Skill Prompt Editor Dock

• Skill Send GUI Dock

• Diagram Editor Dock

Dock widgets can be dragged, resized, and snapped to any edge of the main window.

Theme System

PyBreeze uses qt_material for theming. Available themes include:

• dark_amber.xml (default)

• dark_teal.xml

• dark_blue.xml

• dark_cyan.xml

• dark_lightgreen.xml

• dark_pink.xml

• dark_purple.xml

• dark_red.xml

• dark_yellow.xml

• light_amber.xml

• light_blue.xml

• light_cyan.xml

• light_lightgreen.xml

• light_pink.xml

• light_purple.xml

• light_red.xml

• light_yellow.xml

You can switch themes via the UI Style menu in the menu bar, or set the theme at launch time:

start_editor(theme="dark_teal.xml")

Multi-Language Support

PyBreeze supports multiple UI languages:

• English (default)

• Traditional Chinese (繁體中文)

• Additional languages can be added via plugins

All UI strings are managed through a centralized language dictionary that can be extended with custom translations.