Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
S

ShojiWM

> 编程语言
Open source

The most customizable Wayland compositor with TypeScript(tsx).

544 stars0 likes0 views
WebsiteGitHub

About

The most customizable Wayland compositor with TypeScript(tsx).

Documents

  • English
  • 日本語

Quick Start

Source installs are documented in the getting started guide. Experimental NixOS support is also available:

bash
nix develop
cargo run --release -p shoji_wm -- --dev

For NixOS module installation, see the installation docs.

Features

  • Window management
  • Animations
  • Screenshots and screen sharing via xdg-desktop-portal-shojiwm
  • XWayland support via xwayland-satellite
  • Custom shaders
  • Layer shell support
  • Multi-monitor support
  • Intel, AMD, and NVIDIA GPU support

Why not Niri or Hyprland?

Niri and Hyprland are, at their core, software that bundles a window manager and a compositor together.

ShojiWM is different. It provides only the compositor, plus window-manager functionality as a default config.

In other words, the window-manager part is something you can program entirely and freely yourself. That is exactly why it bills itself as "The most customizable Wayland compositor with TypeScript (tsx)."

Here is an example. The code below implements a window's close button. When you run it, the button's composition changes reactively on hover, so its appearance updates.

typescript
const CloseButton = ({ window }: { window: WaylandWindow }) => {
  const [hover, setHover] = useState(false);

  const borderColor = hover((hover) => (hover ? "#00000000" : "#F0808030"));

  var icon: CompositionRenderable | null = null;
  if (hover()) {
    icon = (
      
    );
  }

  return (
    
      
      {icon}
    
  );
};

How ShojiWM compares

How ShojiWM differs from two popular Wayland compositors, Niri and Hyprland.

Legend: ✅ Yes / built-in  ·  Partial / limited  ·  ❌ No

Capability Niri Hyprland ShojiWM
Server-side decoration (SSD) customization via a standard API ❌ ❌ ✅
Build your own window-management strategy in TypeScript ❌ 1 ✅
Powerful custom shader pipeline API 2 3 ✅
Linux gaming support, including tearing 4 ✅ ✅
First-class xwayland-satellite support ✅ ❌ ✅

1 Hyprland 0.55+ adds custom layouts and event scripting via Lua (not TypeScript); core WM behavior remains built-in.

2 Custom GLSL is limited to window open/close/resize animations.

3 A single full-screen screen shader, not a per-element pipeline.

4 Niri supports VRR (adaptive sync), but not a tearing / immediate-flip mode.

Comparison reflects each project at the time of writing; corrections are welcome.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Rustsmithaytsxtypescriptwayland

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言