Skip to content

About

Catppuccin Mocha theme for Steam on Millennium, with frosted menus, a desktop fixes plugin and a one-step setup

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

The Steam library in Mocha Steam: a rounded game sidebar, the Store, Library and Community pill in the top bar, and a grid of rounded game covers on dark Catppuccin Mocha

Mocha Steam

A Catppuccin Mocha theme for the Steam client on Millennium, with frosted menus and glass.

The theme, its desktop fixes plugin, and a setup script that copies my whole Millennium setup: every plugin, the theme and my settings.

Download the latest release



Latest version Total downloads Platform: Steam with Millennium on Windows

Installation

Theme and desktop fixes plugin

  1. Install Millennium.

  2. Download the latest release and extract it.

  3. Exit Steam.

  4. In the extracted folder, run:

    powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Apply -Configure
  5. Start Steam. Mocha Steam is selected and MochaSteam Desktop Fixes is on.

Without -Apply, install.ps1 only shows what it would do. Add -SteamPath 'D:\Steam' if Steam lives somewhere else.

The whole setup

This copies my exact setup. It installs Millennium if it is missing, the theme, 23 plugins, my theme options and my plugin settings. Run it in Windows PowerShell:

irm https://raw.githubusercontent.com/DavidHiFi/MochaSteam/main/setup/Install-MochaSetup.ps1 | iex
  1. If Millennium is missing, the official Millennium installer opens. Click through it.
  2. The script closes Steam, installs everything and merges your Millennium config after backing it up.
  3. Start Steam when it finishes.
  4. Install the three plugins listed under Three plugins to install by hand to match my setup exactly.

To read the plan before anything changes, download the script and run it in audit mode:

Invoke-WebRequest https://raw.githubusercontent.com/DavidHiFi/MochaSteam/main/setup/Install-MochaSetup.ps1 -OutFile Install-MochaSetup.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File .\Install-MochaSetup.ps1 -Audit

Add -SteamPath 'D:\Steam' for a Steam folder elsewhere, or -SkipMillenniumInstall to stop the script from starting the Millennium installer.

Theme only, by hand
  1. Install Millennium.
  2. Download the latest release, extract it and exit Steam.
  3. Copy what is inside themes\mocha-steam to Steam\millennium\themes\MochaSteam, so skin.json sits in that folder.
  4. Start Steam and pick Mocha Steam in Millennium's Themes tab.

Leave Mica & Acrylic plugin support off this way. The frosted menu windows come from the desktop fixes plugin.

Features

Look

  • Catppuccin Mocha: the Mocha palette with blue and mauve accents, across Library, Store, Community, settings, friends and chat.
  • Rounded controls: cards, menus, dropdowns, buttons and the library frame keep their corners.
  • Hover rings: every hover gets the same 2px blue to mauve edge, with no jump in size.
  • Frosted menus: menus, dropdowns, tooltips, dialogs and the sticky Store bar blur what sits behind them.
  • Fluent icons: one icon set across the top bar, user panel and plugin buttons.

Library

  • Tidy rows: game icons, ProtonDB dots and non-Steam entries line up in one column.
  • Resizable sidebar: drag its edge, and the width is kept.
  • Library frame: the sidebar, the Downloads bar and the user panel sit inside one frame below the top bar.
  • Downloads sidebar: your games list stays beside the Downloads page.
  • Narrow windows: the top bar keeps its pills lined up when you shrink Steam.

Options and plugins

  • SpaceTheme options: sidebar position and hover mode, fonts, window controls, an auto-hide menu, gift-card visibility and favourite-friend status backgrounds.
  • Plugin styling: matching looks for plugins such as Size on Disk, ProtonDB badges, HLTB and Extendium.
  • Desktop fixes plugin: real Windows frosted glass behind Steam's separate menus and desktop pop-ups, and Friends stays closed at startup.

Setup script

  • Plugins: installs 23 plugins at the versions pinned in setup/manifest.json, and turns on the same ones I use.
  • Settings: copies my theme options, colours, Millennium settings and every plugin's settings, merged into yours.
  • No personal data: no keys, logins, friend lists, play history or file paths are included.
  • Safe re-runs: backs up your config and keeps plugin data such as the Gratitude friend list.

Notes

Important

