FreeRadio — NVDA Eklentisi

FreeRadio, ekran okuyucu NVDA için geliştirilmiş bir internet radyo eklentisidir. Temel amacı, kullanıcıların binlerce internet radyo istasyonuna kolayca erişebilmesini sağlamaktır. Tüm arayüz ve işlevler NVDA ile tam erişilebilirlik gözetilerek tasarlanmıştır.

Radio Browser Dizini

FreeRadio, istasyon kataloğu için Radio Browser açık veritabanını kullanır. Radio Browser; dünya genelinde 50.000'i aşkın internet radyo istasyonunu barındıran, topluluk tarafından yönetilen ücretsiz bir dizindir. Kayıt veya hesap gerektirmez ve API'si herkese açıktır. Her istasyon için adres, ülke, tür, dil ve bit hızı bilgileri mevcuttur; istasyonlar kullanıcı oylarıyla sıralanır. FreeRadio bu API'ye Almanya, Hollanda ve Avusturya'da bulunan yansı sunucuları üzerinden bağlanır; bir sunucuya ulaşılamazsa otomatik olarak bir sonrakine geçer.

Radio Browser'a İstasyon Ekleme

Aradığınız istasyon Radio Browser dizininde yoksa https://www.radio-browser.info/add adresinden kendiniz ekleyebilirsiniz. Hesap veya kayıt gerekmez.

Sayfadaki formu doldurun:

• Akış adresi (Stream URL) (zorunlu) — .mp3, .aac, .ogg gibi bir uzantıyla biten doğrudan ses akışı adresi. Bu, istasyonun web sitesi adresi değil; bir medya oynatıcısına yapıştıracağınız ham akış adresidir. Çoğu istasyon akış adresini web sitesinde veya "Canlı Dinle" bölümünde yayınlar.
• İstasyon adı (zorunlu) — istasyonun dizinde görünmesini istediğiniz adı.
• Ana sayfa — istasyonun web sitesi adresi.
• Ülke ve dil — açılır listelerden yayın ülkesini ve dilini seçin.
• Etiketler — virgülle ayrılmış tür veya konu etiketleri; örneğin haber, caz, klasik. Arama ve filtreleme için kullanılır.
• Logo adresi — varsa istasyon logosunun doğrudan bağlantısı.

Gönderildikten sonra istasyon incelenerek dizine eklenir. Kabul edildikten sonra FreeRadio'nun arama sonuçlarında ve ülke listelerinde otomatik olarak görünür; dizin her zaman canlı API'den yüklenir.

Gereksinimler

• NVDA 2024.1 veya üzeri
• Windows 10 veya üzeri
• İnternet bağlantısı

Kurulum

.nvda-addon dosyasını indirin, üzerine Enter'a basın ve istendiğinde NVDA'yı yeniden başlatın.

Klavye Kısayolları

NVDA Menüsü → Tercihler → Girdi Hareketleri → FreeRadio bölümünden yeniden atanabilir. Bu kısayollar, odak hangi pencerede olursa olsun her yerden çalışır.

Sonraki / önceki kısayollar yalnızca favoriler listesinde dolaşır; tüm istasyonlar listesinde çalışmaz. Tarayıcı penceresinde listeler odaklanmışken sol ve sağ ok tuşları da aynı işlevi görür: bkz. Diyalog İçi Kısayollar.

İstasyon Tarayıcısı

FreeRadio ayrıca NVDA Araçlar menüsüne FreeRadio adlı bir alt menü ekler. Bu alt menüden İstasyon Tarayıcısı'nı ve FreeRadio Ayarları'nı doğrudan açabilirsiniz.

Ctrl+Win+R ile açılan pencerede beş sekme bulunur: Tüm İstasyonlar, Favoriler, Kayıt, Zamanlayıcı ve Beğenilen Şarkılar. Sekmeler arasında Ctrl+Tab ile dolaşılabilir.

Tüm İstasyonlar sekmesi açıldığında Radio Browser'dan en çok oylanan 1000 istasyon otomatik olarak yüklenir. Ülke açılır listesinden bir ülke seçildiğinde liste o ülkenin istasyonlarıyla güncellenir. Arama alanına harf girilmesi anlık olarak Radio Browser'ın tamamında ad, ülke ve tür üzerinden eş zamanlı arama yapar.

