Clean Your TV — for LG webOS
메뉴
언어: 한국어

Clean Your TV — 사용자 안내

아직 출시되지 않은 설치 프로그램 변경: 새 설치 전에 컴퓨터 설치 프로그램이 GitHub에서 최신 안정 버전을 확인합니다. “GitHub에서 최신 버전 다운로드”를 선택하면 설치를 멈추고 다운로드 페이지를 엽니다. “아니요, 이 버전 설치”를 선택하면 명시적으로 계속합니다. 확인에 실패해도 계속할 수 있습니다. 미완료 작업과 복구는 확인을 건너뜁니다.

Clean Your TV는 LG webOS TV를 위한 나만의 홈 화면입니다. 이 메뉴에서는 광고 행 없이 원하는 순서로 앱을 배치할 수 있습니다. 컴퓨터나 Android 휴대전화로 설치하고, 설정이 끝나면 컴퓨터를 꺼도 됩니다.

1. 설치 프로그램 다운로드

기기에 맞는 그림을 누르세요. 버튼은 최신 공개 버전을 다운로드합니다. Mac은 Apple Silicon(M1 이상) 또는 Intel을 선택하세요. Apple 메뉴 → 이 Mac에 관하여에서 확인할 수 있습니다.

다운로드 — Windows x64 다운로드 — macOS Apple Silicon 다운로드 — macOS Intel 다운로드 — Linux x64 다운로드 — Android ARM64

2. 에디션 선택

TV를 켜고 컴퓨터 또는 휴대전화와 같은 홈 네트워크에 연결하세요. 요청이 나오면 CYTV의 로컬 네트워크 접근을 허용하세요.

  • No-root — root 권한이 없는 TV입니다. 아래 순서대로 Developer Mode를 준비하세요.
  • Root — 이미 SSH root 접근이 가능한 TV입니다. 설치 프로그램은 TV를 루팅하지 않습니다. 이 TV에서는 Developer Mode를 켜지 말고 SSH 접근과 복구 데이터를 보존하세요.

Root에서는 설치 프로그램이 사용 가능한 Home 제어 방식을 확인하고 선택합니다. 호환성을 확인할 수 없으면 설치가 중지됩니다. 실패한 검사를 우회하지 마세요.

No-root → Root: 전체 제거 후 No-root를 다시 설치했다면 Root로 전환하기 전에 정리가 필요할 수 있습니다. Home 환경설정을 백업하고 저장된 Root 연결로 Clean Your TV 제거를 선택한 뒤 제거 확인이 끝날 때까지 기다리세요. No-root Home과 Helper도 제거됩니다. 그다음 Root를 설치하고 복구 기록은 보관하세요.

Developer Mode 설정 (No-root)

Developer Mode를 사용하면 root 없이 TV에 CYTV 앱을 설치할 수 있습니다.

  1. TV에서 LG Apps를 열고 Developer Mode를 검색하여 설치하세요.
  2. Developer Mode를 열고 LG Developer 계정으로 로그인하세요. 계정이 없으면 LG Developer에서 만드세요.
  3. Dev Mode Status를 켜세요. TV가 재시작되면 Developer Mode를 다시 여세요.
  4. Key Server를 켜고 Developer Mode를 열어 두세요. 표시된 IP Address를 CYTV의 TV 주소로 입력하세요.
  5. TV의 Developer Mode에 표시된 6자리 Passphrase를 입력하세요. 대소문자를 구분하세요.

LG 계정 비밀번호가 아닌 TV 화면의 코드를 사용하세요. 코드가 보이지 않으면 Key Server를 켜세요.

페어링은 별도 단계입니다. TV에서 요청하면 리모컨으로 CYTV를 승인하세요.

타이머가 끝나기 전에 Developer Mode를 열고 TV가 인터넷에 연결된 상태에서 EXTEND를 누르세요. 만료되면 LG가 이 앱들을 삭제할 수 있습니다.

3. 설치 프로그램 열기

  • Windows x64: cytv-windows-x64-desktop.zip을 다운로드하고 파일 탐색기에서 모두 추출을 선택한 다음 cytv-desktop/cytv-desktop.exe를 여세요. _internal 폴더를 옆에 그대로 두세요.
  • macOS 13 이상: Apple Silicon은 cytv-macos-arm64.zip, Intel은 cytv-macos-x64.zip을 푸세요. cytv.app을 응용 프로그램 폴더로 옮겨 열고 로컬 네트워크 접근을 허용하세요. 신뢰할 수 있는 다운로드가 차단되면 개인정보 보호 및 보안 → 확인 없이 열기를 사용하세요. Gatekeeper를 끄지 마세요.
  • Linux x64: Ubuntu 22.04 이상, Debian 12 이상 또는 Mint 21 이상에서 cytv-linux-x64.deb를 그래픽 패키지 관리자로 설치하고 앱 메뉴에서 Clean Your TV를 여세요. 라이브러리 설치에 인터넷이 필요할 수 있습니다. Linux ARM 패키지는 없습니다.

Android ARM64: Android 7 이상, WebView/Chrome 108 이상인 64비트 ARM 휴대전화가 필요합니다. 다운로드한 APK를 열고 요청이 나오면 해당 출처의 앱 설치를 허용하세요. CYTV를 열고 오른쪽 위에서 언어를 선택하세요. 앱 삭제나 데이터 초기화 없이 업데이트하세요.

데스크톱 설치 마법사는 처음에 시스템 언어를 사용하고 직접 선택한 언어를 저장합니다. TV에서는 설정 → 언어에서 언어를 고르거나 시스템 언어를 따르는 자동 옵션을 선택하세요. 설치 프로그램과 TV의 언어 설정은 별개입니다. 지원 코드는 언어 목록을 참조하세요.

4. TV에 설치

  1. CYTV에서 내 TV 설정을 선택하세요. 컴퓨터에서는 검색된 TV를 선택하고 Android에서는 TV IP 주소를 입력하세요. 검색되지 않으면 주소를 직접 입력하세요.
  2. No-root 또는 Root를 선택하고 TV가 맞는지 확인하세요.
  3. No-root는 Developer Mode 화면의 코드를 입력하고 TV의 요청을 승인하세요. Root는 기존 SSH 인증 정보를 사용하세요. 신뢰하는 네트워크에서 본인 TV의 새 SSH 신원만 승인하세요. 저장된 키가 바뀌면 중지하고 원인을 확인하세요.
  4. 마법사의 안내를 따르세요. 끝날 때까지 TV를 켜 두고 네트워크를 바꾸거나 CYTV를 닫지 마세요. Android 앱을 강제 종료하지 마세요. Root는 복구 준비 직후 Home 제어를 켭니다.

TV 입력 목록을 읽지 못해도 앱 목록이 유효하면 Root 설치가 경고와 함께 계속됩니다. Home에 입력이 표시되지 않을 수 있습니다. 앱 목록을 읽지 못하거나 목록이 비어 있으면 설치는 계속 중단됩니다. 경고가 반복되면 진단 보고서를 저장하세요.

5. 리모컨 확인

  1. TV에서 다른 앱을 열고 Home을 짧게 누르세요. Clean Your TV가 열려야 합니다. 마법사에서 실제로 본 결과를 선택하고, 확인하지 않았다면 건너뛰세요.
  2. 방향키, OK, 뒤로, 음량과 소리를 확인하세요. 대기/깨우기와 전원을 분리한 뒤 시작하는 동작은 따로 확인하세요. 설치 성공만으로 이 동작들이 확인되지는 않습니다.

No-root 설정은 패키지 확인 후 Home을 켭니다. 설정 중 새로운 중지가 발생하면 활성화가 취소됩니다. 나중에 설정에서 Home을 끌 수 있습니다.

원래 저장된 연결과 복구 데이터를 사용하세요. 잃어버렸다면 같은 TV에 다시 연결하고 Clean Your TV 제거를 선택하세요. 설정 전에 검증된 제거를 완료하고 예약 파일은 삭제하지 마세요. 제거가 멈추면 진단 보고서를 저장하세요.

6. 사용과 복구

설치 프로그램에 “Root 설정이 완료되지 않았지만 TV에 설치 기록이 없습니다.”가 표시되면: 복구 옵션 검토를 선택하여 Clean Your TV를 제거한 후 설정을 별도로 시작하세요. 전체 제거는 No-root Home과 Helper도 제거하므로 먼저 환경설정을 백업하세요.

No-root IR 지원: Home을 짧게 눌렀다 놓으면 약 700ms 후 Clean 실행을 예약하며, LG Home이 먼저 잠깐 보일 수 있습니다. Home 길게 누르기는 webOS가 처리하고, 세 번 누르면 여전히 Helper가 중지됩니다. 일반 Developer Mode TV의 접근 권한은 검증되지 않았으므로 입력 장치 권한을 변경하지 마세요.

방향키로 선택하고 OK로 실행합니다. OK를 길게 눌러 순서를 바꿉니다. 뒤로를 짧게 누르면 앱의 탐색과 종료 확인이 유지됩니다. Home 제어가 활성화되면 짧은 Home으로 런처를 엽니다. 뒤로를 1.2초 동안 누르면 LG Home이 한 번 열립니다. Home 제어 스위치와 설정은 바뀌지 않습니다.

2초 안에 Home을 세 번 짧게 누르세요. 매번 버튼을 놓아야 합니다. 설정을 지우지 않고 LG Home으로 복귀하며 Home 제어를 중지합니다.

No-root: Home 제어를 다시 시작하려면 Home Helper를 열고 Helper 시작을 선택한 다음 확인하세요. 저장된 Home 화면 선택은 유지됩니다. Root는 Home 설정에서 Home 변경을 켜서 재개하세요. LG Home 열기는 Home의 연결 대상을 바꾸지 않고 LG Home을 한 번 엽니다. LG Home을 계속 사용할 기본 대상으로 복원하려면 Home 변경을 끄세요. 두 제어 프로그램을 동시에 실행하지 마세요. 문제가 반복되면 LG Home을 유지하세요.

TV의 자동 업데이트는 중지된 Helper를 다시 시작하지 않습니다. 별도로 재개하려면 Helper 시작을 사용하고 중지 파일은 삭제하지 마세요.

도움이 필요하신가요?

초기화 또는 SSH 변경 후 ssh-identity-changed가 표시되면 중단하세요. CYTV는 로그인 전에 저장된 키의 변경을 차단했습니다. 최초 신뢰 확인으로 기존 키를 교체할 수 없으며, 대기 중인 제거 작업은 키 불일치의 원인이 아닙니다. 원래 저장 프로필, 키, 복구 기록을 보존하세요. 자동으로 다시 신뢰하는 지원 명령은 없습니다. TV 신원과 지문을 독립적으로 확인한 뒤 프로필을 보존하는 검토된 절차가 필요합니다. SSH 신원 변경 복구를 참고하세요.

설치가 중단되면 같은 저장된 연결로 TV 상태 확인을 먼저 선택하세요. 마법사가 제공하는 복구 작업으로만 계속하세요. 상태를 알 수 없으면 진단 보고서를 저장하고 중지하세요. 복구 데이터를 보존하고 무작정 재설치하지 마세요.

복구 중에는 Home 제어를 끈 상태로 두고 원래 진단 보고서와 저장된 연결을 보존하세요. 검사와 변경은 각각 따로 확인하세요. 설치된 버전에 맞는 자세한 복구 안내를 따르고, 강제로 재설치하거나 복구 상태를 지우지 마세요.

TV 모델, 펌웨어, No-root 또는 Root, 설치 기기, 실패한 단계와 오류 메시지를 알려 주세요. 보고서를 공유하기 전에 비밀번호, 키, 주소와 개인 정보를 제거하세요. 보고서는 자동 공개되지 않습니다.

문제 신고 · 자세한 복구 — 영어 · 업데이트 및 삭제 — 영어 · 다른 언어

간단한 제거

동일한 저장된 TV 연결로 유지관리의 Clean Your TV 제거를 선택하세요. 한 번 확인하면 존재하는 알려진 프로젝트 앱과 파일을 제거하고 없는 항목은 건너뜁니다. 부분 설치 후에도 사용할 수 있습니다.

별도의 LG Home 앱이 없는 구형 TV에서는 No-root 제거 중 실시간 TV로 전환될 수 있습니다. TV를 켜 두고 안내에 따라 재시작하세요. 복구 데이터를 삭제하거나 TV를 초기화하지 마세요.

안내가 나오면 TV 전원을 분리했다가 다시 연결하고 네트워크를 기다린 후 다시 시도를 선택하세요. 대기 모드나 Quick Start는 완전한 재시작이 아니며 CYTV가 TV를 자동으로 재시작하지 않습니다. 연결이 끊기면 확인 후 별도 복구 마법사 없이 같은 제거를 다시 시도하세요. 접근이 거부되면 요청된 Root 연결을 사용하고 TV가 사용 중이면 기다린 후 다시 시도하세요. 최종 정리가 검증된 후에만 성공으로 표시됩니다. 키와 원본 보고서를 보관하세요. 위 비상 제어와 공유 동의는 계속 적용됩니다.

설치 프로그램이 요청한 완전한 재시작을 확인하지 못하면 진단 보고서를 저장하여 첨부하세요. 저장된 연결과 복구 데이터를 보관하세요. 전원을 반복해서 분리하거나 미완료 작업을 수동으로 초기화하지 마세요.

설치 실패나 중단 후 복구를 바로 선택할 수 있습니다. No-root 설치를 계속할 수 없으면 전체 제거를 한 번 확인하세요. 일시적인 연결 끊김이나 CYTV 작업 중에는 제거를 최대 세 번 시도합니다. Root 권한이 필요하면 같은 TV에서 Root로 연결을 선택하세요. 검증된 Root 정리는 차단된 No-root 제거도 완료합니다. Root 활성화 실패 시 활성화를 반복하지 않고 LG Home 복원과 검증을 시도합니다. 미완료 작업을 취소해도 진단 보고서와 복구 작업이 유지됩니다. 비상 정지 상태는 변경하지 않습니다.

제거 중 연결 오류가 나면 연결 세부 정보를 열어 네트워크를 확인하거나 기존 Root SSH 키를 선택한 뒤 다시 시도하세요. TV 주소, 에디션, 포트와 호스트 키 검증은 고정됩니다. No-root는 페어링 전에 Helper를 확인합니다. Helper를 중지하고 같은 설치 과정에서 재확인을 승인하세요. TV 제어 복원, 자동 시작 해제, 패키지와 파일 및 실행 중인 프로세스가 없음을 확인하고 미완료 설치가 없으면 재시작 없이 제거를 마칠 수 있습니다. 재시작을 요청하면 완료한 뒤 다시 시도하세요. 입력 서비스 오류가 있어도 안전한 패키지 정리는 계속되지만, 성공 표시는 입력 바로가기 정리까지 검증된 뒤에만 나옵니다.

Root 다시 설치: 저장된 연결로 TV 설정 → Root를 선택하고 **Root를 다시 설치할까요?**를 확인하세요. 설치 프로그램은 LG Home을 복원하고 업데이트 도구, Home Helper, 저장된 설정을 포함한 Clean Your TV 전체를 제거합니다. 제거가 검증되면 해당 설치 프로그램에 포함된 패키지와 Root 실행 환경을 설치하고 활성화합니다. 다른 TV 앱과 기존 root/SSH 접근 권한은 유지됩니다. 제거가 중단되거나 완전한 재시작을 요청하면 제거를 끝낸 뒤 설치를 다시 시작하세요. Clean Your TV 제거만 선택하면 다른 설치를 시작하지 않습니다.

자세한 영어 참고 문서: 요구사항 · 리모컨 · 테마 · 업데이트.

설정 사용

↑ ↓로 카테고리를 선택하고 → 또는 OK로 들어갑니다. ←는 카테고리로 돌아갑니다. 뒤로 버튼은 먼저 카테고리로 돌아간 다음 설정을 닫습니다. 섹션에 다시 들어가면 마지막으로 사용한 활성 항목에 포커스가 돌아갑니다. 열 수 선택에서는 화살표가 3열 격자를 따릅니다. 언어에서는 선택한 언어에 포커스가 놓입니다.

No-root가 Home 상태를 읽지 못하면 다시 시도를 선택하세요. 사용할 수 없는 컨트롤이 Home 제어가 꺼졌다는 뜻은 아닙니다. 배경화면에서 휴대전화 또는 CYTV로 이미지를 업로드할 수 있습니다. 배경화면이 있으면 화질과 어둡기 설정이 표시됩니다. 개인 배경화면 삭제에는 확인이 필요하며 취소하면 유지됩니다.

날씨

설정에서 배경화면 아래의 날씨를 엽니다. 날씨를 켜고 도시에서 지역과 국가를 확인하여 직접 검색하거나, 자동을 선택하여 인터넷 연결을 기반으로 대략적인 도시를 찾습니다. VPN은 결과에 영향을 줄 수 있습니다. 도시를 찾지 못하거나 잘못된 경우 직접 검색하세요. 감지되거나 선택한 도시는 설정에 표시됩니다. °C / m/s 또는 °F / mph와 사용 가능한 간단히, 현재, 상세, 4일 형식을 선택하세요. 미리보기는 테마를 따르며 예시는 샘플 데이터입니다. Liquid Glass는 간단한 형식만 지원합니다. Ribbon과 Atmosphere에서는 날씨를 표시하지 않습니다. 날씨를 끄면 요청이 중지되고 도시, 단위, 형식 설정이 숨겨집니다. 소스 선택은 계속 사용할 수 있습니다. 연결 장애 시 최근 데이터가 잠시 유지될 수 있으며 오래되면 새로 고칠 때까지 날씨가 숨겨집니다.

예보 출처로 Auto, MET Norway 또는 Open-Meteo를 선택하세요. Auto는 MET Norway부터 시작하고 실패하면 Open-Meteo를 한 번 시도한 뒤 마지막으로 성공한 출처와 캐시를 사용합니다. 직접 선택한 출처는 자동으로 바뀌지 않습니다. 새 설정은 Auto를 사용하며 출처 없이 저장된 기존 설정은 Open-Meteo를 유지합니다. 실제 출처는 설정에 표시됩니다. 이용 가능 여부는 네트워크에 따라 다릅니다. MET는 최소 3시간 간격으로 갱신하며 캐시는 6시간 후 만료됩니다. 없는 항목은 숨깁니다. MET는 체감 온도와 강수 확률을 제공하지 않습니다. 일별 범위는 예보 시점의 값을 요약하며 관측된 극값이 아닙니다.

예보 좌표는 api.met.no 또는 api.open-meteo.com으로, 도시 검색은 geocoding-api.open-meteo.com으로 전송됩니다. 선택 사항인 자동 위치 검색은 공인 IP를 get.geojs.io로 전송합니다. HTTPS를 사용하며 API 키는 필요 없습니다. 위치, 출처, 캐시는 TV에 저장됩니다. 데이터 출처에서 노르웨이 기상청(MET Norway, CC BY 4.0)을 비롯한 제공자의 약관과 저작자 정보를 볼 수 있습니다.

날씨 제목 옆의 데이터 출처 버튼을 누르면 서비스와 라이선스 정보를 볼 수 있습니다.

iPhone 사진을 배경화면으로 업로드

설정 → 배경화면 → 휴대폰에서 업로드를 열고 코드를 스캔하세요. JPG, PNG 또는 HEIC/HEIF를 선택하고 자른 뒤 화질 제한을 확인하고 전송하세요. TV에서 적용을 선택하세요. Safari는 기본 HEIC 지원을 사용하고 Chrome, Firefox 등 최신 브라우저는 필요한 경우 포함된 로컬 디코더를 사용합니다. 외부 서비스 없이 휴대폰에서 변환하며 취소하거나 다른 파일을 선택하면 중단됩니다. 입력: 32 MiB와 5천만 픽셀; 출력: 최대 1080p와 2 MiB. 실패하면 다른 사진이나 JPG/PNG를 사용하세요. Mac 앱이 아닌 휴대폰 페이지용 기능입니다.

Clean Your TV 설정

설치가 완료되면 Classic, Liquid Glass 또는 Ribbon을 선택하고 날씨를 켜거나 끄세요. Ribbon은 날씨를 지원하지 않으며 Liquid Glass는 간단한 형식을 사용합니다. 인터넷 연결로 대략적인 도시를 찾으며 Home 설정에서 바꿀 수 있습니다.

Developer Mode의 No-root는 자동 연장(베타)을 제공합니다. 공식 타이머를 계속 확인하세요. 기존 root SSH를 통한 No-root에는 이 옵션이 없습니다. Root는 Homebrew Channel로 보안 업데이트를 포함한 LG 펌웨어 업데이트를 차단할 수 있습니다. Homebrew Channel에서 실제로 재시작해야 합니다. CYTV 업데이트는 별도입니다.

현재 설정 유지를 선택하면 맞춤 설정을 건너뜁니다. 스위치는 모드 기능의 현재 켜짐/꺼짐 상태를 표시합니다. 변경하지 않은 설정은 유지됩니다. Root 재설치는 위 설명대로 CYTV 설정을 삭제합니다. TV에서 모양을 확인하고 미확인 옵션은 재시도 전에 Home 설정에서 확인하세요.