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.1.0.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.1.0-py3-none-any.whl (2.3 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: typatro-1.1.0.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.1.0.tar.gz
Algorithm Hash digest
SHA256 f8e422d55024c9b5df6f750ff6786855c119f6d4afbc899cc4fceb2e3fb61bb3
MD5 65347a605914b9ed9bc3ebaf851f992f
BLAKE2b-256 be0d75b20bb7a7fa9f3c0e70cc935ad72b8db1ce05440529d7ed730808affb19

See more details on using hashes here.

Provenance

The following attestation bundles were made for typatro-1.1.0.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.1.0-py3-none-any.whl.

File metadata

  • Download URL: typatro-1.1.0-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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d2be35e5dfae655573360ee2698c0b08819f6100b3c09695e4bca0ce4db2762d
MD5 39b75e9cd7702db3b5fbcfa8491be028
BLAKE2b-256 cdbb833e460cc33e8f67cea9af7f9087a0ed2b504194cf80cd427d8ef867e6eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for typatro-1.1.0-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