Tarayıcı penceresinin alt kısmında sekmelerin dışında yer alan Çıkış Cihazı açılır listesi, o an BASS tarafından tanınan ses çıkış aygıtlarını listeler. Listeden bir aygıt seçildiğinde ses çıkışı anında o aygıta yönlendirilir ve seçim kalıcı olarak kaydedilir; bir sonraki oturumda aynı aygıt otomatik olarak kullanılır. Seçili aygıt sisteme bağlı değilse otomatik olarak sistem varsayılanına dönülür. Bu denetim yalnızca BASS arka ucu aktifken işlev görür.

Aynı bölümde yer alan Ses Seviyesi (0–200) ve Efektler denetim çubuğu, pencere açıkken anlık olarak ayarlanabilir. Efektler listesinden Chorus, Compressor, Distortion, Echo, Flanger, Gargle, Reverb ile EQ: Bass Boost, EQ: Treble Boost ve EQ: Vocal Boost seçenekleri aynı anda birden fazla seçilerek etkinleştirilebilir; değişiklikler çalan akışa anında uygulanır. Bu denetimler yalnızca BASS arka ucu aktifken tam işlev görür.

EQ efektlerinden biri veya birkaçı etkinleştirildiğinde, her aktif band için bir kazanç denetimi otomatik olarak görünür. Kazanç −15 dB ile +15 dB arasında ayarlanabilir; varsayılan değerler Bas +9 dB, Tiz +9 dB ve Vokal +6 dB'dir. Kazanç denetimleri yalnızca işaretli EQ bandları için gösterilir, efekt kapatıldığında otomatik olarak gizlenir. Değerler kalıcı olarak kaydedilir ve bir sonraki oturumda geri yüklenir.

Pencerenin alt kısmında ayrıca Çal/Duraklat düğmesi bulunur. Herhangi bir istasyon çalmıyorsa seçili istasyonu başlatır; bir istasyon çalıyorsa oynatmayı duraklatır.

Listede bir istasyon seçiliyken İstasyon Detayları düğmesi, o istasyona ait ülke, dil, tür, format, bit hızı, web sitesi ve akış adresi gibi bilgileri ayrı bir iletişim kutusunda gösterir. İletişim kutusunda her alan ayrı bir salt-okunur metin kutusunda yer alır; Tab tuşuyla alanlar arasında gezinilebilir. Tümünü panoya kopyala düğmesiyle tüm bilgiler tek seferde panoya alınabilir. Bu düğme hem Tüm İstasyonlar hem de Favoriler sekmesinde bulunur.

Diyalog İçi Kısayollar

Aşağıdaki tuşlar yalnızca İstasyon Tarayıcısı penceresi etkinken çalışır.

F Tuşları

Liste ve Gezinme Kısayolları

Ses Kısayolları

Alt Kısayolları

Favoriler

Favoriler listesi, kalıcı olarak saklanan kişisel bir istasyon koleksiyonudur. İstasyon eklemek için listeden istasyonu seçip Favorilere Ekle düğmesine basın ya da Alt+V kısayolunu kullanın. Seçili istasyon zaten listedeyse aynı kısayol istasyonu listeden kaldırır.

Favoriler Ctrl+Win+→ ve Ctrl+Win+← ile çalınabilir; bu kısayollar tarayıcı penceresi açık olmasa da çalışır.

Favoriler listesinden bir istasyonu silmek için istasyonu seçip İstasyonu Sil düğmesine veya Delete tuşuna basın. Silme işleminin ardından odak ve seçim listedeki bir sonraki istasyona otomatik olarak taşınır. Silinen istasyon listedeki sonuncusuysa odak bir önceki istasyona geçer. Liste tamamen boşalırsa odak Çal düğmesine taşınır.

Favorileri Dışa ve İçe Aktarma

Favoriler sekmesi, istasyon listenizi yedeklemenizi ve geri yüklemenizi sağlayan iki düğme içerir:

Favorileri Dışa Aktar… — tüm favoriler listenizi bir dosyaya kaydeder. Kaydetme iletişim kutusunda iki format arasından seçim yapabilirsiniz: - JSON (.json) — istasyon adlarını, akış URL'lerini ve tüm meta verileri koruyan eksiksiz bir yedek. Listeyi daha sonra geri yüklemek veya başka bir bilgisayara taşımak için önerilir. - M3U oynatma listesi (.m3u) — çoğu medya oynatıcısı ve radyo uygulamasıyla uyumlu standart bir oynatma listesi formatı. M3U tüm istasyon meta verilerini saklamaz; bu nedenle M3U'dan geri yükleme, JSON yedeğine kıyasla daha az ayrıntıyla sonuçlanabilir.

Favorileri İçe Aktar… — daha önce dışa aktarılmış bir JSON veya M3U dosyasından istasyonları yükler. Dosyayı seçtikten sonra istasyonların nasıl ekleneceği sorulur: - Evet (Birleştir) — içe aktarılan istasyonları mevcut listenize, var olan favorileri silmeden ekler. Zaten listede olan istasyonlar tekrar eklenmez. - Hayır (Değiştir) — mevcut favoriler listesini tamamen temizler ve dosyadaki içerikle değiştirir. - İptal — herhangi bir değişiklik yapmadan tarayıcıya döner.

Başarılı bir içe aktarmanın ardından favoriler listesi, zamanlı kayıt istasyon listesi ve zamanlayıcı istasyon listesi otomatik olarak yenilenir.

Favorileri Yeniden Sıralama

Favoriler sekmesinde bir istasyon seçiliyken virgül tuşuna basarak taşıma moduna girin — bir bip sesi duyarsınız. Ok tuşlarıyla hedef konuma gidin, ardından virgül tuşuna tekrar basın. İstasyon seçilen konuma yerleştirilir ve yeni sıra anında kaydedilir. Aynı konumda tekrar virgül tuşuna basılması taşımayı iptal eder.

Favori İstasyonlar İçin Doğrudan Klavye Kısayolları

Favoriler listenizdeki her istasyon, NVDA'nın Girdi Hareketleri iletişim kutusunda FreeRadio Stations kategorisinde ayrı bir script olarak kayıtlıdır. İstediğiniz istasyona herhangi bir klavye kısayolu atayabilir ve tarayıcı penceresini açmadan her yerden doğrudan çalmaya başlayabilirsiniz.

Kısayol atamak için:

1. NVDA Menüsü → Tercihler → Girdi Hareketleri'ni açın.
2. FreeRadio Stations kategorisini genişletin.
3. İstasyonu adıyla bulun, seçin ve Ekle düğmesine basın.
4. İstediğiniz tuş kombinasyonuna basın ve onaylayın.

Kısayola basıldığında istasyon hemen çalmaya başlar. Bir istasyon favorilerden silinirse kategorideki girişi de kaldırılır ve atanmış kısayol NVDA tarafından otomatik olarak temizlenir. Favorilere yeni bir istasyon eklendiğinde kategori hemen güncellenir — Girdi Hareketleri iletişim kutusunun yeniden açılması gerekmez.

Özel İstasyon Ekleme

Radio Browser'da bulunmayan bir istasyon eklemek için Özel İstasyon Ekle düğmesini kullanın. Açılan iletişim kutusuna istasyon adını ve akış adresini girerek istasyonu doğrudan favorilerinize ekleyebilirsiniz. Özel istasyonlar diğer favoriler gibi çalınabilir ve yeniden sıralanabilir.

İstasyon Ses Profili

Favoriler sekmesinde per-istasyon ses ayarlarını yönetmek için iki düğme bulunur:

Bu İstasyon İçin Ses Profili Kaydet — mevcut ses seviyesini, aktif efektleri (chorus, EQ vb.) ve EQ kazanç değerlerini o istasyona özgü bir profil olarak kaydeder. Bu istasyon her çalmaya başladığında kaydedilmiş ses seviyesi, efektler ve kazanç ayarları otomatik olarak uygulanır; global varsayılanların yerine geçer.

Ses Profilini Temizle — seçili istasyondaki kayıtlı ses profilini kaldırır. Temizlendikten sonra istasyon global ses seviyesi, efekt ve EQ kazanç ayarlarına geri döner. Bu düğme yalnızca seçili istasyonda kayıtlı bir profil bulunduğunda etkinleşir.

