# 스크린 타임

연결부터 문제 해결까지, 스크린 타임 내보내기가 작동하는 방식입니다.

## 연결

스크린 타임 카드에서 “연결”을 누릅니다. 패널이 macOS가 스크린 타임을 보관하는 Knowledge 폴더인 `~/Library/Application Support/Knowledge`에서 열리면 “이 폴더 선택”을 누릅니다. 그다음 “내보낼 폴더 선택”을 누릅니다.

## 파일이 저장되는 위치

날짜마다 그 날짜로 이름을 붙인 Markdown 파일 하나(`2026-09-01.md`)와, 그 옆에 `summary.md`가 생깁니다. `~/Documents`처럼 홈 폴더 바로 아래의 폴더를 고르면 그 안에 `screen-time-export` 폴더가 생기고, `~/Documents/screen-time`처럼 더 깊은 폴더는 그대로 사용됩니다.

## 내보내지는 것

카드에서 선택한 날짜입니다. 탭은 목록을 정렬하기만 합니다: “일별”(모든 날짜, 최신순), “최근”(지난 7일), “최다”(스크린 타임이 가장 긴 날).

macOS는 스크린 타임을 약 4주 동안 보관합니다. Exporter는 날짜 파일을 절대 지우지 않으므로 내보내기는 그 기간을 넘어 계속 늘어나며, 이 폴더가 오래된 날짜의 유일한 사본이 됩니다. 내보내기 전에 macOS가 지운 날짜는 내보낼 수 없습니다.

날짜 파일에는 네 섹션이 있습니다. App Usage(1분 이상 사용한 모든 앱과 그 시간 및 세션), Web Usage(도메인별 시간과 방문 수), Notifications(앱별 개수), Screen Sessions(화면이 켜지고 꺼진 시각과 합계)입니다. `summary.md`에는 최근 동기화가 읽은 날짜들, 대략 최근 4주에 대한 Top Apps와 Daily Totals가 담깁니다.

## 형식

항상 Markdown입니다. 표로 되어 있고, 그날의 합계는 프런트매터에 있습니다.

## 파일

| 키 | 담는 내용 |
| --- | --- |
| `title` | `Screen Time`과 날짜 |
| `id`, `created`, `modified` | 날짜 |
| `tags` | `screen-time` |
| `total_screen_time` | 그날의 합계. 예: `3h 51m` |
| `apps_used`, `domains_visited` | 앱과 웹사이트 수 |

```markdown
---
title: "Screen Time 2026-09-01"
id: "2026-09-01"
created: 2026-09-01T00:00:00
modified: 2026-09-01T00:00:00
tags:
  - "screen-time"
total_screen_time: "3h 51m"
apps_used: 4
domains_visited: 2
---

## App Usage

| App | Duration | Sessions |
|-----|----------|----------|
| Xcode | 2h 4m | 6 |
| Safari | 1h 21m | 11 |
```

## 무료와 잠금 해제

첫 동기화 때 선택되어 있던 가장 최근 10일이 무료 날짜이며, 이 무료 10일은 바뀌지 않습니다. 이후 날짜에는 일회성 잠금 해제가 필요합니다([가격](https://exporter.dev/pricing)). 다른 날짜를 무료로 고르려면 첫 동기화 전에 선택을 해제하세요.

## 동기화와 전체 재동기화

처음 “지금 동기화”를 누른 뒤로는 Exporter가 실행 중인 동안 최대 1분에 한 번 새 날짜를 추가합니다.

“전체 재동기화”는 먼저 확인을 요청한 다음, 모든 날짜 파일을 포함해 Exporter가 쓴 파일을 지우고 macOS에 아직 남아 있는 것을 다시 내보냅니다. macOS가 이미 지운 날짜는 돌아오지 않습니다. 이 버튼을 누르기 전에 반드시 폴더를 백업하세요.

## 문제와 해결 방법

- “해당 폴더에 knowledgeC.db가 없습니다 (Knowledge 폴더 자체를 선택하세요)”: “연결”을 다시 누르고, 패널이 열린 폴더를 선택하세요
- 새 날짜가 더 이상 들어오지 않음: 무료 10일을 다 썼습니다. 스크린 타임을 잠금 해제하고 “지금 동기화”를 누르세요
- 처음부터 빠진 날짜가 있음: macOS가 이미 지운 날짜입니다
- `summary.md`에 최근 몇 주만 담김: 최근 동기화가 읽은 날짜를 합산하기 때문입니다. 나머지는 날짜 파일에 남아 있습니다

## Related

- [Screen Time](https://exporter.dev/screen-time): Screen Time as one file per day
- [Screen Time guides](https://exporter.dev/guides/screen-time): Keep every day as a file
- [Getting started](https://exporter.dev/docs/getting-started): Install, connect, first export

---

human version: https://exporter.dev/ko/docs/screen-time
every page: https://exporter.dev/llms.txt