방송을 못 틀어도, 경기는 터미널에서 봅니다
리그 오브 레전드 e스포츠의 라이브 보드, 세트 다시 보기, macOS 메뉴 막대 요약을 제공하는 CLI입니다.
점수와 스탯은 livestats 피드 값 그대로 보여 주고, 영상으로 추정하지 않습니다.
한국어 · English · 中文 · 웹 소개 · 설치
macOS · Linux · Windows · Homebrew · Go 1.21+
╔══════════════════════════════════════════════════════════════════════╗
║ ● LIVE MSI · Knockouts ◷ 31:42 ║
║ G2 Esports [2] BO5·G4 [1] T1 ║
║ KILLS 18 ███████████████████████████████████████████████████████ 27 ║
║ GOLD 57.9k ██████████████████████████████████████████████████ 64.7k ║
║ DRG 2 ── 4 ★SOUL BRN 0 ── 1 TWR 4 ── 7 INB 0 ── 1 ║
║ PLAYER CHAMP K/D/A CS GOLD HP # ║
║ G2 BrokenBlade Yasuo 5/8/3 205 10.6k ░░░░░░░░ 0 ║
║ G2 SkewMond Skarner 4/6/10 175 11.5k ░░░░░░░░ 0 ║
║ G2 Caps Aurora 3/3/5 296 12.5k ░░░░░░░░ 0 ║
║ G2 Hans Sama Varus 6/5/8 265 15.5k ░░░░░░░░ 0 ║
║ G2 Labrov Renata 0/5/13 22 7.8k ░░░░░░░░ 0 ║
║ T1 Doran Gnar 4/4/12 228 12.6k ███░░░░░ 1375 ║
║ T1 Oner LeeSin 4/5/13 211 12.8k ██████░░ 2356 ║
║ T1 Faker Sylas 6/4/15 210 12.0k ██████░░ 2085 ║
║ T1 Peyz Xayah 13/4/7 305 19.0k ██████░░ 2348 ║
║ T1 Keria Rakan 0/1/20 21 8.3k ██░░░░░░ 636 ║
║ ◷ live feed · 10:44:17 KST ↻ 10s b s o · q quit ║
╚══════════════════════════════════════════════════════════════════════╝
lolterm lol demo의 출력입니다. 실제 터미널에서는 팀 색상이 함께 표시되고, 라이브 경기와 네트워크 없이도 이 화면을 바로 볼 수 있습니다.
최신 릴리스는 v0.3.2입니다. macOS 메뉴 막대에 라이브 경기 요약을 띄우는
lol bar가 추가되었고, 이제 Homebrew로도 설치할 수 있습니다. 자세한 내용은 릴리스 노트에서 확인하세요.
왜 lolterm · 한눈에 · 설치 · 빠른 시작 · 대화형 앱 · 보드 · 메뉴 막대 · 작동 방식 · 검증 · 문서 · 기여 · 라이선스
방송을 켜 둘 수 없을 때도 경기 흐름은 놓치고 싶지 않습니다. lolterm은 Riot의 livestats 피드를 터미널 보드로 옮겨서, 소리와 영상 없이 킬·골드·오브젝트·선수 스탯을 따라가게 해 줍니다.
- 추정하지 않습니다. 킬·골드·오브젝트·KDA·CS·체력은 피드 값 그대로입니다. 챔피언 위치처럼 피드에 없는 값은 영상으로 추정하지 않고 표시하지도 않습니다.
- 계산한 값은 근거를 밝힙니다. 게임 시계는 일시정지 구간을 빼고, 오브젝트 타이머는 피드의 처치 시각에 패치 규칙을 더해 구합니다. 유일한 추정값인 라이브 부활 시간에는
~를 붙입니다. - 터미널에서 끝납니다. 라이브 보드와 다시 보기를 한 화면에서 보고, 키보드와 마우스로 조작합니다. UI는 한국어·영어·중국어를 지원합니다.
- 터미널을 닫아도 스코어가 보입니다. macOS에서는 SwiftBar 플러그인으로 킬 스코어, 골드 리드, 게임 시계를 메뉴 막대에 띄웁니다.
- 설치가 가볍습니다.
brew install이나go install한 줄로 설치합니다. Go 표준 라이브러리만 쓰는 단일 바이너리이고, 실행할 때 외부 도구가 필요 없습니다.
| 기능 | 내용 |
|---|---|
| 라이브 보드 | 킬·골드 비례 바, 용·바론·타워·억제기 수, 선수별 KDA·CS·골드·HP 바를 0.5초마다 갱신 |
| 다시 보기 | 끝난 세트의 스탯을 livestats 피드로 되감아 재생(영상 재생 아님). Space·←·→·배속 지원 |
| 오브젝트 타이머 | 용·엘더·바론이 나오기까지 남은 시간 (피드의 처치 시각과 패치 규칙으로 계산) |
| 부활 카운트다운 | 사망한 선수의 ☠ ~Ns. 라이브는 추정(~), 다시 보기는 피드에서 읽은 정확한 시각 |
| 메뉴 막대 | macOS 메뉴 막대에 킬 스코어·골드 리드·게임 시계 표시. 클릭하면 오브젝트와 선수 스탯이 펼쳐짐 (lol bar, SwiftBar 필요) |
| 마우스 조작 | 클릭으로 창 선택과 항목 이동, 더블클릭으로 열기, 휠로 목록 스크롤 |
| CLI 명령 | live·schedule·standings·streams·leagues는 텍스트로 출력, relay·replay는 풀스크린 보드, bar는 macOS 메뉴 막대 요약 |
| 3개 언어 | 한국어·영어·중국어 UI. -lang ko|en|zh 또는 LOLTERM_LANG, 옵션 메뉴에서 전환 |
| 단일 바이너리 | Go 표준 라이브러리만 사용. 외부 의존성 없음 |
Homebrew가 있으면 Go를 따로 설치하지 않아도 됩니다.
brew install m16khb-org/tap/lolterm처음 설치할 때는 위처럼 전체 이름을 씁니다. brew tap m16khb-org/tap 뒤에 brew install lolterm을 실행하면 신뢰 목록에 없는 tap이라 거부됩니다.
업데이트는 brew upgrade lolterm, 제거는 brew uninstall lolterm으로 합니다.
Go 1.21 이상만 있으면 됩니다. 다른 도구는 필요 없습니다.
go install github.com/m16khb-org/lolterm@latest
# $(go env GOPATH)/bin 이 PATH 에 있어야 합니다Windows는 10 1809 이상에서 네이티브로 실행합니다. 바이너리는 %USERPROFILE%\go\bin에 설치됩니다.
자세한 사전 점검·PATH·검증 절차는 INSTALL.md 에 있습니다.
설치가 끝나면 lolterm lol demo로 라이브 경기 없이 보드를 확인할 수 있습니다.
소스에서 빌드하기
git clone https://github.com/m16khb-org/lolterm.git
cd lolterm
mkdir -p ~/.local/bin
go build -o ~/.local/bin/lolterm .lolterm # 대화형 앱
lolterm -lang ko # 한국어 UI (en, zh)
lolterm lol replay # 최근 종료 경기와 -match 에 쓸 id 목록
lolterm lol replay -match 115660588583040710 -g 1
lolterm lol relay -l msi # MSI 풀스크린 실시간 중계 (-i 5s 로 폴링 간격, -1 로 한 프레임)
lolterm lol live -l lck -w # 라이브 경기와 점수판을 텍스트로 출력, -w 는 30초마다 갱신
lolterm lol bar -1 # macOS 메뉴 막대용 라이브 경기 요약 (SwiftBar 플러그인, 아래 참고)
lolterm lol schedule -l worlds -n 10 # 예정 경기 (-a 는 최근 종료 경기)
lolterm lol standings -l msi # 대진표·순위
lolterm lol streams -l lck # 중계 링크
lolterm lol leagues # -l 에 쓸 리그 slug 목록
lolterm lol demo # 라이브 경기 없이 보드 한 프레임 미리보기
lolterm -version # 설치된 버전 (버그 제보에 첨부)대화형 앱에서 리그를 고르고 Enter로 경기를 열면 라이브 보드나 다시 보기가 시작됩니다.
전체 명령과 플래그는 lolterm lol help로 봅니다.
인자 없이 lolterm을 실행하면 키보드와 마우스로 쓰는 앱이 열립니다. 왼쪽에 [1] Leagues, [2] Matches, [3] Games 목록이 쌓이고,
오른쪽 [0] 창은 선택한 경기의 미리보기나 실행 중인 보드를 보여 줍니다.
| 입력 | 동작 |
|---|---|
j k / ↑ ↓ |
목록 이동 |
PgUp PgDn |
한 화면씩 이동 (Matches 끝에서 PgDn은 다음 페이지를 불러옴) |
g G / Home End |
목록 처음·끝 |
h l / ← → |
이전·다음 창 |
Tab Shift+Tab / 1 2 3 0 |
창 포커스 이동 |
[ ] |
Matches 탭 전환 (Live / Upcoming / Recent) |
r |
선택한 리그의 경기 목록 새로고침 |
Enter |
열기 (리그 → 경기 → 세트 → 보드) |
Esc |
뒤로 (확대 해제 → 보드 포커스 해제 → 보드 닫기) |
| 클릭 | 창 포커스와 행 선택. Matches 탭 행을 클릭하면 탭 전환 |
| 더블클릭 | 경기·세트 열기, 보드 확대 전환 |
| 휠 | 포인터 아래 목록 스크롤 |
, |
옵션 메뉴 (폴링 간격 2s/5s/10s, 보드 볼 때 왼쪽 열 표시, 언어) |
? |
현재 문맥의 키 도움말 (화면보다 길면 ↑ ↓로 스크롤, 다른 키로 닫기) |
q / Ctrl+C |
종료 |
언어는 lolterm -lang ko, lolterm -lang zh처럼 실행하거나 LOLTERM_LANG=ko를 설정합니다.
기본값은 영어이고, 옵션 메뉴의 Language 항목에서도 바꿀 수 있습니다.
화면은 최소 40×12, 보드는 50열 이상이 필요합니다. 대화형 화면은 표준 입출력이 터미널일 때만 열리고,
파이프나 리디렉션으로 실행하면 오류로 끝납니다. 한 프레임만 필요하면 lolterm lol relay -1을 씁니다.
보드에 포커스가 있을 때는 Space 일시정지, ← → ±10초, + - 배속(1×/2×/4×, 다시 보기), b stats→items→runes,
s 골드 스파크라인, o 오브젝트 맵, f 확대를 씁니다.
단독 실행한 relay·replay 보드에서는 Tab으로도 보기를 전환하고 Ctrl+L로 화면 전체를 다시 그립니다.
relay의 폴링 간격은 -i(기본 2s)로 정하고, 대화형 앱에서는 옵션 메뉴에서 바꿉니다.
보드의 모든 값은 livestats 피드에서 옵니다.
| 줄 | 내용 |
|---|---|
| 헤더 | 리그, 블록, 게임 시계, 패치. 게임 시계는 일시정지 구간을 뺀 값이며, 보드를 연 뒤 일어난 일시정지뿐 아니라 연 시점 이전의 일시정지도 피드 기록에서 찾아 반영합니다 |
| 팀 | 블루 팀이 왼쪽입니다. 팀 순서는 피드의 blueTeamMetadata가 정합니다 |
| 킬·골드 | 킬 수와 골드 비례 바 |
| 오브젝트 | 용·바론·타워·억제기 수. 소울 획득은 ★SOUL |
| 타이머 | 용(또는 엘더)·바론이 나오기까지 남은 시간. UP은 지금 구덩이에 있음, --는 아직 모름. 다음 용의 속성(3번째부터)과 소울 포인트에 도달한 팀도 표시 |
| 선수 | K/D/A, CS, 골드, HP 바, 사망 시 ☠ ~Ns 부활 카운트다운 |
부활 카운트다운은 라이브에서 레벨과 게임 시간으로 계산한 추정이라 ~가 붙고, 다시 보기에서는 피드에서 읽은 정확한 시각입니다.
용·엘더·바론 타이머는 피드가 알려 준 처치 시각에 패치 규칙의 재등장 시간(용 5분, 엘더·바론 6분, 바론 첫 등장 20분)을 더해 계산합니다.
b는 stats → items → runes 보기를, s는 골드 차이 스파크라인을, o는 오브젝트 맵을 켜고 끕니다.
챔피언 위치, 텔레포트·귀환, 밴픽은 공식 피드에 들어 있지 않으므로 lolterm은 보여 주지 않습니다. 방송 영상을 읽어 추정하지도 않습니다.
lolterm lol bar는 라이브 경기를 SwiftBar의 스트리밍 플러그인 형식으로 출력합니다.
메뉴 막대에는 T1 7–6 BLG · T1 +770 · 22:27처럼 블루 팀이 왼쪽인 킬 스코어, 골드 리드, 게임 시계가 나오고, 일시정지 중이면 ⏸가 붙습니다.
클릭하면 세트 스코어, 킬·골드·타워·억제기·용·바론, 오브젝트 타이머, 선수별 K/D/A·CS·골드·부활 카운트다운이 펼쳐지고, 라이브 보드나 대화형 앱을 터미널에서 엽니다.
피드는 relay와 같은 방식으로 받으므로 게임 시계에서 플러그인 시작 전의 일시정지도 빠집니다. 폴링 간격은 -i(기본 5s)입니다.
lol bar는 v0.3.2 이상에서 쓸 수 있습니다. 아래 명령은 지금 설치된 lolterm 경로를 플러그인에 그대로 기록합니다.
brew install --cask swiftbar
mkdir -p ~/.config/swiftbar
cat > ~/.config/swiftbar/lolterm.sh <<EOF
#!/bin/sh
#<swiftbar.type>streamable</swiftbar.type>
exec "$(command -v lolterm)" -lang ko lol bar
EOF
chmod +x ~/.config/swiftbar/lolterm.sh
defaults write com.ameba.SwiftBar PluginDirectory -string "$HOME/.config/swiftbar"
open -a SwiftBar리그를 고정하려면 플러그인의 명령을 lol bar -l lck처럼 바꿉니다.
드롭다운의 명령이 열 터미널은 SwiftBar 설정의 Terminal(Terminal, iTerm, Ghostty, Kitty)에서 고릅니다.
- 피드:
getLive·getSchedule·getEventDetails로 경기와 세트를 찾고, livestats 피드(window·details)에서 점수판·게임 시계·선수 스탯을 가져옵니다. - 재생: 피드는 10초 분량씩 백그라운드에서 받아 두고, 화면은 네트워크를 건드리지 않고 0.5초마다 쌓인 프레임을 재생합니다. 지연은 최근 수신 지연에 맞춰 자동 조절됩니다.
- 게임 시계: 피드의 일시정지 구간을 빼서 계산합니다. 경기 중간에 보드를 열어도 그 전의 일시정지를 피드 기록에서 찾아 반영합니다.
- 다시 보기: 끝난 세트의 프레임을 10초 창 단위로 받아 저장하고, 재생 위치에 맞는 프레임을 보여 줍니다. 같은 창은 한 번만 받습니다.
- 메뉴 막대:
relay와 같은 피드와 재생 경로를 쓰고,-i마다 SwiftBar 형식의 블록을 출력합니다.
lolesports API ──▶ livestats feed ──▶ playout (0.5s) ──▶ board · menu bar
├─ game clock (pauses removed)
├─ deaths · respawn
└─ dragon / baron timers
go test ./...가 확인하는 것은 피드 파싱과 일시정지 처리, 사망·부활 계산, 오브젝트 타이머, 다시 보기 저장소, 메뉴 막대 제목, 키·마우스·폭 계산, UI 번역입니다.
단위 테스트이며, 화면은 lolterm lol demo로 합성 프레임을 그려 볼 수 있습니다.
| 문서 | 용도 |
|---|---|
| INSTALL.md | 사전 점검, PATH, 검증 체크리스트 |
| 구현 상세 | 피드, 재생 지연, 일시정지, 사망·부활, 오브젝트 타이머, 다시 보기, 데이터 소스 |
| CONTRIBUTING.md | 개발 환경, 테스트, 커밋·PR 규칙 |
| .issueops/ARCHITECTURE.md | 구조와 설계 결정 |
| .issueops/TESTING.md | 검증 기준 |
| 웹 소개 | 소개와 설치 안내 (한국어·영어·중국어) |
이슈와 PR을 환영합니다. 버그를 재현했다면 경기 ID·세트 번호·터미널·재현 시각을 함께 적어 주세요.
go test -count=1 ./... # 전체 테스트
go build -o ~/.local/bin/lolterm .UI를 바꿨다면 스크린샷을 PR에 첨부합니다. 커밋은 Conventional Commits 형식을 따르고, 비밀값·로컬 캐시·생성물은 올리지 않습니다. 자세한 내용은 CONTRIBUTING.md 를 참고하세요. 마음에 들었다면 GitHub에서 스타를 눌러 주세요.
GPL-3.0-or-later. 전문은 LICENSE를 참고합니다.
Copyright (C) 2026 m16khb
lolesports.com의 비공식 엔드포인트를 사용합니다. Riot Games와 공식적인 관련이 없습니다.