mirror of
https://github.com/yusufipk/YouTubeOutlierBadge.git
synced 2026-09-11 10:56:14 +00:00
yusufipek
0d5a232f08
Scores every card against the median views of its own channel's last N videos, badging the thumbnail above the duration stamp. Shorts and regular videos are scored in separate pools, live streams in none. Baselines come from YouTube's InnerTube endpoint, one request per channel, cached a day. Interface in English and Turkish.
78 lines
3.7 KiB
Markdown
78 lines
3.7 KiB
Markdown
# Outlier Badge
|
||
|
||
[English](README.md)
|
||
|
||
YouTube'da her video kartının köşesine outlier skorunu basan Firefox eklentisi.
|
||
Skor = videonun izlenmesi / kanalın son N videosunun izlenme **medyanı**. Medyan
|
||
bilerek seçildi: tek bir viral video ortalamayı yukarı çekip aynı kanalın diğer
|
||
videolarını "outlier değil" gösterirdi. Shorts kendi havuzunda, normal videolar
|
||
kendi havuzunda puanlanır, canlı yayınlar hiçbir havuza girmez. Video sayfasında
|
||
ayrıca skorun ayrıntısı ve kanalın son videolarının izlenme dağılımı görünür.
|
||
|
||
Sunucu, API anahtarı, hesap yok: eklenti youtube.com içinden YouTube'un kendi
|
||
dahili (InnerTube) ucuna oturumsuz istek atar. Kanal başına bir istek, sonucu
|
||
`storage.local` içinde varsayılan 24 saat tutulur, kartlar ancak ekrana girince
|
||
işlenir.
|
||
|
||
## Denemek için
|
||
|
||
`about:debugging#/runtime/this-firefox` → **Geçici Eklenti Yükle** → bu dizindeki
|
||
`manifest.json`. Firefox kapanınca kaybolur.
|
||
|
||
## Kalıcı kurulum
|
||
|
||
Normal Firefox imzasız eklentiyi kalıcı kurmaz. İmzalatmak ücretsiz ve eklentiyi
|
||
kimseye göstermez:
|
||
|
||
1. addons.mozilla.org/developers'da hesap aç, **Manage API Keys** sayfasından JWT
|
||
issuer ve secret al.
|
||
2. Paketi imzalat (npm bu dizine bir şey kurmasın diye kapsayıcı içinde):
|
||
|
||
```
|
||
podman run --rm -v "$(pwd)":/w:z -w /w docker.io/node:alpine \
|
||
npx --yes web-ext sign --channel=unlisted \
|
||
--api-key=JWT_ISSUER --api-secret=JWT_SECRET
|
||
```
|
||
|
||
3. Çıkan `web-ext-artifacts/*.xpi` dosyasını `about:addons` → dişli simgesi →
|
||
**Dosyadan eklenti yükle** ile kur.
|
||
|
||
İmza `manifest.json` içindeki eklenti kimliğine bağlı, o yüzden kimliği
|
||
değiştirme. Her yeni imza için `version` alanını artırman gerekir ve listelenmemiş
|
||
eklentiler otomatik güncellenmez: kodu değiştirdikçe imzalayıp yeniden kurarsın.
|
||
İmzayla uğraşmak istemezsen Firefox Developer Edition veya Nightly kurup
|
||
`about:config` içinde `xpinstall.signatures.required` değerini `false` yapmak da
|
||
çalışır, ama bu ayar normal Firefox'ta yok sayılır.
|
||
|
||
## Kullanım
|
||
|
||
Araç çubuğundaki simge ayarları açar: rozetleri kapat, Shorts'u puanlama, baseline
|
||
boyutu (son 15/30/60/90 video), belirli bir skorun altını gizle, önbellek ömrü,
|
||
arayüz dili ve önbellek temizleme. Aynı pencerede o sekmede kaç kartın taranıp
|
||
kaçının skorlandığı yazar, rozet çıkmıyorsa nedeni oradan görünür. Arayüz Türkçe
|
||
ve İngilizce, varsayılan olarak tarayıcının diline uyar.
|
||
|
||
Ayrıştırma ve skor mantığını tarayıcı açmadan denemek için `node test/check.js`
|
||
(gerçek bir kanal çağrısı da atar).
|
||
|
||
## Bilinen sınırlar
|
||
|
||
- Kanal izlenmeleri YouTube tarafından yuvarlanmış gelir ("1.2M views"), skor
|
||
yaklaşık bir orandır, kesin değildir.
|
||
- 7 günden yeni videolar henüz izlenme toplamamıştır, skorları olduğundan düşük
|
||
çıkar. Rozetin yanındaki nokta bunu işaretler.
|
||
- Baseline kanalın son N videosudur, tüm geçmişi değil. Büyüyen bir kanalda eski
|
||
bir video hak ettiğinden yüksek skor alır.
|
||
- Üyelere özel videoların izlenmesi dışarıya hiç verilmiyor: ne baseline'a
|
||
girerler ne de puanlanabilirler.
|
||
- Havuzda 3'ten az video kalırsa skor hesaplanmaz, rozet çıkmaz.
|
||
- InnerTube resmi olmayan bir arayüz. YouTube alan adlarını değiştirirse rozet
|
||
kaybolur, sayfa bozulmaz.
|
||
|
||
Zaman içinde izlenme grafiği **yok**, çünkü YouTube hiçbir video için geçmiş
|
||
izlenme verisi vermiyor. vidIQ ve Social Blade dahil herkes o eğriyi kendi
|
||
topladığı anlık ölçümlerden üretiyor; tek kullanıcılık bir eklentide ancak aylar
|
||
sonra ve yalnızca senin açtığın videolar için oluşurdu. Onun yerine video
|
||
sayfasındaki panelde beklemeden işe yarayan iki şey var: videonun kanal
|
||
dağılımındaki yeri ve günlük ortalama izlenmesi.
|