KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #ai-agents #dsh-plugin #codex #developer-tools #claude-code #windows #cli #desktop-app #typescript #rust #ai-agent

stats

★ 41,226 Open GitHub ↗

메뉴 바에서 사용하는 macOS 시스템 모니터

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Stats

[![Stats](https://serhiy.s3.eu-central-1.amazonaws.com/Github_repo/stats/menus%3Fv2.3.2.png?v1)](https://github.com/exelban/stats/releases)
[![Stats](https://serhiy.s3.eu-central-1.amazonaws.com/Github_repo/stats/popups%3Fv2.3.2.png?v3)](https://github.com/exelban/stats/releases)

메뉴 바에서 사용하는 macOS 시스템 모니터

## Installation
### Manual
최신 버전을 [여기](https://github.com/exelban/stats/releases/latest/download/Stats.dmg)에서 다운로드할 수 있습니다.
`Stats.dmg` 파일이 다운로드됩니다. 파일을 열고 앱을 응용 프로그램 폴더로 이동시키세요.

### Homebrew
Homebrew를 사용하여 설치하려면 Terminal 앱을 열고 다음을 입력하세요:
```bash
brew install stats
```

### Uninstall
앱에 포함된 제거 스크립트를 실행하세요 (SMC helper를 제거하려면 관리자 권한이 필요합니다):
```bash
sh /Applications/Stats.app/Contents/Resources/Scripts/uninstall.sh
```
이 스크립트는 Stats를 종료하고 다음 항목을 제거합니다:

- SMC helper (`/Library/LaunchDaemons/eu.exelban.Stats.SMC.Helper.plist` 및 `/Library/PrivilegedHelperTools/eu.exelban.Stats.SMC.Helper`)
   - `Stats.app`
   - 애플리케이션 데이터 및 환경 설정 (`~/Library/Application Support/Stats`, 위젯 컨테이너 및 `eu.exelban.Stats` 기본값)

앱이 이미 휴지통으로 이동된 경우, 저장소에서 직접 스크립트를 실행할 수 있습니다:
```bash
curl -fsSL https://raw.githubusercontent.com/exelban/stats/master/Kit/scripts/uninstall.sh | sh
```

### Legacy version
이전 시스템을 위한 Legacy 버전은 [여기](https://mac-stats.com/downloads)에서 확인하실 수 있습니다.

## Requirements
Stats는 macOS 12 (Monterey) 이상 버전에서 지원됩니다.
macOS Beta 버전은 지원되지 않으며, 정식 출시 버전만 지원합니다.

## Features
Stats는 macOS 시스템을 모니터링할 수 있는 애플리케이션입니다.

- CPU 사용률
 - GPU 사용률
 - 메모리 사용량
 - 디스크 사용률
 - 네트워크 사용량
 - 배터리 잔량
 - 팬 제어 (유지 관리되지 않음)
 - 센서 정보 (온도/전압/전력)
 - Bluetooth 기기
 - 다중 시간대 시계

## FAQs

### 메뉴 바 아이콘의 순서를 어떻게 변경하나요?
메뉴 바 항목의 순서는 `Stats`가 아니라 macOS가 결정합니다. Stats 설치 후 첫 번째 재부팅 후에 순서가 변경될 수 있습니다.

메뉴 바 아이콘의 순서를 변경하는 방법 - macOS Mojave (버전 10.14) 이상:

1. ⌘ (커맨드 키)를 누른 상태로 유지합니다.
2. 아이콘을 메뉴 바의 원하는 위치로 드래그합니다.
3. ⌘ (커맨드 키)를 뗍니다.

### 메뉴 바에 Stats 아이콘이 나타나지 않습니다
macOS 26에서는 System Settings → Menu Bar에서 새로운 개인정보 보호 제어 기능이 도입되었습니다. 메뉴 바 항목을 표시하려면 여기서 앱을 명시적으로 허용해야 합니다. Stats가 최소 하나 이상의 모듈이 활성화되어 있고 위젯이 사용 설정된 상태로 실행 중임에도 아이콘이 보이지 않는다면, 거의 확실히 이 문제 때문입니다. 자세한 내용은 [여기](https://github.com/exelban/stats/issues/3120)에서 확인하세요.

**해결 방법:** **System Settings → Menu Bar**를 열고 **Stats**를 ON으로 설정하세요.

### 데스크톱 위젯에 데이터가 표시되지 않습니다
앱과 위젯 간의 통신을 담당하는 시스템 프로세스(`chronod`)의 높은 데이터 부하 문제로 인해, Stats 측에서 통신이 기본적으로 비활성화되어 있습니다. 이를 활성화하려면 Stats 설정에서 `macOS widgets` 옵션을 켜야 합니다. 자세한 내용은 [여기](https://github.com/exelban/stats/issues/2733)에서 확인하세요.

**해결 방법:** **Stats Settings**를 열고 **macOS widgets**를 ON으로 설정하세요.

### Stats의 에너지 영향이나 CPU 사용량을 어떻게 줄이나요?
Stats는 최대한 효율적으로 작동하도록 설계되었습니다. 하지만 주기적으로 데이터를 읽는 작업은 리소스 소모가 발생합니다. 각 모듈마다 소모되는 "비용"이 다릅니다. 따라서 Stats의 에너지 영향을 줄이려면 일부 모듈을 비활성화해야 합니다. 가장 효율성이 낮은 모듈은 Sensors와 Bluetooth입니다. 이 모듈들을 비활성화하면 경우에 따라 CPU 사용량과 전력 효율을 최대 50%까지 개선할 수 있습니다.

### 팬 제어 (Fan control)
팬 제어 기능은 legacy 모드입니다. 더 이상 업데이트나 수정이 이루어지지 않습니다. 다만 오래된 Mac에서는 상당히 괜찮게 작동하기 때문에 앱에서 완전히 삭제하지는 않았습니다. 이 기능에 대해 도움을 주실 분이 있다면 Pull Request(PR)를 통한 수정이나 개선 사항 제안을 환영합니다. 하지만 제가 직접 이 기능에 대한 지원을 제공할 시간과 여력은 없는 상태입니다.

### 센서에 CPU/GPU 코어 수가 잘못 표시됩니다
CPU/GPU 센서는 단순히 CPU/GPU의 열 구역(센서)입니다. 코어 수나 특정 코어와는 관련이 없습니다.
예를 들어, CPU는 일반적으로 효율 코어와 성능 코어의 두 클러스터로 나뉩니다. 각 클러스터에는 여러 개의 온도 센서가 포함되어 있으며, Stats는 단순히 이 센서들을 표시합니다. 따라서 "CPU Efficient Core 1"은 단일 효율 코어의 온도를 나타내는 것이 아니라, 효율 코어 클러스터 내의 온도 센서 중 하나를 나타낼 뿐입니다.
또한 Apple은 새로운 SoC가 나올 때마다 센서 키를 변경합니다. 결과적으로 어떤 SMC 값이 적절한 센서에 대응하는지 확인하는 데 시간이 걸립니다. Apple Silicon의 센서를 정확하게 매칭하는 방법을 아시는 분은 저에게 연락 부탁드립니다.

### 앱이 충돌합니다 – 어떻게 해야 하나요?
먼저 최신 버전의 Stats를 사용하고 있는지 확인하세요. 충돌을 방지하는 수정 사항이 이미 출시되었을 가능성이 큽니다. 이미 최신 버전을 사용 중이라면 open issues를 확인하세요. 기존 이슈 중에 해결 방법이 없는 경우에만 새로운 이슈를 생성해 주세요.

### 왜 내 이슈가 답변 없이 닫혔나요?
중복된 이슈이거나, 질문, 보고 또는 제안에 대한 답변이 이미 다른 곳에 있기 때문일 가능성이 높습니다. 닫힌 이슈에서 검색하여 답변을 찾아보시기 바랍니다.
따라서 답변 없이 이슈가 닫혔다면, 이미 어딘가에 답변이 존재할 가능성이 매우 높습니다.

### 외부 API
Stats는 텔레메트리나 분석 데이터를 수집하지 않습니다. Stats가 요청하는 유일한 외부 API는 다음과 같습니다:

- https://api.mac-stats.com – 업데이트 확인 및 공인 IP 주소 검색용
- https://api.github.com – 업데이트 확인 실패 시 대체용

두 API 모두 업데이트 확인을 위해 사용됩니다. 또한, 공인 IP 주소를 얻기 위해 외부 요청이 필요합니다. 공인 IP 주소를 가져오기 위해 제3자 제공업체를 사용하고 싶지 않아 개인 서버를 사용하고 있습니다.

이러한 요청이 우려된다면 다음과 같은 방법이 있습니다:

- 외부 서버 없이도 이 기능들이 작동하도록 PR을 제안해 주세요.
- 네트워크 필터링 앱(예: Little Snitch)을 사용하여 두 서버를 모두 차단하세요. 이 경우 업데이트를 받을 수 없으며 네트워크 모듈에서 공인 IP를 확인할 수 없게 됩니다.

### 프로젝트에 어떻게 기여하나요?
새로운 기능을 개발하고 싶거나 작동하지 않는 부분을 발견했다면, 먼저 이슈를 생성하여 해당 기능이나 문제에 대해 논의하는 것이 첫 번째 단계입니다. Pull requests는 논의를 거친 후 기존 이슈에 대해서만 열어야 하며, 그렇지 않으면 자동으로 닫힐 수 있습니다. 다만 언어 변경, 또는 이미 상당한 기여를 하여 구현 방식이 프로젝트와 잘 맞는 기여자의 경우에는 이 과정을 생략할 수 있습니다.

## Open source, but not open contribution
Stats는 오픈 소스 프로젝트입니다. 전체 소스 코드는 MIT 라이선스 하에 공개되어 있으며, 누구나 코드를 읽고, 학습하고, 포크하여 자신만의 버전의 앱을 빌드할 수 있습니다.

하지만, 모든 기여를 무조건적으로 수용하는 프로젝트는 아닙니다. Stats는 한 사람에 의해 개발 및 유지 관리되며, 모든 제안된 변경 사항을 수용하는 것보다 프로젝트의 안정성과 일관성을 유지하는 것을 우선시합니다. 외부 코드를 검토하고, 다양한 Mac 및 macOS 버전에서 테스트하며, 이후에 유지 관리하는 작업은 처음부터 직접 작성하는 것보다 더 많은 시간이 걸리는 경우가 많습니다.

그렇기 때문에 요청되지 않은 pull requests는 일반적으로 수용되지 않으며 검토 없이 닫힐 수 있습니다. 무언가를 변경하거나 추가하고 싶다면 먼저 이슈를 생성하여 논의해 주세요. 단, 번역 및 언어 수정은 언제나 환영하며, 이미 프로젝트에 크게 기여한 분들의 기여는 예외로 합니다.

프로젝트를 지원하는 가장 좋은 방법은 버그 제보, 번역 개선, 그리고 이슈를 통한 아이디어 제안입니다.

## Supported languages
- English
- Polski
- Українська
- Русский
- 中文 (简体) (thanks to [chenguokai](https://github.com/chenguokai), [Tai-Zhou](https://github.com/Tai-Zhou), and [Jerry](https://github.com/Jerry23011))
- Türkçe (thanks to [yusufozgul](https://github.com/yusufozgul) and [setanarut](https://github.com/setanarut))
- 한국어 (thanks to [escapeanaemia](https://github.com/escapeanaemia) and [iamhslee](https://github.com/iamhslee))
- German (thanks to [natterstefan](https://github.com/natterstefan) and [aneitel](https://github.com/aneitel))
- 中文 (繁體) (thanks to [iamch15542](https://github.com/iamch15542) and [jrthsr700tmax](https://github.com/jrthsr700tmax))
- Spanish (thanks to [jcconca](https://github.com/jcconca))
- Vietnamese (thanks to [HXD.VN](https://github.com/xuandung38))
- French (thanks to [RomainLt](https://github.com/RomainLt))
- Italian (thanks to [gmcinalli](https://github.com/gmcinalli))
- Portuguese (Brazil) (thanks to [marcelochaves95](https://github.com/marcelochaves95) and [pedroserigatto](https://github.com/pedroserigatto))
- Norwegian Bokmål (thanks to [rubjo](https://github.com/rubjo))
- 日本語 (thanks to [treastrain](https://github.com/treastrain))
- Portuguese (Portugal) (thanks to [AdamModus](https://github.com/AdamModus))
- Czech (thanks to [mpl75](https://github.com/mpl75))
- Magyar (thanks to [moriczr](https://github.com/moriczr))
- Bulgarian (thanks to [zbrox](https://github.com/zbrox))
- Romanian (thanks to [razluta](https://github.com/razluta))
- Dutch (thanks to [ngohungphuc](https://github.com/ngohungphuc))
- Hrvatski (thanks to [milotype](https://github.com/milotype))
- Danish (thanks to [casperes1996](https://github.com/casperes1996) and [aleksanderbl29](https://github.com/aleksanderbl29))
- Catalan (thanks to [davidalonso](https://github.com/davidalonso))
- Indonesian (thanks to [yooody](https://github.com/yooody))
- Hebrew (thanks to [BadSugar](https://github.com/BadSugar))
- Slovenian (thanks to [zigapovhe](https://github.com/zigapovhe))
- Greek (thanks to [sudoxcess](https://github.com/sudoxcess) and [vaionicle](https://github.com/vaionicle))
- Persian (thanks to [ShawnAlisson](https://github.com/ShawnAlisson))
- Slovenský (thanks to [martinbernat](https://github.com/martinbernat))
- Thai (thanks to [apiphoomchu](https://github.com/apiphoomchu))
- Estonian (thanks to [postylem](https://github.com/postylem))
- Hindi (thanks to [patiljignesh](https://github.com/patiljignesh))
- Finnish (thanks to [eightscrow](https://github.com/eightscrow))
- Bengali (thanks to [adnan29979](https://github.com/adnan29979))
- Tamil (thanks to [sabapathy7](https://github.com/sabapathy7))

새로운 언어를 추가하거나 기존 번역을 개선하여 도움을 주실 수 있습니다.

## License
[MIT License](https://github.com/exelban/stats/blob/master/LICENSE)

stats

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README