Live Game TUI

RiotSkillIssue includes a built-in Terminal User Interface (TUI) for spectating live League of Legends matches directly from your terminal. One command gives you a full dashboard with teams, champions, ranks, and more.

Quick Start

riotskillissue-cli live "Agurin#EUW" --region euw1

That's it. This single command opens an interactive, auto-refreshing dashboard.

What You See

When a Game is Active

The TUI displays a full-screen dashboard with:

When Not in a Game

If the player isn't currently in a match, the TUI shows a waiting screen and keeps checking:

Features

• Real-time game data — see the current match as it happens
• Both teams at a glance — champions, summoner spells, ranks, win rates
• Auto-refresh — data updates every 30 seconds (configurable)
• Rank colors — each player's rank is color-coded (Iron → Challenger)
• Win rate highlighting — green for >55%, red for <45%
• Ban display — all banned champions listed
• Waiting mode — if the player isn't in a game, the TUI waits and checks periodically
• Keyboard controls — refresh manually or quit with a single keypress

Installation

The TUI requires the tui optional extra:

pip install "riotskillissue[tui]"

Dependencies

The TUI uses Textual and Rich, which are installed when you include the [tui] extra.

Usage

Basic

export RIOT_API_KEY="RGAPI-your-key-here"
riotskillissue-cli live "GameName#TagLine"

With Options

riotskillissue-cli live "Faker#KR1" --region kr --refresh 15

All Options

Option	Default	Description
name	(required)	Riot ID in GameName#TagLine format
--region	euw1	Regional server (euw1, na1, kr, eun1, etc.)
--api-key	$RIOT_API_KEY	Riot API key
--refresh	30	Auto-refresh interval in seconds

Regions

All standard League of Legends regions are supported:

Region	Code
North America	na1
Europe West	euw1
Europe Nordic & East	eun1
Korea	kr
Japan	jp1
Brazil	br1
Latin America North	la1
Latin America South	la2
Oceania	oc1
Turkey	tr1
Russia	ru
Philippines	ph2
Singapore	sg2
Thailand	th2
Taiwan	tw2
Vietnam	vn2

Keyboard Shortcuts

Key	Action
++r++	Refresh game data immediately
++q++	Quit the TUI
++escape++	Quit the TUI

Rank Colors

Each player's rank is displayed with a color matching their tier:

Tier	Color
Iron	Gray
Bronze	Bronze
Silver	Silver
Gold	Gold
Platinum	Teal
Emerald	Green
Diamond	Light Blue
Master	Purple
Grandmaster	Red
Challenger	Orange

Programmatic Usage

You can also launch the TUI from Python code:

from riotskillissue.tui import run_tui

run_tui(
    api_key="RGAPI-your-key",
    game_name="Agurin",
    tag_line="EUW",
    region="euw1",
    auto_refresh=30,
)

Or use the lower-level app class for more control:

from riotskillissue.tui import LiveGameApp

app = LiveGameApp(
    api_key="RGAPI-your-key",
    game_name="Agurin",
    tag_line="EUW",
    region="euw1",
    auto_refresh=15,
)
app.run()

API Key

The TUI requires a valid Riot API key. You can get one from the Riot Developer Portal.

Set it as an environment variable for convenience:

Linux / macOSWindows (PowerShell)Windows (CMD)

export RIOT_API_KEY="RGAPI-your-key-here"

$env:RIOT_API_KEY = "RGAPI-your-key-here"

set RIOT_API_KEY=RGAPI-your-key-here

Development Keys

Riot development API keys expire every 24 hours. For persistent usage, apply for a personal or production key through the Developer Portal.

Troubleshooting

"Not currently in a game"

The player must be in an active League of Legends match (loading screen or in-game). Champion select does not count — the Spectator API only reports data once the game has started.

"404 - Data not found"

• Double-check the Riot ID spelling and tag line
• Make sure you're using the correct --region for the player's server
• Verify your API key is valid and not expired

Rate Limiting

The TUI makes multiple API calls per refresh (spectator + ranks for all 10 players). With a development key (20 requests/second, 100 requests/2 minutes), the default 30-second refresh interval stays well within limits. Lower the interval with caution.