Chrome Dino Runner

A Python and Pygame take on Chrome's classic offline dinosaur game.

Watch the MP4 recording

About

This project recreates the familiar endless runner as a small desktop game. Jump over cacti, duck under flying obstacles, and see how high you can score.

Get started

You’ll need Python 3.8 or newer and uv.

git clone https://github.com/dhhruv/Chrome-Dino-Runner.git
cd Chrome-Dino-Runner
uv sync
uv run chrome-dino-runner

Alternatively, start the game as a Python module:

uv run python -m chrome_dino_runner

Controls

Your high score is saved in your operating system's per-user application data directory, not in the project folder. Existing score.txt scores in the launch directory are migrated there the next time you start the game.

• Windows: %LOCALAPPDATA%\Chrome Dino Runner\score.txt
• macOS: ~/Library/Application Support/Chrome Dino Runner/score.txt
• Linux: $XDG_DATA_HOME/Chrome Dino Runner/score.txt (usually ~/.local/share/Chrome Dino Runner/score.txt)

Development

The project uses a src-layout package. Install the project and its dependencies into the uv-managed environment with uv sync, then launch it with uv run chrome-dino-runner.

Build a wheel and source distribution with:

uv build

src/chrome_dino_runner/
├── __main__.py
├── game.py
└── assets/