Theming overview
Material You, light/dark/AMOLED, and automatic theme switching.
WM Keyboard’s look is driven by a theme: a full set of colors, gradients, key shapes and corner radii bundled together. Pick a built-in theme, let it follow your wallpaper, switch it automatically between day and night, or build your own from scratch.
Choosing a theme
Section titled “Choosing a theme”The theme gallery is a two-column grid: the Default (system) card first, then your saved custom themes (if you have any), then every built-in theme below them. Tapping a card applies it to the keyboard immediately.
The toolbox also has a Themes tool with live mini-previews right over the keys — but that one is a shortlist, not the whole gallery. It always shows your custom and downloaded themes, plus whichever built-ins you pin to it: each built-in card in the settings gallery carries a pin that adds it to or removes it from the tool, and a fresh install starts with a spread of six. That’s what makes the tool usable as a quick mood switch — a handful of favourites to flip between mid-typing, with the full collection one tap away in Settings (the tool’s caption says so too). The tool runs full-bleed: the toolbar row hides while it’s open and its space becomes a header with a back button on the left and the Themes / Icons tabs beside it, so the cards get the reclaimed rows. It is read-only while Auto theme is on.
There are 28 built-in themes. Eighteen are original WM Keyboard designs: plain colours like Ocean and Forest, gradient showcases like Nebula and the animated Sunset drift and Aurora, and two shape showcases (Bubble for pill keys, Facet for cut corners). The other ten (Dracula, Nord, Solarized Dark, Solarized Light, Catppuccin Mocha, Catppuccin Latte, Catppuccin Frappé, Catppuccin Macchiato, Tokyo Night, and Cyberpunk) are ports of well-known editor colour schemes, with Cyberpunk an original palette in that style. The MIT notices for the ones with upstream licences ship in the app’s About screen.
They don’t all get a card of their own, though. Twenty-two of the 28 belong to one of five families (Nightfall, Pastel, Gradients, Solarized and Catppuccin), and a family shows as a single card with one dot per look, so the grouped built-in grid is eleven cards rather than 28. Theme families and looks covers the dots, the Grouped/Separate choice, and building a family of your own.
None of the built-in themes are editable in place. Opening one in the editor and changing anything duplicates it into a new custom theme first, so the originals stay put as a fallback you can always get back to. See the theme editor for building or duplicating a theme, image backgrounds for putting a photo behind your keys, and sharing themes for exporting, importing, and addon repositories.
Matching your wallpaper
Section titled “Matching your wallpaper”Turn on Material You colors and the Default (system) theme pulls its palette from your phone’s wallpaper, the same way Android’s own system UI does. It’s on by default, but only takes effect on Android 12 and up; the switch still shows on older versions, it just has nothing to do there. Wallpaper color only ever applies to the Default theme; every built-in and custom theme carries its own fixed palette regardless of this switch. The same toggle also recolors the settings app itself, not just the keyboard.
Dark mode and AMOLED
Section titled “Dark mode and AMOLED”Mode is a four-way switch (System, Light, Dark, or Amoled) that, like Material You colors, controls both the settings app and the Default theme. Choosing Amoled always renders dark (unlike System, it doesn’t wait on the phone’s own light/dark setting) and forces the Default theme’s board to pure black; keys and other surfaces stay as near-black blended tones rather than literal black, so key edges are still visible against the true-black board. Built-in and custom themes ignore Mode entirely. If you want an AMOLED look on a fixed palette, the built-in Pitch black theme gets you there with its own true-black board.
Switching automatically
Section titled “Switching automatically”Auto (light + dark) picks two themes (one for day, one for night) and swaps between them on its own, using one of three triggers:
- System light/dark — follows the phone’s own light/dark setting.
- Time of day — switches at two clock times you set, wrapping correctly across midnight for schedules that start light in the evening.
- Sunrise & sunset — computed on the device from the location saved in the weather tool, no network round trip. Without a saved location, or on a polar day when the sun never rises or sets, this falls back to following the system setting instead.
While Auto is on, it owns the active theme completely: tapping a card in the gallery, or in the keyboard’s own Themes tool, only previews it rather than switching to it. Turn Auto off to pick themes manually again.
Options
Section titled “Options”- Material You colors — default on. Wallpaper-based dynamic color for the Default theme; no effect below Android 12, and no effect on built-in or custom themes.
- Mode — default System. Light, Dark, or Amoled, applied to the settings app and the Default theme.
- Auto theme — default off. Once on, choose a light theme and a dark theme and a trigger (System light/dark, Time of day, or Sunrise & sunset). The time-of-day picker defaults to 7:00 AM for the light theme and 7:00 PM for the dark theme.
Switching themes (manually or via Auto) crossfades over about a third of a second; turning on Reduce motion (under accessibility) skips the crossfade and snaps instantly instead.
Details & edge cases
Section titled “Details & edge cases”- Contrast is built into theme resolution, not left to chance. A theme only has to specify a handful of required colors: board, key background, key text, accent. Anything left unset (popup colors, panel chip colors, tool-circle tints, and so on) is derived mathematically from what is set, using WCAG-style contrast math, rather than guessed at or left undefined. That’s why even a minimal two-color custom theme still has readable popups and legible active-tool highlights. The Default theme’s dark mode goes a step further and deliberately avoids Material’s own dark surface roles, which tend to flatten to near-identical grays. It blends the theme’s text color over the darkened board at a few different strengths instead, to keep panels and keys visually distinct from each other.
- That’s separate from the accessibility contrast tools. High contrast keys, key outlines, and color vision filters are a different, user-facing layer that overrides theme colors outright rather than filling in gaps; they live under Settings → Accessibility, not here. See Accessibility for those.
- Key shape is a per-theme setting with twelve options, picked from a list that draws each shape beside its name: Rounded (the default, and the one that follows the corner-radius value), Square, Pill, Cut (clamped to a 2–14dp radius regardless of the slider), Squircle, Arch, Leaf, Slanted, Hexagon, Scalloped, Ticket, and Circle (a typewriter-style round cap centred in the key). Everything except Rounded and Cut sizes itself off the key instead of the radius slider. Full table on the theme editor page.
- Corner radius has a global slider and an optional per-theme override. The global Key corner radius slider (Appearance → Keys, default 8dp, range 0–28dp) applies unless a theme defines its own. The theme editor’s “Theme-specific corner radii” toggle exposes separate sliders for key, popup, and tool-circle radius when you want a theme to ignore the global value.
- Borders are opt-in and off by default. A theme has no key border unless it sets one explicitly. The built-in Solarized Dark and Solarized Light themes are a good example of when a border earns its keep: their two background tones sit close enough in contrast that a thin outline keeps key edges readable. The toolbar tools have their own outline pair in the theme editor, off in the same way. The accessibility “Key outlines” toggle adds a border of its own, to the keys and to the tools, only where the active theme hasn’t already defined one; a theme’s own border always wins.
- No edition split. Every built-in theme, gradient, animation, background image, and Material You all work the same way in the full and lite editions. Nothing on this page is gated.