Skip to content

DeckThemes/CSSLoader-Desktop

Repository files navigation



CSSLoader Desktop

A native standalone styling engine for Steam on Windows and Linux

Inject custom styles into Steam's desktop and Big Picture Mode interfaces, browse an ever-growing storefront of community creations, easily manage your themes' settings and updates, and more.



Features

Theming

  • Injects user generated CSS into any render target of Steam UI.
  • Mix and match multiple themes to your liking.
  • Supports "patches" for themes, allowing users to customize values using dropdowns, color pickers, and more.
  • Allows custom images and fonts to be used. (See Creating Symlink)
  • "Profiles" allow you to save the state of multiple themes to reapply later.

Theme Store

  • An integrated storefront for you to download user-submitted themes.
  • Prompts for updating your themes available in the 'Manage' tab.
  • Account support to enable the starring of themes.

Installation

Downloading CSSLoader Desktop

Windows

  1. Download the latest CSSLoader Desktop .msi installer file from Releases.
  2. Once downloaded, run the installer, and follow the onscreen instructions.
  3. If this is your first time installing CSSLoader Desktop, upon launching the app you will be prompted to install CSSLoader's Backend. Click 'Install'
  4. CSSLoader Desktop is now installed! Continue to Creating Symlink if you want to set up custom images/fonts.

Linux/Steam Deck

Installing CSSLoader's Backend

  1. Install Decky Loader using the instructions on the Decky repository.
  2. Run Steam's Big Picture mode or open game mode on Steam Deck.
  3. Open the Quick Access Menu. (QAM Button, Ctrl + 2, Xbox + A, or PS + X)
  4. Select the Decky tab, it has the icon of a power plug.
  5. Select the store icon in the top right.
  6. Search for 'CSS Loader' and install it.
  7. Leave the store, and select CSS Loader from the plugin menu.
  8. Select 'Download Themes', then go to the 'Settings' tab in the Theme Store.
  9. Enable the toggle for "Enable Standalone Backend"

Installing CSSLoader Desktop

  1. Download the latest .appimage binary from Releases.
  2. Running it will start CSSLoader Desktop.
  3. Since CSSLoader Desktop cannot update the backend from the frontend, you will need to periodically open Steam Big Picture and update CSSLoader through Decky.

Creating Symlink

In order to have custom images, fonts, and other files work in themes, you need to create a symlink.

If you are on Linux, you may skip this step as the symlink is created automatically.

Windows

In order to create the symlink, you must run CSSLoader's Backend at least once with Windows Developer Mode enabled.

  1. Open Settings (Win + I)
  2. Select 'Privacy & Security'
    • On Windows 10, this is called 'Updates and Security'
  3. Select 'For developers'
  4. Toggle 'Developer Mode' on.
  5. Restart CSSLoader's Backend.
    • You can do this by opening CSSLoader Desktop, clicking on the 'Settings' tab, and pressing 'Kill Backend', followed by 'Force Start Backend'
    • Alternatively, you can restart your system.
  6. Click on your system tray, and right click on the white paint roller icon.
    • If you see the text "Custom Images/Fonts Enabled", you're set!
    • You may disable Developer Mode after going through this process.

Building/Contribution

Frontend

As a Tauri app, you will need all of Tauri's prerequisites to develop for CSSLoader Desktop.

To start a dev server, clone this repository, then run

npm i
npm run tauri dev

A maintained list of frontend bugs/upcoming features is available through our project board, we refer to issues based on their IDs in the board.

Store

The DeckThemes store is managed under a different github repository.

Backend

CSSLoader's backend is managed under a different github repository.

Acknowledgements