Skip to content

lolterm v0.1.0

Choose a tag to compare

@m16khb m16khb released this 06 Nov 01:41
· 16 commits to main since this release

lolterm v0.1.0

첫 공개 릴리스입니다. 리그 오브 레전드 e스포츠를 터미널에서 보는 단일 Go 바이너리입니다.
프로젝트 이름이 esterm에서 lolterm으로 바뀌었습니다. 이 태그는 새 이름의 커밋을 가리킵니다.

포함된 것

  • 라이브 보드 — 킬·골드 바, 오브젝트 수, 선수별 KDA·CS·골드·HP를 0.5초마다 갱신
  • 다시 보기 — 공식 VOD와 livestats 피드를 같은 게임 시각에 맞춰 재생
  • 방송 미니맵 — 공식 1080p 방송에서 10명의 챔피언 위치를 직접 추적
  • 상태 표시 — 사망, 놓침, 귀환·텔레포트, 레드 팀 채널링을 아이콘과 아우라로 구분
  • 텔레포트 도착 지점 — 방송이 도착 지점에 그리는 팀 색 소용돌이를 찾아 표시. 레드 팀 빨간 링도 도착 지점이 보이면 T로 표시. -json에 teleports[{team,pid,x,y}]
  • 터미널 네이티브 — lazygit 스타일 창, 마우스 클릭·더블클릭·휠, kitty/blocks/text 모드
  • 3개 언어 — 한국어·영어·중국어 UI (-lang ko|en|zh, LOLTERM_LANG)
  • macOS · Linux · Windows — Windows 10 1809 이상에서 네이티브로 빌드·실행. 자식 프로세스는 잡 객체에 묶여 함께 종료

설치

go install github.com/m16khb-org/lolterm@latest

미니맵을 쓰려면 yt-dlp, ffmpeg, JS 런타임(deno 권장)이 필요합니다. Windows는 winget으로 설치합니다.
자세한 내용은 INSTALL.md를 참고하세요.

esterm에서 옮겨 오는 경우

  • 실행 파일 esterm → lolterm, 모듈 경로 github.com/m16khb-org/esterm → github.com/m16khb-org/lolterm
  • 환경 변수 ESTERM_* → LOLTERM_* (LOLTERM_FFMPEG, LOLTERM_YTDLP, LOLTERM_LANG 등). 예전 이름은 읽지 않습니다.
  • 캐시 폴더 <UserCacheDir>/esterm → <UserCacheDir>/lolterm. 처음 실행할 때 Data Dragon 이미지를 다시 받습니다.
  • 예전 바이너리는 지워 주세요: rm "$(go env GOPATH)/bin/esterm" (Windows: Remove-Item $env:USERPROFILE\go\bin\esterm.exe)

검증

  • Worlds·LCK·LPL·LEC 16경기 백테스트에서 생존 챔피언 검출 94.0%, 죽은 챔피언 오검출 0.00%, 킬 플립 동기 오차 1초 이내 97.2%를 기록했습니다.
  • 텔레포트 도착 지점: 눈으로 표시한 도착 지점 Worlds 9/9, LPL 7/7, LEC 6/6을 찾았고 오검출은 0건이었습니다.
  • Windows: 대화형 앱, 메인 뷰를 포함한 미니맵, 강제 종료 뒤 ffmpeg가 남지 않는 것을 확인했습니다.

알아 두세요

  • 한타에 가려진 텔레포트 도착 지점은 아직 놓칩니다.
  • Windows의 kitty 그래픽은 TERM_PROGRAM=WezTerm일 때만 고릅니다.
  • lolesports.com의 비공식 엔드포인트를 사용합니다. 영상은 개인 시청 목적으로만 처리합니다.
  • Riot Games와 공식적인 관련이 없습니다.

전체 문서는 README와 웹 소개에서 확인할 수 있습니다.