Seelen-UI README

The project's README from github.com/eythaann/Seelen-UI. As one markdown file: README.md.

Seelen UI Logo Seelen UI

Fully Customizable Desktop Environment for Windows
Available in 70+ Languages

Contributors Last Commit Version Downloads

Screenshot of Seelen UI desktop showing a customized desktop environment
Download Seelen UI from Microsoft Store Join the Seelen UI Discord community DigitalOcean Referral Badge

What is Seelen UI?

Seelen UI is a full desktop environment replacement for Windows — not a theme pack, not a skin, but a complete rethink of how your desktop looks and works. Every element you interact with daily — the taskbar, the dock, the app launcher, the window manager, the notification flyouts, the virtual desktops — can be replaced, restyled, and extended to exactly match your vision and workflow.

Whether you want a minimal, distraction-free setup or a feature-rich power-user environment, Seelen UI gives you the primitives to build it. With a CSS/JSON-based theming engine, a plugin widget system, and deep Windows integration, the only limit is your imagination.


Feature Showcase

Themes & Visual Identity

Make Windows look the way you always wanted. Seelen UI ships with a powerful theming engine that lets you craft or install community themes covering every surface of the shell — colors, fonts, borders, animations, and more.

Seelen UI Custom Theme


Dynamic Accent Color

Set your accent color once and forget it. Seelen UI analyzes your wallpaper in real time and automatically derives a harmonious accent color, keeping every shell element visually in sync with your background — no manual tweaking needed.

Dynamic accent example 1 Dynamic accent example 2
Dynamic accent example 3 Dynamic accent example 4

Tiling Window Manager

Stop dragging windows. Seelen UI's tiling window manager automatically arranges your open applications into efficient, gap-controlled layouts. Resize, swap, and navigate entirely from the keyboard — your hands never leave the keys.

Seelen UI Tiling Window Manager


Desktop Widgets

Bring information to your desktop without opening apps. Place clocks, system monitors, media controls, weather panels, and any custom widget directly on your wallpaper layer — fully theme-aware and always within sight.

Seelen UI Desktop Widgets


App Launcher

Launch anything instantly with a keyboard-driven launcher inspired by Rofi. Apps, files, shell commands, custom scripts — surfaced with fuzzy search in milliseconds.

Seelen UI App Launcher


Media Controls

Control your music without switching windows. The integrated media module works with virtually every player and lets you play, pause, skip, and scrub from any context, always accessible in the toolbar or as a dedicated widget.

Seelen UI Media Module


Settings

One unified place to configure everything. Themes, layouts, keybindings, widget positions, workspace rules, per-app overrides — all accessible through a clean, searchable settings interface with live preview.

Seelen UI Settings


Complete Feature List

Shell & Desktop

Feature Description
Custom Toolbar A fully themeable, widget-powered taskbar that replaces the Windows taskbar
Custom Dock macOS-style application dock with launch, focus, and badge support
Desktop Widgets Interactive widgets rendered directly on the desktop layer
Custom Flyouts Replace Windows' built-in volume, brightness, and system flyouts with themed, customizable panels
Start Menu Replacement Quick-access launcher replacing the native Start menu

Window Management

Feature Description
Tiling Window Manager Automatic tiling layouts: BSP, columns, stacks, and more
Custom Alt + Tab A fully skinnable task switcher with richer window previews
Per-App Rules Define layout, workspace, and floating behavior per application
Floating Mode Opt any window out of tiling while keeping the rest managed
Gaps & Padding Configurable inner and outer gaps for any layout

Workspaces

Feature Description
Custom Virtual Desktops Full virtual desktop implementation with smooth animated transitions
Workspaces Viewer A visual overview panel showing all workspaces and their content at a glance
Wallpaper per Workspace Assign a unique wallpaper to each workspace — changes automatically on switch
Workspace Rules Pin apps or app groups to specific workspaces on launch
Named Workspaces Give each workspace a custom name and icon

Theming & Appearance

Feature Description
CSS/JSON Theming Engine Style every shell element with scoped CSS and JSON configuration
Dynamic Accent Color Auto-extract accent color from the current wallpaper
Community Themes Install and share themes from the community
Per-Widget Theming Each widget can carry its own independent style
Dark / Light Mode Full support for Windows dark and light mode, themeable per-variant

Productivity

Feature Description
Keyboard-First Design Every feature reachable without touching the mouse
App Launcher Fuzzy-search launcher for apps, files, and commands
Media Module Universal media controls compatible with all major players
Multi-Monitor Support Independent configuration and layouts per connected display
i18n — 70+ Languages Fully localized interface covering major world languages

Developer & Power User

Feature Description
Widget SDK Build custom widgets with Svelte, TypeScript, and full IPC access to system state
Portable Config All configuration lives in plain files — version-control and sync friendly

Installation

[!CAUTION] Seelen UI requires the WebView runtime to be installed. On Windows 11, it comes pre-installed with the system. However, on Windows 10, the WebView runtime is included with the setup.exe installer. Additionally, Microsoft Edge is necessary to function correctly. Some users may have modified their system and removed Edge, so please ensure both Edge and the WebView runtime are installed on your system.

