Skip to main content

TYPATRO — a slot-machine typing roguelike for your terminal

Project description

TYPATRO

A slot-machine typing roguelike for your terminal. Type fast, build Chips x Mult, beat Blinds, collect Jokers, and climb Antes — all wrapped in a casino-felt TUI with slot-reel animations.

Features

  • Slot machine feel — reel-spin title intro, odometer score tally that rolls as you type, digit-spin result reveals
  • Balatro-inspired game panel — left sidebar with your current Blind, live Round Score (Chips x Mult), and held Jokers
  • Chips x Mult scoring — +1 chip per correct character, +10 per word, mult scales with accuracy and error-free streaks
  • Blinds — Small, Big, and Boss Blinds with score targets; bosses impose debuffs (hidden mistakes, minimum speed, no backspace, forced accuracy)
  • Jokers — beat a blind, pick 1 of 3; up to 5 held jokers modify your scoring
  • Ante loop — Small -> Big -> Boss, then the next ante with higher targets; run state persists between sessions
  • Classic mode — a plain typing test when you just want to practice

Install

Requires Python 3.9+.

pip install typatro

To pin a specific version:

pip install typatro==1.0.7

Then run:

typatro

A Nerd Font improves the icons but isn't required.

Play

typatro            # run mode (default)
typatro --classic  # plain typing test

How a run works

  1. The sidebar shows your current Blind and its score target
  2. Type the paragraph — the Round Score odometer rolls up with every keystroke
  3. Hit the target before the test ends to beat the blind
  4. Pick a Joker and advance; bosses add debuffs and bigger targets
  5. Lose a blind? Retry it. Want a fresh start? Settings -> Danger Zone -> Reset Run

Controls

Key Action
Type Start the test
Tab Reset test
Esc New paragraph
Ctrl+S Settings
Ctrl+T Themes
Ctrl+L Languages

Click Run/Classic in the strip above the typing area to switch modes.

Contributors: see CONTRIBUTING.md on GitHub.

Credits & license

Copyright © 2026 Swayyum. TYPATRO is licensed under GPL-3.0-only.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

typatro-1.0.8.tar.gz (2.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

typatro-1.0.8-py3-none-any.whl (2.3 MB view details)

Uploaded Python 3

File details

Details for the file typatro-1.0.8.tar.gz.

File metadata

  • Download URL: typatro-1.0.8.tar.gz
  • Upload date:
  • Size: 2.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for typatro-1.0.8.tar.gz
Algorithm Hash digest
SHA256 8dd34610f51596e8a27040a495a7f3cf73828539670d30abc25e932e36b8a497
MD5 9b279dc27ed08af155589e6fcc95e1e4
BLAKE2b-256 accd1efc210f1c491343e40d6931e3b0ff48cf67b9781a086bbe7fba11d46470

See more details on using hashes here.

Provenance

The following attestation bundles were made for typatro-1.0.8.tar.gz:

Publisher: publish-pypi.yml on Swayyum/Typatro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file typatro-1.0.8-py3-none-any.whl.

File metadata

  • Download URL: typatro-1.0.8-py3-none-any.whl
  • Upload date:
  • Size: 2.3 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for typatro-1.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 904e67f8388d5043394883ec5a410a3cea7cbdd83be910d0300c373045cef5f5
MD5 f330a2083350ca5496303f7a4592a493
BLAKE2b-256 0311cd9982c30935db0c0a0689844c6bd6a799025dd7568ca75ac3c3ab5c7ec9

See more details on using hashes here.

Provenance

The following attestation bundles were made for typatro-1.0.8-py3-none-any.whl:

Publisher: publish-pypi.yml on Swayyum/Typatro

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page