Skip to content

makuralymi/dsh-webUI-Glass-Theme

30Last commit Aug 13, 2026

dsh-webUI-Glass-Theme DSH plugin

This plugin adds a full iOS/macOS-style frosted-glass look to the dsh Web UI by overlaying translucent surface tokens and a global backdrop-filter. It also introduces a new 'Transition & schedule' section in Settings → General, allowing you to choose switch animations (fade, circle reveal, wipe from top), set daily scheduled light/dark times, and use a custom background image (URL or local file).

How to install the dsh-webUI-Glass-Theme DSH plugin

dsh plugin --profile web add ./dsh-webUI-Glass-Theme

Copying does not run this command. Review the repository and version before installing the dsh-webUI-Glass-Theme DSH plugin.

dsh-webUI-Glass-Theme DSH plugin data source

dsh-webUI-Glass-Theme DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-webUI-Glass-Theme DSH plugin can do

  • Applies a global backdrop-filter blur and saturate to the shell frame and floating surfaces, creating a frosted-glass effect.
  • Overrides surface-background tokens (--dsw-alias-bg-*, etc.) with translucent rgba values, class-name agnostic.
  • Provides full-screen theme-switch animations using the View Transition API: fade, circle reveal, or wipe from top.
  • Allows scheduling daily dark-theme and light-theme times, with automatic switching and manual override until next boundary.
  • Supports custom background image via URL or local file upload, with reset to built-in background.

Where the dsh-webUI-Glass-Theme DSH plugin fits

  • Give the dsh Web UI a modern, translucent aesthetic similar to macOS or iOS.
  • Automatically switch between light and dark themes at user-defined times throughout the day.
  • Use animated transitions to make theme changes visually smooth and engaging.
  • Set a custom background image to personalize the UI beyond the default frosted background.
  • Demonstrate dsh's plugin system with a purely client-side UI enhancement.

Who the dsh-webUI-Glass-Theme DSH plugin is for

  • dsh users who want to visually enhance the Web UI with a frosted-glass effect.
  • Users who prefer automated theme switching based on time of day or custom schedules.
  • Developers looking for a reference implementation of a client-side dsh plugin with bundle patches and settings integration.

dsh-webUI-Glass-Theme DSH plugin limitations

  • The backdrop-filter for the shell frame and composer-card relies on stable data-* attributes rather than hashed module classes, which may break if the dsh UI structure changes.
  • Third-party theme token overrides are applied at runtime without completeness validation; only surface-background tokens are overridden, leaving text and state tokens readable.
  • The plugin requires a restart of the web process after installation or removal to take effect.

dsh-webUI-Glass-Theme DSH plugin: from the repository README

Quoted from the makuralymi/dsh-webUI-Glass-Theme README, the upstream source of the dsh-webUI-Glass-Theme DSH plugin. Copyright remains with the original authors.

A **global frosted-glass (backdrop blur) theme plugin** for the dsh Web UI. It keeps the existing light/dark preference untouched and layers a translucent surface-token override plus a global `backdrop-filter` on top, giving the whole UI an iOS/macOS-style frosted-glass look. The plugin also adds a **Transition & schedule** row right below **Appearance** in Settings → General: - **Switch animation**: None / Fade / Circle reveal / Wipe from top — full-screen transitions when light/dark is switched. - **Scheduled switching**: set a daily dark-theme time and light-theme time; the UI switches automatically at those boundaries, and manual switches last until the next boundary. - **Custom background**: enter an image URL or choose a local image (auto-compressed and stored browser-locally), with one-click reset to the built-in background. ## Screenshot ![Frosted glass screenshot](assets/sc.png) ## What it does Two browser-side halves: 1. **Global stylesheet** (inlined by `lib/client.js`) - Paints `bg.jpeg` as a centered, cover background on `body` (inlined as base64; source kept at `assets/bg.jpeg`), shown as-is in light mode and dimmed behind a translucent dark veil in dark mod

Read the full READMEThe repository declares no license. Check with the authors before using it.

dsh-webUI-Glass-Theme DSH plugin questions

How do I install the frosted-glass theme plugin?

Clone the repository, then run 'dsh plugin --profile web add ./dsh-webUI-Glass-Theme' in your dsh environment. This will automatically add the plugin and its bundle patch. Restart the web process (e.g., 'dsh --profile web' or 'dsh web') for the changes to take effect.

How do I customize the blur intensity?

Edit the variables '--frosted-blur' (default 20px) and '--frosted-saturate' (default 180%) in the 'lib/client.js' file of the plugin. After changing, restart the web process to apply the new values.

Can I use my own image as the background?

Yes. In Settings → General → Transition & schedule, you can enter an image URL or choose a local image. The plugin will compress and store the image locally (in localStorage), and it will be used as the background. To reset to the built-in background, click the 'Reset to default' button.

How do I disable the scheduled theme switching?

Go to Settings → General → Transition & schedule and uncheck the 'Enable scheduled switching' option. The manual light/dark toggle will then work without any automatic changes.

Does the plugin work with the dsh mobile app?

The plugin is designed for the dsh Web UI in a browser. For mobile browsers, the backdrop-filter and animations should work, but the layout and touch interactions may not be fully optimized. Test on your target device.