Her iki düğme de favoriler listesinin altında yer alır ve yalnızca listeden bir istasyon seçiliyken etkin olur.

Müzik Tanıma

Ctrl+Win+İ kısayoluna üç kez basıldığında çalan akış için Shazam tabanlı müzik tanıma başlar. Tanıma yalnızca ICY metadata (istasyon tarafından yayınlanan parça bilgisi) mevcut olmadığında başlar; metadata varsa bunun yerine panoya kopyalanır.

Tanıma şu şekilde çalışır: ffmpeg kullanılarak akıştan kısa bir ses örneği alınır, Shazam parmak izi algoritması uygulanır ve sonuç Shazam sunucularına gönderilir. Tanıma başarılı olursa parça adı, sanatçı, albüm ve yayın yılı NVDA tarafından seslendirilir ve otomatik olarak panoya kopyalanır. Beğenilen şarkıları metin dosyasına kaydet seçeneği açıksa tanıma sonucu likedSongs.txt dosyasına da eklenir.

Sesli geri bildirim: Tanıma başladığında iki yükselen bip, bittiğinde iki alçalan bip sesi duyulur. İşlem süresince her 2 saniyede bir kısa bir bip çalar.

Gereksinim: ffmpeg.exe gereklidir. Eklenti klasörüne yerleştirilen ffmpeg.exe otomatik olarak kullanılır; farklı bir konumdaysa yol Ayarlar'dan belirtilebilir. ffmpeg'i ffmpeg.org adresinden indirin.

Ses Yansıtma

Ctrl+Win+M kısayolu, çalan akışı eş zamanlı olarak ikinci bir ses çıkış aygıtına yansıtır. Hoparlör ve kulaklık gibi iki farklı aygıttan aynı anda dinlemek için kullanışlıdır.

İlk basışta mevcut çıkış aygıtlarını listeleyen bir seçim iletişim kutusu açılır. Bir aygıt seçildiğinde yansıtma başlar ve ana oynatma kesintisiz devam eder. Kısayola tekrar basıldığında yansıtma durdurulur.

Kullanım senaryoları: - Hoparlör + kulaklık — Siz bilgisayar hoparlöründen dinlerken bir misafirin aynı yayını kulaklıkla takip etmesini sağlayın. - Kayıt kurulumu — Ana çıkışı hoparlöre, ikinci çıkışı harici bir kayıt cihazına veya ses arabirimine yönlendirin. - Çok odalı — Bluetooth hoparlör ve dahili hoparlörden eş zamanlı çalın; sesi başka bir odaya taşımak için ek yazılım gerekmez. - Uzaktan izleme — Ekran paylaşımı veya uzak masaüstü oturumunda hem yerel hem de uzak taraf aynı akışı eş zamanlı duyabilir.

Not: Ses yansıtma yalnızca BASS arka ucu aktifken kullanılabilir. Yansıtma aktifken ses seviyesi değiştirilirse her iki çıkış da eş zamanlı güncellenir.

Kayıt

Kayıtlar varsayılan olarak Belgeler\FreeRadio Recordings\ klasörüne kaydedilir. Dosya adı istasyon adını (veya şarkı kaydı modunda parça adını) ve kayıt başlangıç saatini içerir. Kayıt klasörü NVDA Menüsü → Tercihler → Ayarlar → FreeRadio → Kayıt klasörü seçeneğinden istediğiniz zaman değiştirilebilir. Kayıt motoru doğrudan akışa bağlandığından ses, alındığı hâliyle diske yazılır; herhangi bir işleme veya yeniden kodlama uygulanmaz; kayıt kalitesi yayın kalitesiyle özdeştir.

Anlık kayıt: Bir istasyon çalarken Ctrl+Win+E tuşuna bir kez basın. Durdurmak için tekrar basın. Oynatma süresince kesintisiz devam eder.

Şarkı kaydı: ICY metadata yayınlayan bir istasyon çalarken Ctrl+Win+E tuşuna hızlıca iki kez basın. Kayıt hemen başlar ve o anki parça adıyla adlandırılır. Parça değiştiğinde kayıt otomatik olarak durur ve NVDA kaydedilen dosya adını seslendirir. Parça bitmeden kaydı erken sonlandırmak istiyorsanız Ctrl+Win+E tuşuna tekrar iki kez basın. Çalan istasyon ICY metadata yayınlamıyorsa şarkı kaydı kullanılamaz ve NVDA bunu bildirir.

Zamanlanmış kayıt: Tarayıcıda Kayıt sekmesini açın. Favorilerden bir istasyon seçin, başlangıç saatini SS:DD biçiminde ve süreyi dakika cinsinden girin, bir veya daha fazla aktif gün seçin, ardından tekrar modu ve kayıt modu belirleyin:

Aktif günler: Haftanın bir veya daha fazla gününü işaretleyin. Tek seferlik modda işaretlenen her gün için ayrı bir kayıt girişi oluşturulur; her giriş o günün bir sonraki tarihine ayarlanır. Tekrar modunda ise kayıt yalnızca işaretlenen günlerde tekrarlanır. Hiçbir gün seçilmezse kayıt belirli günlerle kısıtlanmaz.

Tekrar modu: - Bir kez kaydet — seçilen her gün için tek seferlik kayıt oluşturur. Her giriş o günün bir sonraki tarihine alınır; bugünün saati geçmişse otomatik olarak bir sonraki haftaya taşınır. - Haftalık tekrar — seçilen aktif günlerde çizelgeden kaldırılana kadar her hafta tekrarlanır.

Kayıt modu: - Dinleyerek kaydet — eş zamanlı olarak çalar ve kaydeder. BASS → VLC → PotPlayer → Windows Media Player öncelik sırası kullanılarak bir oynatma arka ucu başlatılır. - Yalnızca kaydet — herhangi bir ses çıkışı olmaksızın arka planda sessizce kaydeder; kayıt motoru doğrudan akışa bağlanır.

NVDA kayıt başladığında ve bittiğinde bildirim verir. Zamanlanmış bir kayıt devam ederken NVDA yeniden başlatılırsa kayıt başlangıçta otomatik olarak devam eder.

Zaman Kaydırma (Canlı Radyoyu Geri Sarma)

Zaman kaydırma, o an dinlediğiniz istasyonu bir DVR veya kaset gibi geri sarmanızı sağlar — anı durdurun, birkaç dakika geri gidin ve istediğinizde canlıya tekrar yetişin. Oynatmanın durması gerekmez: geri ve ileri sarma aynı ses akışında anında gerçekleşir.

Bu özellik varsayılan olarak devre dışıdır. NVDA Menüsü → Tercihler → Ayarlar → FreeRadio → Zaman kaydırma tamponunu etkinleştir (canlı radyoyu geri sar, ~10 dakika) seçeneğiyle veya Ctrl+Win+T ile istediğiniz zaman anında etkinleştirebilirsiniz.

Nasıl Çalışır

Etkinleştirildiğinde FreeRadio, çalan istasyonu arka planda yerel bir tampona sürekli olarak yakalar. Tampon yaklaşık son 10 dakika ses içerir; yeni ses geldikçe eski ses silinir, böylece tampon her zaman canlı kenarına göre "yakın geçmişi" temsil eder.

• Ctrl+Win+J — 15 saniye geri sar. İlk basış sizi canlı oynatmadan zaman kaydırma oynatmasına geçirir; her ek basış tamponu sınırına kadar 15 saniye daha geri gider.
• Ctrl+Win+K — Zaman kaydırma modundayken 15 saniye ileri sarar. Canlı yayın kenarına ulaşıldığında oynatma otomatik olarak canlıya döner ve NVDA "Canlıya dön" duyurusunu yapar.
• Ctrl+Win+T — Özelliği tamamen açar veya kapatır. Zaman kaydırma modundayken kapatıldığında hemen canlıya döner ve arka plan yakalamayı durdurur.

Arka plan yakalama zaman kaydırma sırasında çalışmaya devam eder; canlı kenar birkaç dakika öncesini dinlerken bile ilerlemeye devam eder — tıpkı gerçek bir DVR gibi.

Etkinleştirme ve Tampon Isınması

Tampon, özellik etkinken bir istasyon çalmaya başlar başlamaz ya da bir istasyonu dinlerken özelliği etkinleştirdiğiniz anda dolmaya başlar. Bu nedenle geri sarma yalnızca birkaç saniyelik ses yakalandıktan sonra mümkündür — istasyon değiştirdikten hemen sonra Ctrl+Win+J tuşuna basarsanız NVDA henüz yeterli ses olmadığını bildirir. Birkaç saniye bekleyip tekrar deneyin.

Farklı bir istasyona geçmek yeni istasyon için tamponu her zaman sıfırlar; önceki istasyonun tamponlanmış sesi silinir.

Desteklenen Akışlar

Zaman kaydırma, FreeRadio'nun zaten desteklediği akış türleriyle çalışır:

• Shoutcast/Icecast tarzı sunucular dahil düz HTTP/HTTPS akışları (MP3, AAC, OGG vb.).
• HLS (.m3u8) akışları — FreeRadio istasyonun ana çalma listesini çözümler, medya çalma listesini takip eder ve tamponu doldurmak için arka planda segmentleri indirir.

Bir istasyonun çalma listesi hiç okunamazsa (örneğin bozuk veya erişilemeyen bir .m3u8 manifestosu) NVDA, o istasyon için geri sarmanın mevcut olmadığını bildirir.

Gereksinimler ve Sınırlamalar

• BASS arka ucunu gerektirir. BASS devre dışıyken zaman kaydırma kullanılamaz.
• Tampon yaklaşık 10 dakikadır; bundan daha geriye gidemezsiniz.
• Tampon istasyona özgüdür: istasyon değiştirme, oynatmayı durdurma veya NVDA'yı yeniden başlatma tamponu sıfırlar.
• Zaman kaydırmalı oynatma kendi yerel tampon dosyasını kullanır ve kayıtlı bir kayıt üretmez — sesi kalıcı olarak saklamak istiyorsanız Anlık Kayıt (Ctrl+Win+E) özelliğini de kullanın.

Zamanlayıcı

İstasyon tarayıcısında Zamanlayıcı sekmesini açın (Alt+4). İki tür zamanlayıcı eklenebilir:

Alarm — radyoyu başlat: Belirtilen saatte favoriler listesinden seçilen istasyonu otomatik olarak çalmaya başlar. İstasyonu ve saati SS:DD biçiminde girin.

Uyku — radyoyu durdur: Belirtilen saatte oynatmayı durdurur. Zamanlayıcı tetiklendiğinde ses 60 saniye boyunca kademeli olarak kısılır, ardından oynatma durur. İstasyon seçmeye gerek yoktur; yalnızca saat girilmesi yeterlidir.

Her iki tür için de girilen saat geçmişse işlem ertesi güne planlanır. Aynı saatte zaten bir zamanlayıcı varsa (türü ne olursa olsun) yeni zamanlayıcı eklenmez; çakışma hakkında bilgi verilir ve mevcut girişin önce kaldırılması istenir. Bekleyen zamanlayıcılar sekmede listelenir; listeden seçip Seçili Zamanlayıcıyı Kaldır düğmesine basılarak iptal edilebilir.

Ayarlar

NVDA Menüsü → Tercihler → Ayarlar → FreeRadio bölümünden aşağıdaki seçenekler yapılandırılabilir:

Bildirimleri Sessize Alma

Ayarlar'dan Bildirimleri sessize al seçeneği açıldığında NVDA aşağıdaki otomatik anonsları susturur:

• Yeni istasyon çalmaya başladığında istasyon adı
• Oynatma durumu değişiklikleri: çal, duraklat, durdur
• Kayıt olayları: başladı, durdu, bitti (anlık, şarkı ve zamanlanmış kayıtlar)
• Parça değişimi anonsları — Parça değişimlerini otomatik seslendir seçeneği açık olsa bile

Aşağıdakiler bu ayardan kasıtlı olarak etkilenmez: hata mesajları, favori geri bildirimleri (eklendi / zaten listede), müzik tanıma sonuçları ve güncelleme bildirimleri.

Ayar NVDA Menüsü → Tercihler → Ayarlar → FreeRadio bölümünden açılıp kapatılabileceği gibi atanmamış bir girdi hareketi aracılığıyla da anlık olarak değiştirilebilir (NVDA Menüsü → Tercihler → Girdi Hareketleri → FreeRadio). Değiştirildiğinde NVDA, işlemi onaylamak için bir kez "Bildirimler sessize alındı" veya "Bildirimler açıldı" anonsunu yapar.

