Skip to content

nille/wikirace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŒ wikirace

โš ๏ธ Work in progress

A Wikipedia degrees-of-separation game for the terminal. Navigate from one random article to another by following links โ€” in as few steps as possible.

Built with Ratatui and the Wikipedia API.

Rust

How to play

cargo run --release

You're given a random start article and a random target. Browse the links on each page to navigate toward the target. The game tracks your steps and time.

Controls

Key Action
โ†‘ โ†“ Navigate links
Enter Follow selected link
Type Fuzzy filter links
Esc Clear filter
Tab Toggle hints
Ctrl+G Give up
Ctrl+C Quit
r Play again (end screen)

Features

  • Fuzzy search โ€” type to filter links with fuzzy matching, best matches first
  • Hints โ€” toggle with Tab to highlight links that connect to the target (via Wikipedia backlinks). Hint links float to the top of the list
  • Optimal path โ€” after winning or giving up, a BFS search shows the shortest path (up to 4 hops)
  • Article previews โ€” see extracts for both the current article and the target so you know what you're looking at and aiming for

Requirements

  • Rust 1.75+ (or use mise: mise install)
  • Internet connection (fetches from Wikipedia API)

About

Wikipedia degrees-of-separation TUI game

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages