Repolode
lyuangg

lyuangg/tui-dashboard

Bubble Tea 기반의 설정형 터미널 대시보드로, YAML 파일 하나로 셸 명령 데이터 소스와 위젯 그리드를 정의합니다.

스타
53
포크
4
열린 이슈
0
마지막 커밋
4일 전

어떤 프로젝트인가요?

tui-dashboard를 사용하면 Go 코드를 작성하지 않고도 실시간 터미널 대시보드를 만들 수 있습니다. YAML 파일 하나에 데이터 소스와 레이아웃을 선언합니다. 데이터 소스는 일정한 간격으로 실행되는 셸 명령이며, 레이아웃은 각 데이터 소스의 출력을 표시하는 위젯을 행 단위로 배치합니다.

각 데이터 소스는 text, number, array, timeseries, map, table, logs의 7가지 유형 중 하나를 사용합니다. 유형에 따라 스크립트 출력을 파싱하는 방식과 표시할 수 있는 위젯이 달라집니다. 위젯으로는 stat, gauge, chart, bar, heatmap, table, logs, text가 있습니다. 제목, 라벨, 형식은 Go 템플릿으로 지정하며, default, dracula, gruvbox, nord, light의 5가지 색상 테마가 포함되어 있습니다.

프로그램은 현재 디렉터리나 XDG 설정 경로에서 설정 파일을 찾습니다. --init 플래그를 사용하면 번들에 포함된 예제와 스크립트를 기본 위치에 복사합니다.

핵심 기능

  • 01단일 YAML 파일에서 데이터 소스와 레이아웃을 정의합니다.
  • 027가지 데이터 소스 유형에 따라 스크립트 출력을 파싱하는 방식이 달라집니다.
  • 03stat, gauge, chart, bar, heatmap, table, logs, text 위젯을 제공합니다.
  • 04제목, 라벨, 형식에 Go 템플릿을 사용합니다.
  • 05마우스 휠과 키보드 스크롤을 지원하는 5가지 기본 색상 테마를 제공합니다.

활용 사례

  • SSH로 서버의 CPU, 메모리, 부하를 모니터링합니다.
  • CI 상태나 큐 길이 같은 사용자 지정 셸 명령의 출력을 터미널 패널에 표시합니다.
  • 개발 머신의 로그와 차트를 보여주는 개인 상태 화면을 구성합니다.

빠른 시작

  1. 1

    저장소에서 한 번 실행해 스크립트에 실행 권한을 부여합니다

    chmod +x scripts/*.sh
  2. 2

    대시보드를 실행합니다

    go run .
  3. 3

    선택 사항: 번들로 제공되는 예제 설정 파일을 기본 경로에 복사합니다

    go run . --init

사용 전 알아둘 점

  • Go 1.25 이상이 필요합니다.
  • 라이선스가 지정되어 있지 않아 사용 권한이 불분명합니다.

토픽

자주 묻는 질문

tui-dashboard은(는) 무엇인가요?
Bubble Tea 기반의 설정형 터미널 대시보드로, YAML 파일 하나로 셸 명령 데이터 소스와 위젯 그리드를 정의합니다. tui-dashboard를 사용하면 Go 코드를 작성하지 않고도 실시간 터미널 대시보드를 만들 수 있습니다. YAML 파일 하나에 데이터 소스와 레이아웃을 선언합니다. 데이터 소스는 일정한 간격으로 실행되는 셸 명령이며, 레이아웃은 각 데이터 소스의 출력을 표시하는 위젯을 행 단위로 배치합니다.
tui-dashboard은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
tui-dashboard에는 명시된 라이선스가 없습니다. 코드는 공개되어 있지만 라이선스가 없으면 재사용 허가가 명확하지 않으므로, 사용 전에 작성자에게 문의하는 것이 좋습니다.
tui-dashboard은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. tui-dashboard의 마지막 커밋은 2026년 10월 16일입니다.
tui-dashboard은(는) 어디에 사용할 수 있나요?
SSH로 서버의 CPU, 메모리, 부하를 모니터링합니다. CI 상태나 큐 길이 같은 사용자 지정 셸 명령의 출력을 터미널 패널에 표시합니다. 개발 머신의 로그와 차트를 보여주는 개인 상태 화면을 구성합니다.
tui-dashboard는 어떻게 설치하나요?
저장소에서 한 번 실행해 스크립트에 실행 권한을 부여합니다: chmod +x scripts/*.sh 대시보드를 실행합니다: go run . 선택 사항: 번들로 제공되는 예제 설정 파일을 기본 경로에 복사합니다: go run . --init
tui-dashboard은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/lyuangg/tui-dashboard

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트