Otomatik Parça Bildirimi

Ayarlar'dan Parça değişimlerini otomatik seslendir seçeneği açıldığında FreeRadio, çalan istasyonun ICY metadata akışını arka planda yaklaşık her 5 saniyede bir kontrol eder. Parça bilgisi değiştiğinde yeni başlık NVDA tarafından otomatik olarak okunur; herhangi bir tuşa basmak gerekmez.

İstasyon değiştirildiğinde yeni istasyonun ilk parça bilgisi bağlantı kurulur kurulmaz seslendirilir. ICY metadata yayınlamayan bir istasyona geçildiğinde sistem sessiz kalır ve bir önceki istasyonun parça bilgisi tekrar edilmez.

Bu özellik varsayılan olarak kapalıdır; NVDA Menüsü → Tercihler → Ayarlar → FreeRadio bölümünden açılıp kapatılabilir.

Beğenilen Şarkılar

Ayarlar'dan Beğenilen şarkıları metin dosyasına kaydet seçeneği açıldığında Ctrl+Win+İ kısayoluna üç kez basıldığında panoya kopyalanan parça bilgisi, kayıt klasöründeki likedSongs.txt dosyasına da satır satır eklenir (varsayılan: Belgeler\FreeRadio Recordings\likedSongs.txt).

ICY metadata mevcut olan istasyonlarda parça adı ve sanatçı bilgisi, metadata bulunmayan istasyonlarda ise Shazam tanıma sonucu kaydedilir; her iki durumda da aynı dosya kullanılır. Dosya yoksa otomatik oluşturulur; her kayıt dosyanın sonuna eklenir, önceki girişler silinmez.

Beğenilen Şarkılar Sekmesi

İstasyon tarayıcısındaki Beğenilen Şarkılar sekmesi, likedSongs.txt dosyasına kaydedilmiş tüm parçaları listeler. Sekme her açıldığında liste dosyadan otomatik olarak yeniden yüklenir.

Listenin üzerindeki Filtre alanı, görüntülenen parçaları gerçek zamanlı olarak daraltmanızı sağlar. Şarkı adının veya sanatçı adının herhangi bir bölümünü yazın; liste her karakter girişinde anında güncellenir. NVDA her değişiklikten sonra eşleşen sonuç sayısını seslendirir. Filtre alanından Aşağı ok tuşuna basarak odağı doğrudan listeye taşıyabilirsiniz.

Listeden bir parça seçildiğinde şu işlemler yapılabilir:

• Spotify'da Çal: Önce Spotify masaüstü uygulamasını açmayı dener. Uygulama kurulu değilse Spotify web sitesinde aramayı başlatır ve ilk sonucu otomatik oynatır.
• YouTube'da Çal (Alt+O): Seçili parçayla YouTube'da arama yapar ve sonuçları varsayılan tarayıcıda açar.
• Şarkı Sözlerini Göster: Seçili parçanın şarkı sözlerini getirir ve görüntüler. Şarkı sözleri lrclib.net adresinden alınır (ücretsiz, hesap gerekmez). Arama arka planda çalışırken kısa bir "Şarkı sözleri getiriliyor…" mesajı seslendirilir. Şarkı sözleri bulunursa, NVDA ile okuyabileceğiniz ve panoya kopyalayabileceğiniz salt okunur bir iletişim kutusunda açılır. Şarkı sözleri bulunamazsa NVDA bunu bildirir. Yinelenen istekleri önlemek için bir getirme işlemi devam ederken düğme geçici olarak devre dışı bırakılır.
• Sil (Alt+M): Seçili parçayı likedSongs.txt dosyasından kaldırır ve listeyi günceller. Liste odaklanmışken Delete tuşu da aynı işlevi görür.
• Yenile (Alt+E): Listeyi dosyadan yeniden yükler.

Spotify, YouTube, Şarkı Sözlerini Göster ve Sil düğmeleri yalnızca listeden gerçek bir parça seçiliyken etkin olur.

Şarkı Sözleri Servisi

