git404hub

what is winetop fr?

akovari/winetop — explained in plain English

Analysis updated 2026-05-18

1RustAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A command line tool like htop, but for monitoring and safely stopping Wine, Proton, Lutris, and other Windows-on-Linux game sessions.

vibe map

mindmap
  root((repo))
    What it does
      Monitors Wine sessions
      Safely kills processes
    Tech stack
      Rust
      ratatui TUI
    Supports
      Wine and Proton
      Lutris Heroic Bottles
    Use cases
      Stop a stuck game
      Status bar integration
    Audience
      Linux gamers
      Wine users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Watch CPU and memory use for Wine, Proton, Lutris, Heroic, and Bottles game sessions in one interactive terminal view.

VIBE 2

Safely stop a frozen game session without accidentally killing your entire Steam client.

VIBE 3

Feed live game session status into a status bar tool like Waybar for a quick CPU or memory readout.

what's the stack?

Rustratatui

how it stacks up fr

akovari/winetopabc3dz/mixxxabyo-software/ferro-stash
Stars111
LanguageRustRustRust
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedevelopergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Available through most Linux package managers or as a prebuilt binary, no build required for most users.

in plain english

winetop is a command line tool for Linux that shows you what is running inside Wine, the compatibility layer that lets Windows programs and games run on Linux. If you have used htop to watch which processes are eating your CPU, winetop does the same thing but understands Wine specifically, along with the tools built on top of it like Proton (used by Steam), Lutris, Heroic, and Bottles. Instead of a flat list of confusing process names, it groups everything by the actual game or app session it belongs to, so you can see at a glance which Steam game or launcher is using how much CPU and memory. The tool works both as an interactive full screen text interface and as a plain command line utility you can script. In the interactive mode you can expand a session to see its individual processes, view live CPU and memory graphs, and kill a stuck session safely: winetop tries a gentle stop signal first, then falls back to Wine's own shutdown mechanism, and only forces a hard kill as a last resort, so it avoids accidentally killing your entire Steam client along with one game. From the command line you can list sessions, print a tree view, dump a JSON snapshot, find orphaned processes, or kill a specific session by its Steam app ID, its Wine prefix path, or its process ID. winetop can also feed live status information to status bar tools like Waybar, useful if you want a quick CPU or memory readout for the game currently running in your system tray area. It figures out human readable names for what it finds by reading metadata files that Steam, Lutris, Heroic, and Bottles already keep on disk. Installation is available through several Linux package managers including apt via a PPA, Fedora's Copr, the Arch User Repository, Homebrew, Nix, and Rust's own Cargo package manager, or by downloading a prebuilt binary from the project's GitHub releases page. It is written in Rust and released under the MIT license.

prompts (copy fr)

prompt 1
Show me how to install winetop on my Linux distro and run the interactive TUI.
prompt 2
Explain winetop's safe kill ladder and why it avoids killing the Steam client by accident.
prompt 3
Walk me through using winetop's command line mode to list sessions and kill one by Steam app ID.
prompt 4
Help me set up winetop's status output for Waybar to show the currently focused game.

Frequently asked questions

what is winetop fr?

A command line tool like htop, but for monitoring and safely stopping Wine, Proton, Lutris, and other Windows-on-Linux game sessions.

What language is winetop written in?

Mainly Rust. The stack also includes Rust, ratatui.

How hard is winetop to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is winetop for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.