clarity
01_now_building 2.0 in progress

CLARITY
Game Manager built for Omarchy

Steam, GOG, Epic, itch, PICO-8, emulators, fan games, source ports and mods. One library. In the bar, one shortcut away. Built for Omarchy.

See what is shipping The code

News

all stories →
The Download Manager with Pause and a paused game
New feature

Downloads could only be cancelled. Now they pause and resume

A trivial thing, overlooked until now. GOG and Epic both, and nothing you already downloaded is lost.

Read more
An RC Cars buggy mid-race
Fixed

RC Cars drew a black square in the corner and hung. Now it plays

A lot of old school fun and dirty cheap on GOG. It just would not start here.

Read more
The gallery hero with Play and + Playlist buttons
New feature

The hero only showed your games. Now it plays them

Play and + Playlist sit on the gallery hero, acting on whatever it is showing.

Read more
A television test card where a game intro should be
Fixed

The colour bars came back on my other machines. Now the fix travels with them

Clarity picks a runtime that can actually decode video, and says so when none of yours can.

Read more
The Missing Games window
New feature

A restored library listed games that were not there. Now Clarity finds them

Grouped by the folder that went missing, nothing ticked, and an unplugged drive called out as a drive rather than as a few hundred missing games.

Read more
The Recipes pane
New feature

Recipes were buried in the code. Now they have a page, and your covers say which games use one

Seven named faults and their fixes, in the settings. Games in your library that carry one wear a pot beside their store mark.

Read more
Doom 64 CE running
Fixed

Recipes could not see your Steam games. Now they can

Doom 64 CE asked for a copy of Doom 64 that was already installed. Any recipe needing a file from a Steam game had the same blind spot.

Read more
A game cover carrying its platform mark
New feature

Every cover now says what you actually installed

Native Linux or Windows, read off the files rather than off the store page. Mine came out at 49 native and 147 Windows.

Read more
DOOM CE cover art
Fixed

DOOM CE died before the title screen. Now it installs clean and starts

It is not a mod, it is a port with its own engine. That, and the wrong copy of doom2.wad. Doom 64 CE is in now too.

Read more
A television test card where a game intro should be
Fixed

Cutscenes came out as colour bars. Now they play

A test card and static instead of the intro. Not the codec: Clarity was handing games a Proton build with no video libraries in it.

Read more
Road Rash cover art
New recipe

Road Rash broke four times over. Now all four are handled when you press play

A missing file, a screen that would not go to 640x480, no CD-ROM drive, and a note the installer never wrote. Install it from your own disc and all four are dealt with when you press play.

Read more
DOOM CE cover art
New port

PSX Doom, the way it looked on the console

The coloured lighting, the darker palette and Aubrey Hodges’ soundtrack, rebuilt on modern GZDoom. It brings its own engine, and it wants doom2.wad, so you need a copy of Doom II.

Read more
Clarity’s CRT face on a Philips CRT television
New face

Clarity now runs on a television older than most of my games

Couch Mode is built around cover art, and a tube TV has nowhere to put any. So there is another face: a menu you drive with a D-pad, that installs, scrapes and plays without you leaving the sofa.

Read more
The Witcher: Enhanced Edition cover art
New recipe

The Witcher did nothing when you pressed play. Now it starts, with its text back

No window, no error, not even a log. GOG’s installer writes down where it put the game, and on Linux that step never happens, so the game decided it was not installed. Clarity writes it now.

Read more
DOOM + DOOM II cover art
New feature

Doom mods, with the soundtrack you already own

Brutal Doom on IDKFA, chosen when you press play. Nothing is downloaded: the music comes out of the DOOM + DOOM II re-release on your own disk, matched by what the songs are rather than what they are called.

Read more
Arcanum: Of Steamworks and Magick Obscura cover art
New recipe

Arcanum closed the instant you pressed play. Now it opens

GOG includes a helper file that keeps the game running on Windows. On Linux it is what stopped Arcanum from opening at all. Clarity now leaves it out for this one game, and it starts.

Read more
Fallout: London cover art
New recipe

Fallout: London installed perfectly and would not start. Now it loads

It installed perfectly and then played its music over a black screen. GOG’s installer has finishing steps, and nothing on Linux performed them. Now done at launch, repairing the install you already have.

Read more

Things ONLY Clarity does:

drag it, or wait. it moves on its own
02_what_it_is.md

One app, three faces

The Manager: the desktop app. Import, organise, scrape, install, launch. Couch Mode: fullscreen and gamepad-first, for the television. The CRT face: a menu for an actual tube TV, driven with a D-pad. Installer: pulls your GOG and Epic games down, no store client.

One AppImage. Library, artwork and settings sit in a folder next to it. Backed up by copying, gone when you delete it.

03_screens.webp

What it looks like

Shot on Omarchy. No mockups.

The launcher overlay open over the desktop, one keyboard shortcut away. The library grid: every game you own, with a button under each one. A game page: key art, screenshots, description, and one play button. The source ports catalogue, grouped by the game it needs. The theme picker, with Your Desktop at the top holding your Omarchy colours. Achievements, read straight from the game. The manuals a GOG game shipped with, ready to read or download. The Couch home screen: your numbers, today's pick, and what you just imported. Another one, because DOOM deserves the whole screen. Browsing by store, in a card flow you steer with a stick.
01 · the launcher, one shortcut from anywhere 02 · the library on the desktop 03 · a game page, everything in one place 04 · source ports and fan games, from your own file 05 · the theme picker, wearing your desktop’s colours 06 · achievements from two stores in one list 07 · your GOG game's manuals 08 · Couch Mode’s home screen 09 · a game page for a television 10 · browsing covers in Couch Mode

All 78 screenshots →

04_at_home_on_omarchy.md

It found a home

Runs on any Linux desktop. Built for and tested on Omarchy, and follows its no-nonsense, no BS, everyone is welcome philosophy.

In the bar

What's installed, what's playing, and a menu that takes you where you want to go.

One keyboard shortcut away

Type a few letters, Enter, play. Cover art, genre, a short description.

Omarchy Themes

Apply one with omarchy theme set and Clarity is wearing it too.

Games open properly

Fullscreen, right screen, right resolution. No fighting the tiler.

Everything it does on Omarchy →

05_where_it_stands.txt
⚠ Experimental, and honest about it

The download is always the current build. I use it daily, and it still has rough edges. 2.0 is coming soon.