FreeRadio, şarkı sözlerini almak için lrclib.net kullanır — API anahtarı veya hesap gerektirmeyen ücretsiz, açık bir veritabanı. Arama süreci, likedSongs.txt dosyasında saklanan parça dizesini ayrıştırır ve şarkı sözleri bulunana kadar giderek daha geniş sorgular dener:

1. Tam sanatçı adı ve temizlenmiş başlıkla kesin eşleşme (arama öncesinde "Remastered", "Live" veya yıl etiketleri gibi gürültü son ekleri ayıklanır).
2. Tam sanatçı adı ve orijinal başlıkla kesin eşleşme (temizleme başlığı değiştirdiyse).
3. Yalnızca ilk sanatçı adı ve temizlenmiş başlıkla kesin eşleşme ("Sanatçı A & Sanatçı B" gibi çoklu sanatçı dizelerinde).
4. İlk sanatçı adı ve temizlenmiş başlıkla bulanık arama.
5. Son çare olarak ham parça dizesiyle bulanık arama.

Düz şarkı sözleri mevcutsa olduğu gibi gösterilir. Yalnızca zaman damgalı LRC şarkı sözleri mevcutsa zaman damgaları ayıklanır ve düz metin gösterilir. Enstrümantal parçalar için şarkı sözü bulunamadığı rapor edilir.

Oynatma

Eklenti ses çıkışı için şu öncelik sırasıyla bir arka uç seçer:

1. BASS — varsayılan ve birincil arka uç. Ayrı bir kurulum gerektirmez; eklentiyle birlikte gelir. BASS, sesi doğrudan Windows ses yığınına gönderir ve Windows ses mikseri üzerinde pythonw.exe adıyla bağımsız bir kaynak olarak görünür. Bu, FreeRadio sesinin NVDA konuşmasından tamamen ayrı bir kanal üzerinde aktığı anlamına gelir: NVDA bir şeyler okurken radyo sesi kesilmez, karışmaz ve NVDA'nın kendi ses ayarlarından etkilenmez. Kullanıcı Windows Ses Mikseri'nden radyo ses düzeyini NVDA'dan bağımsız olarak ayarlayabilir. HTTP, HTTPS ve gömülü çoğu akış biçimini destekler. Ses yansıtma yalnızca bu arka uçla kullanılabilir.
2. VLC — BASS başarısız olursa devreye girer. Yaygın kurulum konumlarında, kullanıcı profili klasörlerinde ve sistem PATH'inde otomatik aranır.
3. PotPlayer — VLC bulunamazsa denenir. Yaygın kurulum konumlarında otomatik aranır.
4. Windows Media Player — son seçenek olarak kullanılır; sistem üzerinde WMP bileşeni kurulu olmasını gerektirir.

Güncelleme Kontrolü

FreeRadio, yeni sürüm olup olmadığını GitHub üzerinden otomatik olarak kontrol eder.

Otomatik kontrol: NVDA başladıktan 15 saniye sonra arka planda sessizce çalışır. Yeni bir sürüm bulunursa bildirim verilir; bulunamazsa herhangi bir mesaj gösterilmez.

Elle kontrol: NVDA Araçlar → FreeRadio → Güncellemeleri Denetle... menü öğesiyle istendiğinde tetiklenebilir. Bu yoldan başlatıldığında sürüm güncel olsa bile sonuç seslendirilir.

Güncelleme bulunduğunda: Sürüm numarasını ve yüklü sürümünüzü gösteren bir iletişim kutusu açılır.

• GitHub release'inde doğrudan indirilebilir bir .nvda-addon dosyası mevcutsa İndir ve Kur düğmesi gösterilir. Onaylandıktan sonra dosya arka planda indirilir, indirme başladığında NVDA bunu seslendirir ve ardından NVDA'nın kendi kurulum ekranı otomatik olarak açılır.
• Doğrudan indirme bağlantısı mevcut değilse Sayfayı Aç düğmesi gösterilir ve GitHub release sayfası varsayılan tarayıcıda açılır.

Otomatik kontrolü devre dışı bırakmak için: NVDA Menüsü → Tercihler → Ayarlar → FreeRadio bölümünden Güncellemeleri otomatik denetle seçeneği kapatılabilir.

Lisans

GPL v2