[!NOTE] On fresh installations of Windows, the app might show a white or dark screen. You only need to update your Windows through Windows Update and restart your PC.

All distribution channels ship signed packages — pick whichever fits your workflow best.

Microsoft Store

Download from the Microsoft Store for automatic updates managed by Windows. Updates go through Store review, so they may take 1–3 business days to appear after a release.

Winget

winget install --id Seelen.SeelenUI

Same signed .msix as the Store, installable from the terminal. Updates follow the same 1–3 business day review window via the winget-pkgs project.

GitHub Releases (.msix / .exe)

Download the latest installer directly from the Releases page. Both the .msix and .exe packages are signed. GitHub releases land immediately after a new version ships, ahead of Store and Winget. The .exe installer also delivers in-app update notifications.


Getting Started

Once installed, open Seelen UI and the settings interface will guide you through the initial setup. Enable the components you want — toolbar, dock, tiling manager, widgets — and start customizing from there. The official documentation and the Discord community are the best places to go deeper.


Contributing

We welcome contributions!

License

See the LICENSE file for details.

Contact

For inquiries and support, join us on Discord.

Sponsors

We're grateful for the support of our sponsors who help make Seelen UI possible.

Sponsor Description
DigitalOcean DigitalOcean provides cloud infrastructure services that power our development and testing environments.
SignPath SignPath provides free code signing certificates, ensuring secure and trusted releases for our users.

                 .      .&     _,x&"``
                  & .   &'  ;.&&'
            &.  . &.&     .0&&&;&""`
       .    '&  &.&&&  .&&&&&'
     .&         ;&&& &&&&&'
    &&          &&&&&&&&     &&&
   0&    .     &&&&&&&&""
  &&   .0     &&&&&&&
 0&& .&'     &&&&&&
:&&&&&    . &&&&& 
0&&&&    & &&&&&
&&&&'   &&&&&&&               .&&&x&
&&&&   :&&&&&0.&'        , .&&&&&&&&&&;.
&&&&.  &&&&&&&&        .&&&&&&&&&&'               .
0&&&&  &&&&&&&       ,&&&&&&&&&&&&                &
:&&&&; &&&&&0       ,;&&&&&&&&&&&             ;  .0
 0&&&&&&&&&&0     ,;&&&&&&&&&&&&&             &  &;
  0&&&&&&&&&&0   :',;".&&&&&&".&             && &0
   0&&&&&&&&&0  ',;',&&&&&" ,&'             &&&&0
    0&&&&&&&&&0 ,x&&&&" .&&&              &&&&0
      0&&&&&& .&&&&"'''"&&"&&            &&&&&0
       0&& .&&;``       `&: :&         &&&&&&0
          &"' &&&&&&&&   &"& &"&   &&&&&&&&0
            0&&&&&&&&&&&&&&&&&&&&&&&&&0
               0&&&&&&&&&&&&&&&&&&&0         Seelen
                    0&&&&&&&&&0

📌 Official Website: https://seelen.io

Seelen Inc © 2026 - All rights reserved

Seelen-UI (eythaann/Seelen-UI)

Searching Database…

18.1K ·GitHub
这是什么?Seelen UI 是一款面向 Windows 10/11 的完整桌面环境替代方案,你可以重新搭建任务栏、程序坞、应用启动器、窗口管理器、弹出面板和虚拟桌面,而不只是更换外观。
这只是个主题包,还是更深入的东西?它远不止换皮肤:每个外壳界面都可以通过 CSS/JSON 主题引擎和插件组件系统进行替换和重新设计,而不只是改颜色。
运行前需要先安装什么吗?需要。必须已安装 WebView 运行时(Windows 11 内置,Windows 10 的 setup.exe 中包含)以及 Microsoft Edge,因为删除 Edge 可能导致外壳无法正常工作。
安装时有哪些需要注意的坑吗?在全新安装的 Windows 上,应用可能会短暂显示空白的白屏或黑屏,直到你运行 Windows 更新并重启;Store 和 Winget 的更新也可能比 GitHub Releases 晚 1–3 个工作日。
Windows 10 和 Windows 11 都能用吗?可以,它是专门为 Windows 10 和 Windows 11 打造的桌面环境替代方案。
我能为它开发自己的组件吗?可以。它提供 Widget SDK,让你使用 Svelte、TypeScript 构建自定义组件,并可完整访问系统状态的 IPC 接口。
动态强调色功能是怎么工作的?Seelen UI 会实时分析你当前的壁纸,并自动为每个外壳元素推导出匹配的强调色,无需手动调整。
界面支持多少种语言?界面已完整本地化,开箱即支持 70 多种语言。
平铺窗口管理器具体能做什么?它会自动将打开的窗口排列成可控制间距的布局,如 BSP、分栏和堆叠,并支持用键盘调整大小、交换位置和切换所有窗口。
Creator
eythaann
Size
89.3 MB
Stars
18.1K
Age
2y
Commits · 90 Days