유튜브 플레이어의 다양한 기능을 향상시키는 브라우저 확장 프로그램입니다.
Extension_v2(v2.x): 현재 메인 개발/지원 대상Extension(v1.x): 동결(Frozen) 상태, 추가 업데이트 미지원- 신규 기능 및 개선은
Extension_v2기준으로 진행됩니다.
- 볼륨 부스트 (오디오 컴프레서): 기본 볼륨보다 더 크게 재생 (50% ~ 200%)
- 스테레오 패닝: 좌우 음향 밸런스 조정 (-100% ~ +100%)
- Picture-in-Picture(PIP) 버튼: PIP를 띄워주는 버튼을 추가
- 소형 플레이어 버튼: 유튜브의 소형 플레이어로 이동하는 버튼을 추가
- 플로팅 플레이어 (Floating Player): 스크롤 시 작은 플레이어로 계속 시청 (크기 및 위치 설정 가능)
- 커스텀 스크립트: JavaScript 코드 실행으로 추가 기능 구현
- 커스텀 테마: CSS 스타일 커스터마이징
- 디버그 모드: 개발/문제 분석용 로그 출력 제어
- 다국어 지원: 한국어, 영어
※ Chrome 웹 스토어 설치 버전은 자동 업데이트를 지원합니다.
압축해제(수동) 설치 버전은 자동 업데이트를 지원하지 않습니다.
Chrome Web Store에서 바로 설치할 수 있습니다.
- Releases 페이지에서 최신 버전 다운로드
- 다운로드한 ZIP 파일을 원하는 폴더에 압축 해제
- Chrome 브라우저에서
chrome://extensions/접속 - 우측 상단의 "개발자 모드" 토글 활성화
- "압축해제된 확장 프로그램을 로드합니다." 클릭
- 압축 해제한 폴더 선택
- 확장 프로그램이 설치되고 YouTube에서 사용 가능
- YouTube 페이지로 이동
- 확장 프로그램 아이콘을 클릭하여 설정 창 열기
- 원하는 기능을 활성화/비활성화
- 설정이 자동으로 저장됩니다
Chromium 엔진을 사용하는 모든 브라우저를 지원합니다.
- ✅ Chrome (권장)
- ✅ Microsoft Edge
- ✅ NAVER Whale
- ✅ Opera
⚠️ Firefox (제한적 지원)
YouTube Player Extension/
├── Extension/ # v1.x (동결/보존)
├── Extension_v2/ # v2.x (현재 개발/지원)
│ ├── manifest.json # 확장 프로그램 매니페스트
│ ├── popup.html # 팝업 UI
│ ├── popup.js # 팝업 로직
│ ├── content.js # 메인 콘텐츠 스크립트
│ ├── background.js # 백그라운드 서비스 워커
│ ├── _locales/
│ │ ├── ko/messages.json # 한국어 메시지
│ │ └── en/messages.json # 영어 메시지
│ ├── styles/
│ │ ├── popup.css # 팝업 스타일
│ │ └── content/
│ │ ├── enhancer.css # 콘텐츠 기능 스타일
│ │ └── bugfix.css # 콘텐츠 버그픽스 스타일
│ ├── scripts/
│ │ ├── core/
│ │ │ ├── base.js # 기본 유틸리티
│ │ │ └── settings.js # 설정 관리자
│ │ └── features/
│ │ ├── audio-control/
│ │ │ ├── audio-compressor.js # 오디오 컴프레서
│ │ │ └── stereo-panning.js # 스테레오 패닝
│ │ └── player-control/
│ │ ├── pip-button.js # PIP 버튼
│ │ ├── mini-player-button.js # 소형 플레이어 버튼
│ │ ├── floating-player.js # 플로팅 플레이어
│ │ ├── Loop-button.js # 연속 재생 버튼(예정)
│ │ └── Automatic-quality-selection.js # 자동 화질 선택(예정)
│ ├── icons/ # 확장 프로그램 아이콘
│ └── LICENSE
├── legacy/ # legacy/backup 파일
├── docs/ # 문서
└── Privacy-Policy.md # 개인정보처리방침
- Frontend: HTML5, CSS3, Vanilla JavaScript (ES6+)
- Extension API: Chrome Extension Manifest V3
- Audio Processing: Web Audio API
- Video APIs: Picture-in-Picture API
- Storage: Chrome Storage API
- Internationalization: JSON 기반 다국어 지원
storage: 사용자 설정 저장activeTab: 현재 탭 접근scripting: 스크립트 주입contextMenus: 컨텍스트 메뉴 추가
*.youtube.com/*: YouTube 사이트 접근*.googlevideo.com/*: 비디오 스트림 접근
- Chrome 브라우저에서
chrome://extensions/로 이동 - YouTube Player Extension이 활성화 상태인지 확인
- 페이지 새로고침 후 다시 시도
- 브라우저를 완전히 종료한 후 재시작
- Chrome 주소창 오른쪽 퍼즐 조각 아이콘(확장 프로그램) 클릭
- YouTube Player Extension 옆의 핀 아이콘 클릭하여 툴바에 고정
- YouTube 페이지를 새로고침 해주세요
- 여러 개의 YouTube 탭이 열려있다면 모든 탭을 새로고침
- 그럼에도 안되면 브라우저 캐시 삭제 후 재시도
- 브라우저에서 해당 탭의 음소거가 해제되어 있는지 확인
- 시스템 볼륨이 적절한 수준인지 확인
- 다른 오디오 향상 기능과 함께 사용시 충돌 가능성 확인
- 현재 배포/지원 대상은 Chromium 기반 브라우저입니다
- Firefox는 공식 지원하지 않습니다
- YouTube 사이트가 완전히 로딩되기 전에 스크롤을 내리면 플로팅 플레이어 관련 오류가 발생할 수 있습니다
- 해결 방법: YouTube 페이지가 완전히 로딩된 후 스크롤하거나 확장 프로그램 기능을 사용해주세요
- 페이지 새로고침 후 잠시 기다린 다음 사용하시면 문제를 피할 수 있습니다
- 해당 이슈는 향후 업데이트에서 수정될 수 있습니다.
- Chrome 웹 스토어 설치 버전은 자동 업데이트됩니다
- 압축해제 설치 버전은 수동 업데이트가 필요합니다
- 수동 설치 사용자는 Releases 페이지에서 최신 버전을 받아 다시 로드해 주세요
- 이 저장소를 Fork합니다
- 새로운 기능 브랜치를 생성합니다 (
git checkout -b feature/amazing-feature) - 변경사항을 커밋합니다 (
git commit -m 'Add amazing feature') - 브랜치에 Push합니다 (
git push origin feature/amazing-feature) - Pull Request를 생성합니다
버그나 기능 요청은 Issues에서 신고해 주세요.
모든 예정된 작업 또는 업데이트 상태의 확인은 ToDo에서 확인 가능합니다.
공지는 Notice에서 확인 가능합니다.
이 프로젝트는 MIT License 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
광고 문의 또는 기타 문의는 아레 이메일로 부탁드립니다.
Email: biz@soiv-studio.xyz
주의사항: 이 확장 프로그램은 YouTube의 공식 제품이 아닙니다. YouTube는 Google Inc.의 상표입니다.