Summary
YouTube History Cleaner helps a user clear YouTube watch history and YouTube search history for a selected signed-in Google account.
- The extension runs only after an explicit user action in the popup.
- The extension does not sell data or send personal data to external servers.
- Runtime state is stored locally in
chrome.storage.local.
What The Extension Accesses
https://accounts.google.com/*to discover signed-in Google accounts and switch to the account the user selected.https://www.youtube.com/*to clear watch history and verify the active Google account and active YouTube channel before destructive actions.https://myactivity.google.com/*to clear YouTube search history, verify the active Google account, and handle reauthentication/manual resume.
The extension does not monitor browsing activity in the background. It only interacts with these pages while executing a user-requested cleanup flow.
Data Processed Locally
The extension may store the following local-only data so the requested cleanup flow can run safely and predictably:
Account metadata shown in the popup
- account id
- email address
- display name
- account chooser metadata needed to repeat the selected account switch
YouTube channel metadata shown in the popup
- channel id
- display name
- subtitle or handle
- channel fingerprint
- channel switch descriptor used to target the selected channel
Execution metadata
- last job result fields such as account id, account email, selected scope, scope results, timestamps, user-visible result message, and error code
- pending manual-resume context when reauthentication is required, including tab id, selected account id/email, selected scope, prior scope results, selected watch-channel id, and the My Activity source URL needed to resume safely
- recent execution summaries by account and by watch channel, including status, timestamp, message, error code, and selected watch-channel id when relevant
- notification debug trace when notification delivery fails or notification fallback handling throws
Popup UI preference
- popup theme preference (
darkorlight)
Local Storage And Retention
The extension stores local state in chrome.storage.local and removes expired items automatically in the background service worker.
ytCleaner.lastJobResult: up to 1 hourytCleaner.pendingManualRun: up to 30 minutesytCleaner.lastNotificationDebug: up to 1 hourytCleaner.accountDiscoveryCache: up to 7 daysytCleaner.youtubeChannelCache: up to 7 days per account entryytCleaner.selectedYoutubeChannels: kept only while the related channel cache entry is still valid; stale selections are removed during cleanupytCleaner.youtubeAccountBindings: up to 7 daysytCleaner.lastExecutionByAccount: up to 30 daysytCleaner.lastWatchExecutionByChannel: up to 30 daysytCleaner.popupTheme: kept until the user changes it or clears extension storage
The extension does not persist a convenience preference for the last selected account or delete scope outside the execution/history records listed above.
Safety Model
- Destructive actions start only from the extension popup.
- The service worker accepts destructive messages only from the trusted popup page.
- Before watch-history deletion, the extension verifies the active Google account and active YouTube channel from the YouTube UI and stops if the expected context cannot be confirmed.
- Before search-history deletion, the extension checks the active account hint on My Activity and stops if the selected account cannot be confirmed.
- If My Activity requires extra authentication, the extension pauses and waits for the user to manually resume the request.
Data Sharing
- No backend API
- No third-party analytics
- No remote logging
- No sale of personal data
Permissions And Host Access
storage: store minimal local state required for safe execution, manual resume, recent result display, and popup theme preferencetabs: open, update, and focus the automation tab used for AccountChooser, YouTube history, and My Activitynotifications: show completion or failure results for cleanup runs, with a service worker fallback path if the Notifications API is unavailable
Host access is limited to:
https://accounts.google.com/*https://www.youtube.com/*https://myactivity.google.com/*
User Control
- The user starts each cleanup request manually.
- The user can remove the extension at any time from Chrome extension settings.
- The user can clear the extension's local storage from Chrome.
Support
For support, use the contact details listed on the Support page.
요약
YouTube History Cleaner는 로그인된 Google 계정을 선택해 YouTube 시청 기록과 검색 기록을 정리할 수 있도록 돕는 확장 프로그램입니다.
- 이 확장은 popup에서 사용자가 직접 실행할 때만 동작합니다.
- 개인정보를 외부 서버로 전송하거나 판매하지 않습니다.
- 런타임 상태는
chrome.storage.local에만 저장됩니다.
확장이 접근하는 사이트
https://accounts.google.com/*에서 로그인된 Google 계정을 확인하고, 사용자가 고른 계정으로 전환합니다.https://www.youtube.com/*에서 시청 기록을 삭제하고, 파괴적 동작 전에 active Google 계정과 active YouTube 채널을 검증합니다.https://myactivity.google.com/*에서 YouTube 검색 기록을 삭제하고, active Google 계정 검증 및 재인증/manual resume을 처리합니다.
이 확장은 백그라운드에서 사용자의 웹 활동을 모니터링하지 않습니다. 사용자가 요청한 정리 흐름을 실행하는 동안에만 해당 페이지들과 상호작용합니다.
로컬에서 처리되는 데이터
확장은 사용자가 요청한 정리 흐름을 안전하고 예측 가능하게 수행하기 위해 아래와 같은 로컬 전용 데이터를 저장할 수 있습니다.
popup에 표시되는 계정 메타데이터
- account id
- 이메일 주소
- 표시 이름
- 선택한 계정 전환을 다시 수행하기 위한 account chooser 메타데이터
popup에 표시되는 YouTube 채널 메타데이터
- channel id
- 표시 이름
- subtitle 또는 handle
- channel fingerprint
- 선택한 채널을 대상으로 하기 위한 channel switch descriptor
실행 메타데이터
- 최근 작업 결과 필드(account id, account email, 선택한 삭제 범위, scope 결과, 실행 시간, 결과 메시지, 오류 코드 등)
- 재인증이 필요한 경우의 pending manual-resume context(tab id, 선택한 account id/email, 선택한 삭제 범위, 이전 scope 결과, 선택한 watch-channel id, 재개용 My Activity URL)
- 계정별 및 watch channel별 최근 실행 요약(상태, 시간, 결과 메시지, 오류 코드, 관련 watch-channel id 등)
- notification 전송 실패 또는 fallback 처리 예외 시 debug trace
Popup UI 설정
- popup theme preference (
dark또는light)
로컬 저장 및 보관 기간
확장은 로컬 상태를 chrome.storage.local에 저장하며, 만료된 항목은 background service worker가 자동으로 정리합니다.
ytCleaner.lastJobResult: 최대 1시간ytCleaner.pendingManualRun: 최대 30분ytCleaner.lastNotificationDebug: 최대 1시간ytCleaner.accountDiscoveryCache: 최대 7일ytCleaner.youtubeChannelCache: 계정별 최대 7일ytCleaner.selectedYoutubeChannels: 관련 channel cache entry가 유효한 동안만 유지되며, stale selection은 cleanup 시 제거됩니다.ytCleaner.youtubeAccountBindings: 최대 7일ytCleaner.lastExecutionByAccount: 최대 30일ytCleaner.lastWatchExecutionByChannel: 최대 30일ytCleaner.popupTheme: 사용자가 바꾸거나 확장 저장소를 지울 때까지 유지
확장은 위 실행/이력 기록 외에 마지막으로 선택한 account나 delete scope를 편의용 설정으로 따로 영구 저장하지 않습니다.
안전 모델
- 파괴적 동작은 확장 popup에서만 시작됩니다.
- service worker는 trusted popup page에서 온 파괴적 메시지만 허용합니다.
- 시청 기록 삭제 전에는 YouTube UI에서 active Google 계정과 active YouTube 채널을 검증하고, 예상한 컨텍스트를 확인할 수 없으면 중단합니다.
- 검색 기록 삭제 전에는 My Activity의 active account hint를 확인하고, 선택한 계정을 확인할 수 없으면 중단합니다.
- My Activity에서 추가 인증이 필요하면 흐름을 일시 중지하고, 사용자가 직접 재개할 때까지 기다립니다.
데이터 공유
- backend API 없음
- 제3자 analytics 없음
- 원격 logging 없음
- 개인정보 판매 없음
권한 및 host access
storage: 안전한 실행, manual resume, 최근 결과 표시, popup theme 저장에 필요한 최소 로컬 상태를 저장합니다.tabs: AccountChooser, YouTube history, My Activity에 사용하는 automation tab을 열고, 갱신하고, 포커스합니다.notifications: 정리 실행의 완료/실패 결과를 알림으로 표시합니다. Notifications API를 사용할 수 없으면 service worker fallback 경로를 사용합니다.
Host access는 아래 사이트로 제한됩니다.
https://accounts.google.com/*https://www.youtube.com/*https://myactivity.google.com/*
사용자 제어
- 사용자는 각 정리 요청을 직접 시작합니다.
- Chrome 확장 설정에서 언제든 확장을 제거할 수 있습니다.
- Chrome에서 확장의 로컬 저장소를 직접 지울 수 있습니다.
지원
지원이 필요하면 지원 페이지에 있는 연락 방법을 이용하세요.