Merge branch 'amnweb:main' into center_label

Author: pitchaya-s

.github/workflows/windows-dev.yaml

@@ -17,7 +17,7 @@ permissions:
   contents: read
 
 env:
-  PYTHON_VERSION: '3.12'
+  PYTHON_VERSION: '3.14'
 
 jobs:
   build:
@@ -74,7 +74,7 @@ jobs:
         .\venv\Scripts\Activate
         python -m pip install --upgrade pip
         pip install --force --no-cache .
-        pip install --force --no-cache --upgrade cx_Freeze==7.2.10
+        pip install --extra-index-url https://test.pypi.org/simple/ cx_Freeze --pre --no-cache
       shell: pwsh
 
     - name: Build EXE

.github/workflows/windows.yaml

@@ -7,7 +7,7 @@ permissions:
   contents: read
 
 env:
-  PYTHON_VERSION: '3.12'
+  PYTHON_VERSION: '3.14'
 
 jobs:
   build:
@@ -36,7 +36,7 @@ jobs:
         .\venv\Scripts\Activate
         python -m pip install --upgrade pip
         pip install --force --no-cache .
-        pip install --force --no-cache --upgrade cx_Freeze==7.2.10
+        pip install --force --no-cache --upgrade cx_Freeze
       shell: pwsh
 
     - name: Build EXE

docs/Configuration.md

@@ -28,9 +28,6 @@ YASB_WEATHER_LOCATION=your_location_here
 # Some Qt settings
 QT_SCREEN_SCALE_FACTORS="1.25;1"
 QT_SCALE_FACTOR_ROUNDING_POLICY="PassThrough"
-# OpenGL settings, Use "desktop" for hardware acceleration, "software" for software rendering
-QT_OPENGL="desktop" 
-QT_OPENGL="software"
 ```
 
 ## YASB Font Engine
@@ -79,12 +76,15 @@ Valid options are:
 | `alignment`       | object  | [See below](#bar-alignment) | The alignment settings for the status bar. |
 | `blur_effect`     | object  | [See below](#blur-effect-configuration) | The blur effect settings for the status bar. |
 | `window_flags`    | object  | [See below](#window-flags-configuration) | The window flags for the status bar. |
-| `dimensions`      | object  | `{width: "100%", height: 36}` | The dimensions of the status bar. |
+| `dimensions`      | object  | `{width: "100%", height: 36}` | The dimensions of the status bar. Width can be a number (pixels), percentage string (e.g., `"100%"`, `"50%"`), or `"auto"` to resize based on content. When using `"auto"`, the bar will automatically resize as widget content changes, with a maximum width of the available screen width minus padding. |
 | `padding`         | object  | `{top: 4, left: 0, bottom: 4, right: 0}` | The padding for the status bar. |
 | `animation`       | object  | `{enabled: true, duration: 500}` | The animation settings for the status bar. Duration is in milliseconds. Animation is used to show/hide the bar smoothly. |
 | `widgets`         | list  | `left[], center[], right[]` | Active widgets and position. |
 | `layouts`         | object  | [See below](#layouts-configuration) | Configuration for widget layouts in each section (left, center, right). |
 
+> **note:**
+> Setting the width to `"auto"` is not recommended for widgets that constantly update data, such as CPU, memory, clock, etc. This can cause the bar to constantly resize, which may lead to flickering or performance issues.
+
 > **Note:**
 > `screens` can be specified as a list of monitor names. If you want the bar to appear on all screens, use `['*']`. To specify a single screen, use `['DELL P2419H (1)']` or a similar name based on your monitor setup. To show the bar only and always on the primary screen, use `['primary']`.
 
@@ -139,7 +139,7 @@ layouts:
 
 # Multiple Bars Example
 > **Note:**
-> If you want to have different bars on each screen you will need to define on which screen the bar should be displayed, `screens` inside bar config is your monitor name. You can find your monitor name inside device manager or click on YASB tray icon and select Debug > Information to show all available screens.
+> If you want to have different bars on each screen you will need to define on which screen the bar should be displayed, `screens` inside bar config is your monitor name. You can find your monitor names using `yasbc monitor-information` or inside device manager.
 
 ```
 bars:

docs/Installation.md

@@ -10,23 +10,31 @@
 
 ### Winget
 Install YASB using [winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/):
-```
+```powershell
 winget install --id AmN.yasb
 ```
 
 ***
 
 ### Scoop
 Install YASB using [Scoop](https://scoop.sh/):
-```
+```powershell
 scoop bucket add extras
 scoop install extras/yasb
 ```
 
 ***
 
+### Chocolatey
+Install YASB using [Chocolatey](https://chocolatey.org/):
+```powershell
+choco install yasb
+```
+
+***
+
 ### Using Python
-- Install Python 3.12
+- Install Python >= 3.12
 - Install the application and its dependencies:
   - `pip install .` (for regular installation)
   - `pip install -e .[dev]` (for development installation)
@@ -36,4 +44,13 @@ scoop install extras/yasb
   - run `python src/main.py` in your terminal (or click [yasb.vbs](https://github.com/amnweb/yasb/blob/main/src/yasb.vbs))
 
 
-
+### Build from source
+- Clone the repository: `git clone https://github.com/amnweb/yasb`
+- Navigate to the project directory: `cd yasb`
+- Install the required dependencies: `pip install -e .[dev]`
+- Navigate to the `src` directory: `cd src`
+- Build the installer using following command:
+```powershell
+python build.py build
+python build.py bdist_msi
+```

docs/assets/119849t2-ty6f89d1-as5e-9982-t6d7ddbdda70.png

@@ -19,11 +19,11 @@ power_menu:
   type: "yasb.power_menu.PowerMenuWidget"
   options:
     label: "\uf011"
-    uptime: True
-    blur: False
-    blur_background: True
-    animation_duration: 300 # Milliseconds
-    button_row: 3 # Number of buttons in a row, min 1 max 5
+    uptime: true
+    blur: false
+    blur_background: true
+    animation_duration: 200 # Milliseconds
+    button_row: 5 # Number of buttons in a row, min 1 max 5
     buttons:
       lock: ["\uea75", "Lock"]
       sleep: ["\u23fe","Sleep"]
@@ -33,7 +33,7 @@ power_menu:
       hibernate: ["\uf28e", "Hibernate"]
       cancel: ["\udb81\udf3a", "Cancel"]
     label_shadow:
-      enabled: true
+      enabled: false
       color: "black"
       radius: 3
       offset: [ 1, 1 ]
@@ -50,7 +50,7 @@ power_menu:
 - **container_shadow:** Container shadow options.
 - **label_shadow:** Label shadow options.
 
-## Example Style
+## Available Styles
 ```css
 .uptime {}
 .power-menu-widget .label { /*icon on the bar*/ }
@@ -69,6 +69,66 @@ power_menu:
 .power-menu-popup .button.force_shutdown {}
 .power-menu-popup .button.force_restart {}
 
+```
+## Example Styles
+```css
+.power-menu-widget .label {
+    color: #f38ba8;
+    font-size: 13px;
+}
+.power-menu-popup {
+    background-color: transparent
+}
+.power-menu-popup .button {
+    padding: 0;
+    width: 180px;
+    height: 230px;
+    border-radius: 8px;
+    background-color: #191919;
+    border: 4px solid transparent;
+    margin: 0px;
+}
+.power-menu-popup .button.hover {
+    background-color: #1d1d1d;
+    border: 4px solid #1d1d1d;
+}
+.power-menu-popup .button .label {
+    margin-bottom: 8px;
+    font-size: 16px;
+    font-weight: 500;
+    color: #9399b2
+}
+.power-menu-popup .button .icon {
+    font-size: 64px;
+    padding-top: 32px;
+    color: #7f849c
+}
+.power-menu-popup .button.hover .label,
+.power-menu-popup .button.hover .icon {
+    color: rgba(255, 255, 255, 0.808)
+}
+.power-menu-popup .button.cancel .icon {
+    padding: 0;
+    margin: 0;
+    max-height: 0;
+}
+.power-menu-popup .button.cancel .label {
+    color:  #f38ba8;
+    margin: 0;
+}
+.power-menu-popup .button.cancel {
+    height: 40px;
+    border-radius: 4px;
+}
+.power-menu-popup .button.cancel.hover .label {
+    color: rgb(255, 255, 255)
+}
+.uptime {
+    font-size: 14px;
+    margin-bottom: 10px;
+    color: #7f849c;
+    font-weight: 600;
+}
 ```
 
 > [!NOTE]

docs/widgets/(Widget)-Power-Menu.md

@@ -9,7 +9,7 @@
 | `title_label`       | dict    | `{'enabled': False, 'show': 'focused', 'min_length': 10, 'max_length': 30}`                     | Title label configuration for displaying window titles.                     |
 | `monitor_exclusive` | boolean | `False` | Whether the application should be exclusive to the monitor. |
 | `hide_empty`        | boolean | `False` | Whether to hide the taskbar widget when there are no applications to display. |
-| `callbacks`         | dict    | `{'on_left': 'toggle_window', 'on_middle': 'do_nothing', 'on_right': 'close_app'}` | Callbacks for mouse events on the widget.                                   |
+| `callbacks`         | dict    | `{'on_left': 'toggle_window', 'on_middle': 'do_nothing', 'on_right': 'context_menu'}` | Callbacks for mouse events on the widget.                                   |
 | `animation`         | dict    | `{'enabled': True, 'type': 'fadeInOut', 'duration': 200}`               | Animation settings for the widget.                                          |
 | `preview`           | dict    | `{'enabled': False, 'width': 240, 'delay': 400, 'padding': 8, 'margin': 8}` | Configuration for window preview thumbnails.                                |
 
@@ -60,7 +60,7 @@ taskbar:
   - titles: A list of window titles to ignore.
   - classes: A list of window classes to ignore.
 - **hide_empty:** A boolean indicating whether to hide the taskbar widget when there are no applications to display. If set to `True`, the taskbar will automatically hide itself when there are no open applications that meet the filtering criteria.
-- **callbacks:** A dictionary specifying the callbacks for mouse events. The keys are `on_left`, `on_middle`, and `on_right`, and the values are the names of the callback functions, which can be `toggle_window`, `do_nothing`, or `close_app`.
+- **callbacks:** A dictionary specifying the callbacks for mouse events. The keys are `on_left`, `on_middle`, and `on_right`, and the values are the names of the callback functions, which can be `toggle_window`, `do_nothing`, `close_app` or `context_menu`.
 - **animation:** A dictionary specifying the animation settings for the widget. It contains three keys: `enabled`, `type`, and `duration`. The `type` can be `fadeInOut` and the `duration` is the animation duration in milliseconds. When animation is enabled, it will be used both for click effects and for animating the addition or removal of applications in the taskbar (such as when apps are opened or closed).
 - **preview:** A dictionary specifying the configuration for window preview thumbnails. It includes:
   - enabled: A boolean flag to enable or disable window previews.
@@ -80,6 +80,7 @@ taskbar:
 .taskbar-widget .app-container {} /* container for each app */
 .taskbar-widget .app-container.foreground {} /* container for the focused app */
 .taskbar-widget .app-container.flashing {} /* flashing container for the app (window is flashing) */
+.taskbar-widget .app-container.running {} /* container for running apps (not focused) */
 .taskbar-widget .app-container .app-icon {} /* Icon inside the container */
 .taskbar-widget .app-container .app-title {} /* Label inside the container */
 /* Taskbar preview popup is very limited in styling options, do not use margins/paddings here */