The see-through main window needs more than this repo. Frosted menus and pop-ups need Windows 11 with transparency effects on. On my PC the main window is see-through thanks to a Windhawk title bar mod as well. Without one, turn off Mica & Acrylic plugin support in the theme options and the main window is a solid dark theme.

Note

Fonts are not included. The default font is Be Vietnam Pro. Install it, or pick a font you have in the theme options.

Note

One repo since November 2026. This repo was called millennium-stuff, and the theme used to sit in a second repo with skin.json at its root. Both are here now. The old setup command and old millennium-stuff links still work.

Warning

Steam updates can break parts of the theme. Selectors and popup behavior change between Steam versions. Open an issue with a screenshot and your Steam and Millennium versions when something looks wrong.

Three plugins to install by hand

These plugins publish no license, so this repo does not include their code. Install each one from Millennium's plugin store, or from its repository at the commit below. Millennium enables them once they are in place, because the config already lists them.

Plugin Repository Commit
adamraichu.auto-accept-custom-launch-args AdamRaichu/auto-accept-custom-launch-args 084d32b
browser_history ricewind012/steam-browser-history 8214f36
easy-restart-reload-for-steam SaiyajinK/Easy-Restart-Reload-for-Steam 01f10fd

The auto-accept plugin turns off a Steam safety prompt for custom launch arguments. Read its README before you install it.

What the setup script does not copy
  • Lua Tools Collection: my plugin for SteamTools Lua scripts lives in luatools-collection and is not installed.
  • Personal data: Steam friend lists, Gratitude data, non-Steam playtime sessions, the list of installed Windows apps and proxy settings stay on my PC.
  • Steam's own state: your account, library and window positions are not part of the setup.

Every plugin with its source and version is listed in NOTICE.md.

Repo layout
Path What it is
themes/mocha-steam/ The theme, with skin.json at the top of that folder. This is the only copy.
plugins/mochasteam-material/ MochaSteam Desktop Fixes, the plugin both installers copy.
install.ps1 Installs the theme and the desktop fixes plugin from a downloaded release.
setup/ The full-setup script, its plugin manifest, config templates and vendored MIT plugins.
configs/ An example Millennium config and the SpaceTheme commit the theme is synced to.
docs/ Notes on the theme and where its glass comes from.

Contributing

Reports of Steam updates that break the theme help the most, with a screenshot, along with pull requests for pages the theme misses and fixes to the setup script.

How to contribute

Star history

Thanks for the stars, the Steam client reports and the plugin fixes.

DavidHiFi/MochaSteam GitHub star history

Credits

Who What
SpaceEnergy (SpaceTheme for Steam) Mocha Steam is a fork of SpaceTheme (MIT), synced through commit ce67165 with later fixes ported by hand, including ForgottenHero's hover-sidebar fix and EldinBegano's dropdown styling.
Catppuccin (catppuccin) The Mocha colour values (MIT).
Microsoft (Fluent UI System Icons) The icon font that SpaceTheme ships (MIT).
luthor112 (GitHub) Steam Collections Plus, Steam EasyGrid, Steam Librarian and Steam Taskbar Progress, included in setup/vendor/ (MIT).
veygax (valve-internal-enabler) Included in setup/vendor/ (MIT).
xwxfox (millennium-uwp-library-sync) UWP Library Sync, included in setup/vendor/ (MIT).
Plugin authors (full list) The 16 plugins the setup script downloads from their own releases, and the three installed by hand.
Steam Client Homebrew (PluginDatabase) The approved repositories and commits the plugin manifest is pinned to.

Built on Millennium, with plain CSS and JavaScript for the theme, Lua for the desktop fixes plugin and PowerShell for the installers.

Missing or wrong credit? Open an issue and I'll fix it.

Disclaimers

Most of this project's code was developed with AI coding agents, mainly Claude Code, with some work from OpenCode and Halo Sparks. I checked each theme change on my own Steam client. The theme started as SpaceEnergy's SpaceTheme, and the plugins belong to their authors.

My changes are MIT, see LICENSE. SpaceTheme keeps its MIT license in themes/mocha-steam/, and every plugin keeps its own license.


Not affiliated with Valve or Steam Client Homebrew. Requires Steam on Windows and Millennium.

About

Catppuccin Mocha theme for Steam on Millennium, with frosted menus, a desktop fixes plugin and a one-step setup

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages