gitwtfhub

wtf is mtg?

modern-terminal-games/mtg — explained in plain English

Analysis updated 2026-05-18

4RustAudience · developerComplexity · 2/5LicenseSetup · easy

TL;DR

A collection of polished arcade games, like Breakout, Pong, and Snake, that you play directly inside your terminal with one command.

Mindmap

mindmap
  root((mtg))
    What it does
      Arcade games in terminal
      One command launcher
      Works over SSH
    Tech stack
      Rust
      Ratatui
      Cargo/Homebrew
    Use cases
      Play during build waits
      Remote SSH gaming
      Add new curated games
    Audience
      Terminal-based developers
      CLI enthusiasts
      Rust hobbyists

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

Why would anyone build with this?

REASON 1

Play a quick arcade game in your terminal during a slow build or compile.

REASON 2

Enjoy games over a remote SSH session without needing a browser or GUI.

REASON 3

Add a new curated terminal game by building on the shared game engine crate.

What's in the stack?

RustRatatuiCargoHomebrew

How it stacks up

modern-terminal-games/mtg6elphegor/warpadoslabsproject-gif/liara-toolkit
Stars444
LanguageRustRustRust
Setup difficultyeasyeasyhard
Complexity2/55/54/5
Audiencedeveloperresearcherdeveloper

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Requires a modern terminal with color support, audio is optional and not required.

MIT license: free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

mtg is a small collection of arcade-style games you play directly in your terminal, the black text window developers use to run commands. Instead of opening a browser or a separate app, you type one command and a menu pops up letting you pick a game to play right there. The games included so far are a brick-breaking game similar to classic Breakout, a two-paddle Pong-style duel against a computer opponent, a classic snake game where you eat food and grow longer while avoiding the walls and yourself, and a Space Invaders style game where you shoot down waves of descending enemies. Each game has smooth movement, sound effects, and colorful visuals, built to feel like a real, deliberate game rather than a quick ASCII sketch. The project is built to work anywhere a terminal works, including over a remote SSH connection or inside a terminal multiplexer session, and it does not need speakers or audio to function since sound is optional. It is written entirely in a lightweight way with no heavy app framework behind it, so it stays small and fast to install. You can install it in a few different ways: through the Homebrew package manager on a Mac or Linux machine, through Rust's own package installer called Cargo, or by downloading and building the source code directly. Each individual game can also be installed on its own as a separate small program if you only want one of them. The project is aimed at developers and terminal users who want a quick, polished distraction during compile times or downtime, and it welcomes contributions of new games as long as they are built specifically to feel good in a terminal environment.

Yoink these prompts

Prompt 1
Explain how to install mtg using Homebrew and play the Snek game.
Prompt 2
Walk me through the project layout and what mtg-core provides to each game.
Prompt 3
How would I add a new game to this project using the shared engine?
Prompt 4
What terminal features does mtg rely on to render graphics and sound?

Frequently asked questions

wtf is mtg?

A collection of polished arcade games, like Breakout, Pong, and Snake, that you play directly inside your terminal with one command.

What language is mtg written in?

Mainly Rust. The stack also includes Rust, Ratatui, Cargo.

What license does mtg use?

MIT license: free to use, modify, and distribute for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is mtg to set up?

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

Who is mtg for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.