`LunarLauncher`는 Android 홈 런처를 중심으로 RSS/커뮤니티 피드, 웹 리더(GeckoView/WebView), 토렌트 및 미디어 다운로드, 네이티브 FFmpeg 기반 미디어/문서/이미지 뷰어, 라이브 월페이퍼, Google Drive 백업, Wear OS 제스처 연동을 통합한 멀티 모듈 Android 프로젝트입니다.
├── settings/ # 런처 및 하위 카테고리별 설정 Activity/Fragment
├── utils/ # 한글 초성/자모 변환, 파일/이미지/인코딩/Jsoup 유틸리티
├── view/ # 커스텀 UI 뷰 (FloatingActionMenu, LunaticBrowserLayout, ZoomImageView 등)
├── wall/ # 라이브 월페이퍼 서비스(MyWallpaperService) 및 JNI 브리지(NativeRenderer)
└── workers/ # Realm DB(WorkersDb), 백그라운드 수집기(*Getter), 토렌트/위치/워치 서비스
```
---
## 3. 핵심 컴포넌트 역할 요약
### 3.1. Activity
- **`LauncherActivity`**: `MAIN` / `HOME` / `LAUNCHER` 인텐트를 처리하는 메인 홈 런처. 앱 위젯 호스트, 앱 서랍(`AppDrawerBottomSheet`), 키보드/게임패드/리모트 입력 및 `SEND`/`SEND_MULTIPLE` 공유 수신을 담당합니다.
- **`NeoRssActivity`**: RSS/커뮤니티 피드(`RssHome`), 웹/콘텐츠 리더(`TokiFragment`) 등을 호스팅하며 `WEB_SEARCH` 및 `SEND` 인텐트를 처리합니다.
- **`WebReaderActivity`**: 별도 런처 아이콘(`리더`)으로 실행되는 WebView 기반 웹 리더. 파일 업로드/백업 복원(`ActivityResultContracts`) 및 JS 브리지를 제공합니다.
- **`CompletedFilesActivity`**: 별도 런처 아이콘(`파일즈`)으로 실행되는 다운로드/완료 파일 탐색기. 파일 목록 조회, 미리보기, 문서/이미지 뷰어 연동을 수행합니다.
- **`TranslatorActivity`**: ML Kit 언어 식별(`LanguageIdentification`) 및 번역(`Translation`), Android `TextToSpeech`를 연동한 번역기 화면입니다.
- **`PlayerActivity`**: `TextureView`와 `NativePlayer`를 사용해 동영상을 재생하는 플레이어. 외부/내장 자막 동기화 및 ML Kit 기반 자막 실시간 번역, 재생 오류 시 엔진 복구(`rebootEngine`)를 지원합니다.
- **`DocumentViewerActivity`**: `PageIndexer`와 `PagedTextLayout`을 이용해 대용량 텍스트 문서를 인코딩 감지 후 페이지 단위로 렌더링하는 뷰어입니다.
- **`ImageViewerActivity`**: `PhotoView`와 `ExifInterface`를 이용해 이미지 확대/축소 및 EXIF 메타데이터 오버레이를 제공합니다.
- **`SettingsActivity` / `home.tokiz.Settings`**: 런처 전반 설정(`APPLICATION_PREFERENCES`) 및 리더 전용 설정 화면입니다.
### 3.2. 주요 Fragment & BottomSheet
- **`RssHome` / `RssViewer` / `BookmarkPagerFragment`**: 홈 피드, RSS 기사 뷰어, 북마크 페이저 UI.
- **`CompletedFilesFragment` / `TorrentListFragment` / `SystemStatusFragment` / `LearningFragment`**: 완료 파일 목록, 토렌트 진행 목록, 시스템 상태, 학습/단어장 화면.
- **`TokiFragment` / `RemoteGestureFragment`**: 텍스트/웹 콘텐츠 리더 및 워치/리모트 제스처 연동 Fragment.
- **`AppDrawer` / `AppDrawerBottomSheet` / `SearchBottomSheet` / `WebBottomSheet` / `VideoPreviewBottomSheet`**: 앱 서랍, 통합 검색, 인앱 웹 바텀시트, 영상 미리보기 시트.
### 3.3. Service & BroadcastReceiver
- **`ForeGroundService`**: `youtubedl-android`(yt-dlp) 및 OkHttp를 활용한 영상/파일 다운로드, 블루투스/미디어 버튼 처리, WorkManager 작업 스케줄링을 담당하는 포그라운드 서비스.
- **`TorrentService`** (`workers/TorrentManager.kt`): `jlibtorrent` 기반 토렌트 다운로드 포그라운드 서비스. Wi-Fi 및 충전 상태에 따라 세션을 제어하고, 미리보기용 핵심 피스 우선 다운로드(`previewPiecesMap`)를 지원합니다.
- **`MyWallpaperService`**: `WallpaperService` 구현체로, C++ `NativeRenderer`를 통해 라이브 월페이퍼 표면을 렌더링하고 날씨 비트맵/미디어 전환을 처리합니다.
- **`NLService`**: `NotificationListenerService`로 외부 앱 알림을 수집·가공하여 Realm DB 및 로그에 기록합니다.
- **`WatchGestureService`**: `WearableListenerService`로 Wear OS 앱(`:lun_launcher`)에서 보낸 `/gesture/next`, `/gesture/prev` 등의 메시지를 수신합니다.
- **`LocationUpdateService`**: 위치 변경을 수신하고 `Geocoder`로 주소를 변환해 Realm `LocationLog`에 저장합니다.