Skip to content

Commit 1d24161

Browse files
dzieniszclaude
dzienisz
and
claude
committed
Release version 1.1 with bugfixes
Version bump: 1.0 → 1.1 Added: - CHANGELOG.md - Complete version history and release notes - TESTING.md - Comprehensive testing checklist - Version links in README.md Fixed in v1.1: - Critical layout issues with fullscreen button - Red progress bar scrubber positioning - Better CSS modification approach (setProperty vs cssText) Documentation: - Full changelog following Keep a Changelog format - Testing checklist for all critical UI elements - Links to changelog and privacy policy in README 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent d02abad commit 1d24161

File tree

4 files changed

+226
-1
lines changed

4 files changed

+226
-1
lines changed

‎CHANGELOG.md‎

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
# Changelog
2+
3+
All notable changes to YouTube Overlay Opacity Controller will be documented in this file.
4+
5+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7+
8+
## [1.1] - 2024-10-14
9+
10+
### Fixed
11+
- **Critical:** Fixed fullscreen button layout being disrupted by extension
12+
- **Critical:** Fixed red progress bar scrubber (dot) positioning - now stays visible on top
13+
- Fixed button styles being overwritten causing layout issues
14+
- Improved CSS modification method - now uses `setProperty()` instead of `cssText` to preserve YouTube's native styles
15+
16+
### Technical Changes
17+
- Switched from `cssText` to `style.setProperty()` for all style modifications
18+
- Only modifies specific CSS properties instead of overwriting entire inline styles
19+
- Better preservation of YouTube's native button positioning and layout
20+
- More defensive position setting for progress bar elements
21+
22+
### Why This Update?
23+
Previous version used `cssText` which overwrote ALL inline styles on elements, breaking YouTube's carefully crafted layouts. Now we only modify the specific properties we need (background, opacity, z-index) while preserving everything else.
24+
25+
## [1.0] - 2024-10-14
26+
27+
### Added
28+
- Initial release
29+
- Adjustable opacity slider (0-100%)
30+
- Quick preset buttons (100%, 75%, 50%, 25%)
31+
- Real-time opacity updates
32+
- Settings persistence across browser sessions
33+
- Default 70% opacity for optimal visibility
34+
- Black backgrounds for YouTube player controls:
35+
- Main control bars (top and bottom)
36+
- Buttons (play, pause, volume, settings, etc.)
37+
- Progress bar and time displays
38+
- Tooltips and chapter titles
39+
- Settings menus and popups
40+
- Gradient overlays
41+
- Handles YouTube's SPA navigation (works when switching videos)
42+
- MutationObserver with debouncing for performance
43+
- Z-index management for progress bar scrubber
44+
45+
### Features
46+
- Clean, modern popup interface
47+
- Works on all YouTube video pages
48+
- No data collection - privacy focused
49+
- Open source on GitHub
50+
- Comprehensive privacy policy
51+
52+
### Technical Details
53+
- Chrome Extension Manifest V3
54+
- Uses Chrome Storage API for settings sync
55+
- Content script injection on YouTube
56+
- CSS modifications for transparency control
57+
- Efficient observer pattern for dynamic content
58+
59+
---
60+
61+
## Version History Summary
62+
63+
- **v1.1** - Bug fixes for layout issues (buttons and scrubber)
64+
- **v1.0** - Initial release with core functionality
65+
66+
---
67+
68+
## Planned Future Updates
69+
70+
Potential features for future versions:
71+
- [ ] Keyboard shortcuts for quick opacity adjustment
72+
- [ ] Per-channel opacity settings
73+
- [ ] Different opacity for different elements (bars vs buttons)
74+
- [ ] Dark mode theme for popup
75+
- [ ] Polish language localization
76+
- [ ] Export/import settings
77+
- [ ] Opacity presets customization
78+
79+
## Reporting Issues
80+
81+
Found a bug? Have a suggestion?
82+
- GitHub Issues: https://github.com/dzienisz/youtube-opacity-controller/issues
83+
- Include: Browser version, YouTube URL, screenshot if possible
84+
85+
---
86+
87+
**Note:** This extension is submitted to Chrome Web Store and currently under review.

‎README.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
A Chrome extension that allows you to control the opacity of YouTube's transparent player overlays, making them less transparent and more visible.
44

5+
**Current Version:** 1.1 | [Changelog](CHANGELOG.md) | [Privacy Policy](PRIVACY.md)
6+
57
## Features
68

79
- Adjust opacity of YouTube player overlays with a simple slider (0-100%)
@@ -95,6 +97,8 @@ The extension intelligently detects and modifies ANY element with reduced opacit
9597
- `popup.js` - Popup functionality
9698
- `popup.css` - Popup styling
9799
- `icons/` - Extension icons in multiple sizes
100+
- `CHANGELOG.md` - Version history and release notes
101+
- `PRIVACY.md` - Privacy policy and permissions explanation
98102

99103
## Privacy
100104

‎TESTING.md‎

Lines changed: 134 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
# Testing Checklist
2+
3+
Po zainstalowaniu/aktualizacji rozszerzenia, przetestuj następujące rzeczy:
4+
5+
## ✅ Podstawowa funkcjonalność
6+
7+
1. **Otwórz dowolny film YouTube**
8+
- Przykład: https://www.youtube.com/watch?v=YmcACIOQdDc
9+
10+
2. **Sprawdź czy rozszerzenie działa**
11+
- Czy kontrolki mają czarne tło?
12+
- Czy domyślnie opacity jest ustawione na 70%?
13+
14+
3. **Testuj slider**
15+
- Kliknij ikonę rozszerzenia
16+
- Przesuń slider od 0% do 100%
17+
- Czy zmiany są widoczne natychmiast?
18+
- Czy slider odpowiada płynnie?
19+
20+
## 🎯 Krytyczne elementy do sprawdzenia
21+
22+
### 1. Przycisk pełnego ekranu (Fullscreen button)
23+
- ✅ Czy przycisk fullscreen jest widoczny?
24+
- ✅ Czy przycisk ma prawidłowy rozmiar i pozycję?
25+
- ✅ Czy ikona (4 strzałki) jest wyraźna?
26+
- ✅ Czy przycisk działa po kliknięciu?
27+
- ✅ Czy w trybie fullscreen kontrolki też mają czarne tło?
28+
29+
### 2. Czerwony scrubber (Progress bar dot)
30+
- ✅ Czy czerwona kropka jest widoczna NA WIERZCHU czarnego tła?
31+
- ✅ Czy możesz przesuwać scrubber bez problemów?
32+
- ✅ Czy scrubber reaguje na hover (powiększa się)?
33+
- ✅ Czy progress bar (czerwona linia) jest widoczna?
34+
35+
### 3. Inne przyciski
36+
- ✅ Play/Pause - działa i jest widoczny?
37+
- ✅ Volume - slider głośności działa?
38+
- ✅ Settings (gear icon) - otwiera menu?
39+
- ✅ Captions/Subtitles - przycisk działa?
40+
- ✅ Quality settings - można zmienić jakość?
41+
42+
## 🎨 Różne poziomy opacity
43+
44+
Test z różnymi ustawieniami:
45+
46+
### 0% (Transparent)
47+
- Powinno wyglądać jak oryginalny YouTube (przezroczyste)
48+
49+
### 25% (Light Gray)
50+
- Lekkie ciemne tło
51+
- Kontrolki bardziej widoczne niż przy 0%
52+
53+
### 50% (Medium Gray)
54+
- Wyraźne ciemne tło
55+
- Dobry balans widoczności
56+
57+
### 70% (Default)
58+
- Mocne ciemne tło
59+
- Wszystkie kontrolki bardzo wyraźne
60+
61+
### 100% (Solid Black)
62+
- Kompletnie czarne, nieprzezroczyste tło
63+
- Maksymalna widoczność kontrolek
64+
65+
## 🔧 Menu i popupy
66+
67+
1. **Settings menu**
68+
- Kliknij ikonkę zębatki (Settings)
69+
- Czy menu ma czarne tło?
70+
- Czy opcje są czytelne?
71+
72+
2. **Volume slider**
73+
- Hover nad ikoną głośnika
74+
- Czy slider głośności ma czarne tło?
75+
76+
3. **Quality menu**
77+
- Settings → Quality
78+
- Czy wszystkie opcje są widoczne?
79+
80+
4. **Speed menu**
81+
- Settings → Playback speed
82+
- Czy menu działa prawidłowo?
83+
84+
## 📱 Różne rozmiary okna
85+
86+
Testuj w różnych rozdzielczościach:
87+
- ✅ Normalny rozmiar okna
88+
- ✅ Okno zmaksymalizowane
89+
- ✅ Małe okno (500px szerokości)
90+
- ✅ Tryb teatru (Theater mode)
91+
- ✅ Tryb pełnego ekranu (Fullscreen)
92+
93+
## 🔄 Nawigacja
94+
95+
1. **Zmiana filmu**
96+
- Przejdź do innego filmu
97+
- Czy rozszerzenie nadal działa?
98+
- Czy ustawienia są zachowane?
99+
100+
2. **Autoplay**
101+
- Pozwól filmowi się skończyć
102+
- Czy przy następnym filmie rozszerzenie działa?
103+
104+
## ❌ Co NIE powinno się zdarzyć
105+
106+
- ❌ Przyciski NIE powinny się "rozjechać" (zmienić pozycji)
107+
- ❌ Scrubber NIE powinien zniknąć pod tłem
108+
- ❌ Kontrolki NIE powinny przestać działać
109+
- ❌ Layout playera NIE powinien się zepsuć
110+
- ❌ Nic NIE powinno migać ani skakać
111+
112+
## 🐛 Jeśli coś nie działa
113+
114+
1. **Odśwież stronę** (F5 lub Cmd+R)
115+
2. **Przeładuj rozszerzenie** w chrome://extensions/
116+
3. **Sprawdź Console** (F12 → Console) czy są błędy
117+
4. **Zgłoś bug** na GitHub z:
118+
- Opisem problemu
119+
- Link do filmu YouTube
120+
- Screenshot problemu
121+
- Jakie masz ustawienie opacity
122+
- Konsola (czy są błędy)
123+
124+
## ✨ Jeśli wszystko działa
125+
126+
Oznacza to że:
127+
- Kod poprawnie modyfikuje style
128+
- Nie nadpisuje krytycznych layoutów YouTube
129+
- setProperty() działa lepiej niż cssText
130+
- Z-index dla scrubbera jest prawidłowy
131+
132+
---
133+
134+
**Ostatnia aktualizacja:** Po poprawce z setProperty() zamiast cssText

‎manifest.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"manifest_version": 3,
33
"name": "YouTube Overlay Opacity Controller",
4-
"version": "1.0",
4+
"version": "1.1",
55
"description": "Control the opacity of YouTube's transparent player overlays",
66
"permissions": ["storage", "activeTab"],
77
"host_permissions": [

0 commit comments

Comments
 (0)