Skip to content
Derek J. Clark edited this page Feb 17, 2024 · 94 revisions

What is ChimeraOS?

ChimeraOS is a Linux-based PC operating system designed for a game console experience.

It runs Gamepad UI, the same interface used by the Steam Deck, allowing you to play most of your Steam library, but also allows you to install and play many non-Steam games through the built-in Chimera web app.

See our OS Comparison for more details.

What distro is ChimeraOS based on?

ChimeraOS is based on Arch Linux. However, this is only relevant to ChimeraOS developers and no Arch Linux knowledge is required to install or use ChimeraOS.

The key difference between Arch Linux and ChimeraOS is that ChimeraOS has a unique install and update mechanism called frzr.

Arch Linux's native package manager pacman is disabled by default. In fact, ChimeraOS users do not deal with packages at all. Instead, the entire system is provided as a single downloadable image that is extracted to disk as a read-only volume upon each update.

This allows safe, automatic, zero downtime updates that can be done with a gamepad.

Is ChimeraOS for me?

The main goal of ChimeraOS is to provide an out-of-the-box console gaming experience that is usable by anyone, even those with no Linux experience.

ChimeraOS is for you if:

  • you want a zero maintenance console gaming experience on PC hardware
  • you are willing to sacrifice some game compatibility and customizability

How can I dual boot with other operating systems?

ChimeraOS does not officially support dual booting with other operating systems on the same drive, however there is a community guide available. No support requests will be provided to troubleshoot dual booting from the development team..

If you install ChimeraOS on a separate drive, you can dual boot with other operating systems by using your BIOS to select a boot drive.

Why is dual booting not supported?

In order to achieve true automatic updates, ChimeraOS uses a unique update system called frzr that requires full control of the boot loader. On every update, ChimeraOS downloads an entirely new version of itself to disk and rewrites the boot loader configuration to point to the newly downloaded system. This precludes using the same bootloader with multiple operating systems.

Why is the installation media outdated?

The installation media is not outdated, it simply follows a different release cycle than the operating system itself.

ChimeraOS works very differently compared to traditional operating systems. The installer downloads and installs the latest system image file through a simple process that doesn't change from release to release. Therefore there is usually no need to update the installation media.

The installation media is occasionally updated with new hardware support, bug fixes, or other minor changes. These releases don't normally coincide with releases of the operating system.

Why do I have to wait for shaders to be compiled on launch of a game?

This can be a very long process for some games, and while it can usually be skipped, there is a way to pre-download these shaders if they are available. If you switch to Desktop mode you can open Steam's Settings, and in the Downloads section there's a subsection called Shader Pre-caching, where pre-caching can be enabled and also background processing can be enabled. Enabling both of these should reduce or even eliminate the initial shader compilation step when launching a game.

How can I install and use additional software?

You can use Chimera or access the terminal and install additional software manually using flatpak.

You must create a shortcut YAML file which will allow you to specify a banner image, tags, and a specific launch command. See the Chimera README for details.

Software installed through Chimera will automatically appear in the Steam UI after a restart.

What is the Chimera app?

The Chimera web app allows you to install and manage non-Steam games, including your ROM collection and games from third-party stores.

It also functions as a handy remote control for your ChimeraOS box when used from your phone.

How can I access the Chimera app?

The Chimera app can be accessed from a web browser on another device by navigating to http://chimeraos.local:8844 or the IP address of your ChimeraOS machine. You can obtain the IP address of your ChimeraOS machine by navigating to Settings -> Internet, then selecting your active network connection.

Where are the installation files from games installed via the Chimera app?

Where to find GOG install files

These files are located under ${HOME}/.local/share/chimera/content/gog. The game will be inside a folder with a numerical ID that corresponds to the title seen at GOGDB.org, as well as on the Chimera app page for the installed game.

What emulated console platforms does the Chimera app support?

32X *
3DO *
Arcade
Atari 2600
Atari 7800
Dreamcast
Game Boy
Game Boy Advance
Game Boy Color
GameCube
Game Gear
Genesis/Mega Drive
Jaguar
Master System
Neo Geo *
Nintendo
Nintendo 64
Nintendo DS
PlayStation *
PlayStation 2 *
PlayStation Portable
Saturn *
Sega/Mega CD *
Super GameBoy * 
Super Nintendo
Super Nintento MSU1
TurboGrafx-16/PC Engine

* requires BIOS file to function

Why can't I access the RetroArch menu?

Access to the RetroArch menu is disabled by default to preserve the simple console experience. It's possible to enable the menu, but changing settings may create a configuration that we can't support, so be aware that you may be on your own. The config file is located in /home/gamer/.config/retroarch/retroarch.cfg but be aware that Chimera periodically merges default config files with this file. You can add input_menu_toggle_gamepad_combo = 9 to the file to make Gamepad-Down+Select open the RetroArch menu.

Where does ChimeraOS store the ROMs?

If you need to back them up or grab a copy they are stored in /home/gamer/.local/share/chimera/content

What third-party stores does the Chimera app support?

  • Epic Games Store
  • Flathub
  • GOG

Why doesn't ChimeraOS/Chimera support Origin/Battle.net/Ubisoft Connect?

These stores are not compatible with a game console experience and are thus not supported and likely never will be.

Only stores that allow running and installing games without having to use desktop client software can be used with ChimeraOS/Chimera.

How do I install non-Steam games?

Non-Steam games can be installed from the Library page of the Chimera app.

Why don't games added through the Chimera app show up in Steam?

Steam must be restarted to pick up the new games. You can do that through the Actions page in the Chimera app or by restarting the computer.

How can I update my ChimeraOS system?

A system notification will appear when an update is available. You can also select "Check For Updates" in Settings -> System.

How can I access the terminal from ChimeraOS?

See the Terminal Access page for details.

I have more than one hard drive, solid-state disk, or SD Card. How can I use that for steam games?

See the Mounting Additional Disks guide.

How can I help test ChimeraOS?

Please see our contributing page for more details.

I'm having some trouble, how can I get help?

See our Troubleshooting Guide or join our Discord help channel

Clone this wiki locally