Frigate ile yapay zekâlı kamera: Home Assistant'ta nesne algılama kurulumu
Frigate, sıradan kameraları bulut ücreti ödemeden yerel bir yapay zekâya çeviriyor. Kişi algılanınca telefonuna resimli bildirim atan otomasyon da hazır.
İçindekiler18 bölüm
- Bu yazıda neler var?
- Frigate nedir?
- Başlamadan önce
- Genel yol
- MQTT’yi kur
- Frigate uygulamasını kur
- Kamerayı hazırla
- Yapılandırma dosyasını yaz
- Dedektörü seç, performansı ayarla
- Algılanacak nesneleri seç
- Kaydet ve başlat
- Frigate’in ayarları: kayıt, anlık görüntü ve maskeler
- Algılamayı dene
- Home Assistant’a Frigate entegrasyonunu ekle
- Otomasyon örnekleri
- Takılırsan
- Hangisinden başlamalıyım?
- Son söz
Videoda Frigate’i Home Assistant’a adım adım kurmuştum. Frigate, sıradan güvenlik kameralarını bulut ücreti ödemeden çalışan yerel bir yapay zekâ sistemine çeviriyor. Bu yazı videoyu tamamlıyor. Videoya sığmayan adımları, yapılandırma dosyasındaki her satırın ne işe yaradığını, hazır bir bildirim otomasyonunu ve takıldığında ne yapman gerektiğini burada bulacaksın.
Videoyu yayımladığımda Frigate’in güncel sürümü 0.17’ydi. Bugün 0.18.2 var. Home Assistant tarafında da HACS’in yerini Marketplace aldı. Bu yüzden her adımı bugünkü sürümlerle yeniden kontrol ettim ve değişen yerleri tek tek yazdım.
Bu yazıda neler var?
Kurulumu küçük adımlara böldüm. Bir adımın adına tıklarsan o bölüme gidersin.
| Adım | Nerede yapılır? |
|---|---|
| MQTT’yi kur | Ayarlar → Cihazlar ve hizmetler |
| Frigate uygulamasını kur | Ayarlar → Eklentiler |
| Kamerayı hazırla | Tapo uygulaması |
| Yapılandırma dosyasını yaz | Frigate’te Yapılandırma düzenleyicisi |
| Dedektörü seç, performansı ayarla | Yapılandırma dosyası |
| Algılanacak nesneleri seç | Yapılandırma dosyası |
| Kaydet ve başlat | Kaydet & Yeniden Başlat |
| Kayıt, anlık görüntü ve maskeler | Frigate’te Ayarlar |
| Algılamayı dene | Frigate’te Hata Ayıklama ve İncele |
| Home Assistant entegrasyonu | Ayarlar → Marketplace |
| Otomasyon örnekleri | Ayarlar → Otomasyonlar ve sahneler |
Frigate nedir?
Frigate, IP kameralar için yapılmış açık kaynaklı bir kayıt yazılımı. İngilizcede bunlara NVR (ağ video kaydedici) deniyor. Frigate’i sıradan bir kayıt cihazından ayıran şey, görüntüdeki nesneleri tanıması. Kameranın önünden geçenin kedi, araba ya da insan olduğunu ayırt edebiliyor. Bütün bu işi evindeki bilgisayarda yapıyor. Görüntülerin buluta gitmiyor, aylık abonelik de ödemiyorsun.
Nasıl çalışıyor? Frigate her kareyi yapay zekâya göndermiyor, çünkü bu çok ağır bir iş olurdu. Önce işlemciyle görüntüde hareket arıyor. Hareket gördüğü bölgeyi kesip nesne algılayıcıya, yani dedektöre gönderiyor. Dedektör o bölgede ne olduğunu ve bundan ne kadar emin olduğunu söylüyor. Frigate de sonucu MQTT üzerinden Home Assistant’a bildiriyor.
- 1Kamera akışı
- 2Hareket algılama
- 3Nesne algılama
- 4MQTT mesajı
- 5Otomasyon
Frigate’le neler yapabilirsin?
- Canlı izleme: Bütün kameralarını tek ekranda izlersin.
- Kayıt: Sürekli kayıt yapabilir ya da yalnızca hareket veya nesne olduğunda kaydedebilirsin.
- İnceleme: Frigate önemli anları kendisi ayıklıyor. Kişi ve araba gibi nesneleri Uyarılar listesine, geri kalanları Tespitler listesine koyuyor. Böylece saatlerce kayıt izlemen gerekmiyor.
- Anlık görüntü: Algılanan her nesnenin en iyi karesini fotoğraf olarak saklıyor. Bildirimlerde bu fotoğrafları kullanacağız.
- Bölgeler ve maskeler: “Yalnızca bahçe kapısının önündeki kişiler” gibi sınırlar çizebiliyorsun.
- Home Assistant’la tam uyum: Her kamera için kişi sayısı, kişi var sensörü ve kayıt anahtarı gibi varlıklar geliyor. Otomasyonlarında bunları kullanabiliyorsun.
Frigate’in yüz tanıma, plaka tanıma ve görüntülerde yazıyla arama gibi ek özellikleri de var. Bu yazıda temel kuruluma odaklanıyorum.
Başlamadan önce
Kuruluma geçmeden önce dört şeye bakman gerekiyor: Home Assistant’ın kurulum türüne, bilgisayarının gücüne, kamerana ve disk alanına.
Home Assistant OS gerekiyor. Frigate’i bu yazıda bir Home Assistant uygulaması olarak kuruyoruz. Uygulamalar Home Assistant OS’te çalışır. Home Assistant’ı Docker (Container) ile kurduysan uygulamalar bölümün yoktur. O zaman Frigate’i ayrı bir Docker konteyneri olarak kurman gerekir; Frigate’in belgelerinde bu yol da anlatılıyor.
En kolayı Home Assistant 2026.11 ya da daha yeni bir sürüm kullanmak. Frigate entegrasyonunu Marketplace’ten kuracağız ve Marketplace bu sürümle geldi. Entegrasyonun güncel sürümü (5.15.6) en az Home Assistant 2026.3 istiyor. Sürümünü Ayarlar → Hakkında sayfasında görebilirsin.
Bilgisayarın 64 bit olmalı. Frigate uygulaması Intel ve AMD işlemcili bilgisayarlarda (amd64) ve Raspberry Pi 4 ya da 5 gibi 64 bit ARM cihazlarda (aarch64) çalışıyor. İşlemcin AVX ve AVX2 komutlarını da desteklemeli. Frigate’in belgelerine göre 2020’den önceki Celeron ve Pentium işlemcilerin çoğunda bu destek yok.
Asıl yükü nesne algılama getiriyor. Frigate bu işi bir dedektöre yaptırıyor. Hangi dedektörü kullanacağın donanımına bağlı:
| Donanımın | Ne kullanmalısın? | Not |
|---|---|---|
| Intel işlemcili bir bilgisayar (ör. N100’lü mini bilgisayar) | OpenVINO, işlemcinin grafik biriminde (GPU) | En kolay yol. Frigate’in belgelerine göre çoğu evdeki kurulum için yeterli. |
| Grafik birimi olmayan ya da AMD işlemcili bir bilgisayar | OpenVINO, işlemcide (CPU) | Çalışır ama işlemciyi yorar. |
| Raspberry Pi 5 | Hailo-8L yapay zekâ kartı | Pi’nin kendi işlemcisi bu iş için önerilmiyor. |
| Google Coral (USB ya da M.2) | edgetpu dedektörü | Frigate artık yeni kurulumlar için Coral’ı önermiyor. Elinde varsa kullanabilirsin. |
| Intel Core Ultra’daki NPU | Home Assistant OS’te kullanılamıyor | Home Assistant OS, NPU’nun ihtiyaç duyduğu yazılımı içermiyor. Aynı işlemcinin grafik birimini kullan. |
| AMD ya da Nvidia ekran kartı | Home Assistant OS’te kullanılamıyor | Bunlar için Frigate’i Docker’la kurman gerekiyor. |
Dedektörün bir bölgeyi inceleme süresine çıkarım süresi deniyor; ne kadar kısaysa o kadar iyi. Frigate’in belgelerinde, OpenVINO’yu grafik biriminde çalıştıran birkaç işlemcinin hazır modelle verdiği süreler var:
| Grafik birimi | Çıkarım süresi |
|---|---|
| Intel HD 630 | yaklaşık 15 ms |
| Intel UHD 730 | yaklaşık 10 ms |
| Intel N100 | yaklaşık 15 ms |
| Intel Iris Xe | yaklaşık 10 ms |
| Intel Arc A310 (ekran kartı) | yaklaşık 5 ms |
Bunlar belgelerdeki örnek değerler; senin sisteminde biraz farklı çıkabilir. Kendi sürelerini kurulumdan sonra Frigate’in Sistem metrikleri sayfasında göreceksin.
RTSP veren bir IP kamera gerekiyor. Frigate görüntüyü kameradan RTSP ile alıyor. Videoda TP-Link Tapo kamera kullandım; Tapo’da RTSP’yi nasıl açacağını kamera bölümünde anlattım. Kameran iki akış veriyorsa daha iyi: Frigate algılama için küçük akışı, kayıt için büyük akışı kullanır. H.264 video ve AAC ses veren kameralar en sorunsuz çalışanlar.
Disk alanını düşün. Kayıtları açarsan videolar Home Assistant’ın diskine, media/frigate klasörüne yazılır. Küçük bir SD kart bu yükü kaldırmaz. Disk dolmaya yaklaşınca Frigate en eski kayıtları siliyor ama Home Assistant’ın kendisine de yer kalmalı. Kayıt ayarlarını ve ayrı bir disk eklemeyi Frigate’in ayarları bölümünde anlattım.
Hazır mısın? Başlamadan önce bu listeyi işaretle:
Genel yol
- 1MQTT'yi kur
- 2Frigate'i kur
- 3Kamerayı hazırla
- 4Yapılandırmayı yaz
- 5Entegrasyonu ekle
- 6Bildirimi kur
- Önce MQTT’yi kuruyoruz. Frigate, Home Assistant’la MQTT üzerinden konuşuyor.
- Frigate uygulamasını kurup başlatıyoruz.
- Kamerada RTSP’yi açıp akış adresini öğreniyoruz.
- Frigate’in yapılandırma dosyasına MQTT’yi, dedektörü ve kamerayı yazıyoruz.
- Kaydedip yeniden başlatıyor, algılamayı deniyoruz.
- Home Assistant’a Frigate entegrasyonunu ekliyoruz.
- Son olarak algılamaları otomasyonlarda kullanıyoruz.
MQTT’yi kur
MQTT, akıllı ev cihazlarının birbirine kısa mesajlar gönderdiği bir haberleşme yöntemi. Ortada mesajları dağıtan bir sunucu var; buna broker deniyor. Frigate “kamerada bir kişi var” gibi mesajları broker’a gönderiyor. Home Assistant da bu mesajları dinliyor. Frigate entegrasyonu, MQTT entegrasyonu kurulu olmadan çalışmıyor. Bu yüzden işe MQTT’yle başlıyoruz.
Broker olarak Home Assistant’ın resmi Mosquitto broker uygulamasını kullanacağız.
Mosquitto’yu kur
En kısa yol MQTT entegrasyonunu eklemek. Home Assistant gerisini kendisi hallediyor.
- 1Entegrasyon ekle
- 2MQTT'yi seç
- 3Resmi uygulamayı seç
- 4Kullanıcı aç
- Ayarlar → Cihazlar ve hizmetler’e gir ve sağ alttaki Entegrasyon ekle’ye bas.
- Bir marka adı arayın kutusuna
MQTTyaz ve listeden MQTT’yi seç. - Karşına iki seçenek çıkar. Resmi Mosquitto Mqtt Broker uygulamasını kullanın. seçeneğine bas.
- Home Assistant uygulamayı indirir, kurar ve başlatır. Bu birkaç dakika sürebilir; pencereyi kapatma.
- Başarılı olduğunu söyleyen pencerede Bitir’e bas. MQTT entegrasyonun hazır.
Mosquitto’yu kendin kurmak istersen: Ayarlar → Eklentiler’e gir (açınca başlığında Uygulamalar yazar). Sağ alttaki Uygulamayı yükle’ye bas, Mosquitto broker’ı bul ve Kurulum’a bas. Kurulum bitince Başlat’a bas. Birkaç saniye sonra Ayarlar → Cihazlar ve hizmetler sayfasında, Bulundu başlığının altında MQTT çıkar. Ekle’ye bas ve açılan pencerede Gönder’e bas.
Frigate için bir MQTT kullanıcısı aç
Frigate’in broker’a bağlanabilmesi için bir kullanıcı adı ve parola gerekiyor. Mosquitto, Home Assistant’ın kullanıcılarını tanıyor. Bu yüzden Frigate’e özel bir Home Assistant kullanıcısı açman yeterli.
- Ayarlar → Kişiler’e gir ve Kullanıcılar sekmesine geç. Bu sekmeyi yalnızca yönetici hesaplar görür.
- Sağ alttaki Kullanıcı Ekle’ye bas.
- Ekran adı alanına
Frigate MQTTyaz. Kullanıcı Adı alanı kendiliğinden dolar; istersen onufrigate_mqttyap. - Parola ve Şifreyi onayla alanlarına güçlü bir parola yaz. Bu parolayı bir yere not et, birazdan Frigate’in ayarlarına yazacağız.
- Yönetici seçeneğini kapalı bırak ve Oluştur’a bas.
Frigate uygulamasını kur
Frigate, Home Assistant’ın resmi uygulama mağazasında yok. Onu Frigate ekibinin kendi deposundan kuruyoruz. Önce bu depoyu Home Assistant’a tanıtmamız gerekiyor.
Depoyu ekle
- 1Uygulama mağazası
- 2Depoyu ekle
- 3Frigate'i seç
- 4Kurulum'a bas
- 5Başlat'a bas
- Ayarlar → Eklentiler’e gir. Sayfa açılınca başlığında Uygulamalar yazar.
- Sağ alttaki Uygulamayı yükle’ye bas. Uygulama mağazası açılır.
- Sağ üstteki üç nokta menüsünden Depolar’ı seç.
- Sağ alttaki Ekle’ye bas. Depo ekle penceresindeki URL alanına aşağıdaki adresi yapıştır ve Ekle’ye bas.
- Uygulama mağazasına geri dön. Frigate Add-ons başlıklı yeni bir bölüm görürsün. Görmüyorsan sayfayı yenile.
Eklemen gereken adres bu. Kutunun üstündeki Kopyala düğmesiyle kopyalayabilirsin:
https://github.com/blakeblackshear/frigate-hass-addons
Kısa yol: Bu bağlantıya (yeni sekmede açılır) tıklarsan Home Assistant’ın açılır ve Uygulama deposu eklensin mi? diye sorar. Ekle’ye basman yeterli. Bağlantıyı ilk kez kullanıyorsan site önce Home Assistant’ının adresini sorar.
Hangi Frigate’i seçmelisin?
Depoda birkaç Frigate var. Çoğu kişi için ilki doğru seçim:
| Uygulama | Ne zaman seçmelisin? |
|---|---|
| Frigate | Çoğu kişi için. Koruma modu açık kalır. Intel grafik birimi, Coral ve Hailo gibi aygıtlar bu türe zaten tanıtılmış. |
| Frigate (Full Access) | Donanım hızlandırma standart türde çalışmazsa. Bu tür, koruma modunu kapatmana izin veriyor. |
| Frigate Beta ve Frigate (Full Access) Beta | Yeni sürümleri herkesten önce denemek istersen. Ana evin için önermem. |
| Frigate (For old x86_64 CPU without AVX) | AVX desteği olmayan eski işlemciler için. 0.14.1 sürümünde kaldı ve yeni özellikleri almıyor. |
| Frigate Proxy | Frigate’i başka bir bilgisayarda çalıştırıyorsan. Frigate’i kurmaz, yalnızca onu kenar çubuğundan açmanı sağlar. |
Kur ve başlat
- Frigate Add-ons bölümünde Frigate’e tıkla ve Kurulum’a bas. Frigate büyük bir uygulama; indirmesi birkaç dakika sürebilir.
- Kurulum bitince Bilgi sekmesinde şu seçenekleri aç:
- Önyüklemede başlat: Home Assistant açılınca Frigate de açılır.
- Gözetim: Frigate çökerse kendiliğinden yeniden başlar.
- Kenar çubuğunda göster: Sol menüye bir Frigate kısayolu ekler.
- Başlat’a bas ve birkaç saniye bekle.
- Günlük sekmesine bak. Frigate ilk açılışta kendi yapılandırma dosyasını oluşturur ve bunu günlüğe yazar.
- Web Arayüzünü Açın’a ya da sol menüdeki Frigate’e bas. Frigate’in arayüzü açılır. Henüz kamera eklemediğimiz için ekranda Yapılandırılmış Kamera Yok yazar ve bir Kamera Ekle düğmesi görünür.
Kenar çubuğundaki kısayol Home Assistant’taki oturumunu kullanır; Frigate’e ayrıca giriş yapman gerekmez.
Yapılandırma sekmesinde bir şeye dokunman gerekmiyor. Uygulamanın Yapılandırma sekmesindeki Ağ bölümünde Frigate’in bağlantı noktaları duruyor. Kapalı olanları görmek için Devre dışı bırakılan bağlantı noktalarını göster’i açman gerekiyor. Varsayılan olarak yalnızca WebRTC için 8555 açık; Home Assistant’ın içinden kullanırken bu yeterli. Frigate’i evdeki başka bir cihazdan doğrudan açmak istersen 8971’i aç. Bu bağlantı noktası kullanıcı adı ve parola ister. Frigate ilk açılışta bir yönetici kullanıcısı ve parolası oluşturup günlüğe yazar. 5000’i ise açma, çünkü oraya parolasız girilebiliyor.
Yapılandırma dosyası nerede? Dosya şu konumda duruyor:
/addon_configs/ccab4aaf_frigate/config.yml
Full Access türünde klasörün adı ccab4aaf_frigate-fa oluyor. Bu dosyayı Frigate’in kendi Yapılandırma düzenleyicisi ile değiştireceğiz; en kolayı bu. İstersen Studio Code Server gibi bir dosya düzenleyiciyle de açabilirsin.
Kamerayı hazırla
Frigate’in kameraya bağlanması için iki bilgi gerekiyor: kameranın IP adresi ve RTSP akış adresi. Tapo kameralarda RTSP’yi kullanabilmek için önce Tapo uygulamasında bir kamera hesabı açman gerekiyor. Bu hesap, Tapo uygulamasına girdiğin hesaptan ayrı.
Tapo’da kamera hesabı aç
- Tapo uygulamasında kamerana dokun. Canlı görüntü sayfası açılır.
- Sağ üstteki simgeye dokunarak Cihaz Ayarları’na gir.
- Gelişmiş Ayarlar → Kamera Hesabı’nı seç.
- Açılan bilgilendirmeyi oku ve Anladım ve Kullanmayı Kabul Ediyorum’a dokun.
- Bir kullanıcı adı ve parola belirle. İkisi de 6 ile 32 karakter arasında olmalı. Tapo hesabının parolasından farklı, güçlü bir parola seç.
Tapo uygulamasındaki menü adlarını TP-Link’in Türkçe yardım sayfasından (yeni sekmede açılır) aldım. Uygulamanın sürümüne göre küçük farklar görebilirsin.
Kameranın IP adresini bul
IP adresini Tapo uygulamasında kameranın Cihaz Bilgileri bölümünde ya da modeminin bağlı cihazlar listesinde bulabilirsin. Bu adres değişirse Frigate kamerayı bulamaz. Bu yüzden modeminin ayarlarından kameraya sabit bir IP adresi ver. Bu ayar modemlerde genelde “DHCP rezervasyonu” ya da “adres ayırma” adıyla geçiyor.
stream1 mi, stream2 mi?
Tapo kameralar iki RTSP akışı veriyor. Kullanıcı adı ve parola, az önce açtığın kamera hesabınınkiler:
| Akış | Adres | Ne için? |
|---|---|---|
stream1 | rtsp://kullanıcı:parola@IP:554/stream1 | Yüksek kalite. Kayıt için. |
stream2 | rtsp://kullanıcı:parola@IP:554/stream2 | Standart kalite. Algılama için. |
Videodaki örnekte algılama için stream2 kullanılıyor ve doğrusu da bu. Frigate’in belgelerine göre model, görüntünün hareket olan bölgesini 320×320 piksellik bir kareye küçültüp inceliyor. Yani büyük akış algılamayı daha isabetli yapmıyor, yalnızca işlemciyi yoruyor. Yüksek kaliteli stream1’i ise kayıt için kullanacağız.
Akışı dene
Adresi Frigate’e yazmadan önce bilgisayarında dene. VLC gibi bir oynatıcıda ağ akışı olarak aç. Görüntü geliyorsa kullanıcı adın, parolan ve adresin doğru demektir.
Yapılandırma dosyasını yaz
Frigate’in bütün ayarları tek bir YAML dosyasında duruyor. Videoda bu dosyayı Frigate’in yapılandırma düzenleyicisinde yazmıştım. Burada da aynı yoldan gideceğiz.
Düzenleyiciyi aç
- Sol menüdeki Frigate’e basarak Frigate’in arayüzünü aç.
- Frigate’in menüsündeki dişli simgesine (Ayarlar) bas.
- Açılan menünün Yapılandırma bölümünden Yapılandırma düzenleyicisi’ni seç.
Düzenleyicide Frigate’in ilk açılışta oluşturduğu dosyayı görürsün. Dosyanın en altında version: 0.18-0 satırı var. Bu satır, dosyanın hangi sürümün biçiminde yazıldığını söylüyor.
Videodaki yapılandırma
Videoda kullandığım yapılandırmayı aşağıya koydum. İki küçük değişiklik yaptım: MQTT adresine Mosquitto uygulamasının adını yazdım ve kare hızını Frigate’in önerdiği 5’e çıkardım. Düzenleyicideki her şeyi sil ve bu kodu yapıştır. Ardından yanında parantez içinde not olan satırları kendi evine göre değiştir.
mqtt:
enabled: true
host: core-mosquitto # (Mosquitto'nun adresi; Home Assistant'ın IP adresini de yazabilirsin, ör. 192.168.1.10)
user: frigate_mqtt # (MQTT için açtığın kullanıcının adı)
password: mqtt_parolan # (o kullanıcının parolası)
detectors:
ov:
type: openvino
device: CPU # (Intel grafik birimin varsa GPU yaz)
model:
width: 300
height: 300
input_tensor: nhwc
input_pixel_format: bgr
path: /openvino-model/ssdlite_mobilenet_v2.xml
labelmap_path: /openvino-model/coco_91cl_bkgr.txt
cameras:
tapo_kamera: # (kameranın adı: yalnızca İngilizce harf, rakam, - ve _)
ffmpeg:
inputs:
- path: rtsp://kamera_kullanici:kamera_parolasi@KAMERA_IP:554/stream2 # (Tapo kamera hesabın; KAMERA_IP yerine kameranın IP adresi, ör. 192.168.1.50)
roles:
- detect
detect:
enabled: true
width: 640 # (stream2'nin genişliği)
height: 480 # (stream2'nin yüksekliği)
fps: 5 # (videoda 4 yazmıştım; Frigate 5'i öneriyor)
objects:
track:
- person
version: 0.18-0
Örnekteki kullanıcı adları, parolalar ve IP adresi uydurma; yerlerine kendi bilgilerini yaz. # ile başlayan notlara dokunmana gerek yok, Frigate onları ayar olarak okumuyor. Kodu yapıştırdıktan sonra hemen kaydedebilirsin; nasıl kaydedeceğini ikinci aşamada anlattım. Önce satırların ne işe yaradığına bakalım.
Satır satır
| Satır | Ne işe yarar? | Değiştirecek misin? |
|---|---|---|
mqtt: enabled | Frigate’in MQTT’ye bağlanmasını açar. Home Assistant entegrasyonu için açık olmalı. | Hayır |
mqtt: host | Broker’ın adresi. core-mosquitto, Mosquitto uygulamasının Home Assistant içindeki adı. Videoda burada Home Assistant’ın IP adresini kullanmıştım; o da çalışır. | Genelde hayır |
mqtt: user, password | MQTT bölümünde açtığın kullanıcı. | Evet |
detectors | Nesne algılamayı kimin yapacağını söyler. ov, dedektöre verdiğimiz ad. type: openvino, Intel’in OpenVINO altyapısını seçer. | Hayır |
device | OpenVINO’nun nerede çalışacağı: CPU işlemcide, GPU işlemcinin grafik biriminde. | Intel grafik birimin varsa GPU |
model | Frigate’le hazır gelen SSDLite MobileNet v2 modelinin ayarları: giriş boyutu (300×300), veri düzeni, renk sırası, model ve etiket dosyalarının yolu. | Hayır |
tapo_ | Kameranın Frigate’teki adı. Home Assistant’taki varlık adları da bundan türetilir. | İstersen |
path | Kameranın RTSP adresi. | Evet |
roles: detect | Bu akışın algılama için kullanılacağını söyler. | Hayır |
detect: enabled | Algılamayı açar. Varsayılanı kapalı olduğu için bu satır gerekli. | Hayır |
width, height | Algılama akışının çözünürlüğü. | Kameranınkine göre |
fps | Saniyede kaç karenin inceleneceği. | Genelde hayır |
objects: track | Hangi nesnelerin izleneceği. Yazmazsan yalnızca person izlenir. | İstersen |
version | Dosyanın biçim sürümü. | Hayır |
Kameranın adını seçerken: Frigate kamera adında yalnızca İngilizce harflere, rakamlara, tireye ve alt çizgiye izin veriyor. bahçe kapısı yazarsan Frigate yapılandırmayı hatalı bulur ve güvenli modda açılır. Bu yüzden bahce_kapisi gibi bir ad yazman gerekiyor. Ekranda Türkçe bir ad görmek istersen kameranın altına friendly_name: Bahçe kapısı satırını ekleyebilirsin.
Çözünürlük: width ve height, algılama akışının gerçek çözünürlüğüyle aynı olmalı. Videodaki kamerada 640×480 kullanmıştım. Senin kameranın stream2’si farklı olabilir; örneğin 16:9 bir akışta 640 genişliğin yüksekliği 360 oluyor. Emin değilsen bu iki satırı tamamen sil. Frigate açılırken akışı yokluyor ve çözünürlüğü kendisi buluyor. Bunun tek bedeli, açılışın biraz uzaması.
Kare hızı: Frigate’in belgeleri 5’i öneriyor ve bunun neredeyse her kamera için doğru olduğunu söylüyor. Bu değeri kameranın kendi kare hızına eşitlemen gerekmiyor. Daha yüksek değer daha fazla işlemci gücü harcıyor ama takibi iyileştirmiyor. 10’un üstüne çıkarsan Frigate günlüğe bir uyarı yazıyor.
Videodan bu yana ne değişti?
Videodaki örnekteki bütün anahtarlar Frigate 0.18.2’de de aynı. Yani bu yapılandırmayı olduğu gibi kullanabilirsin. 0.18 ile gelen birkaç küçük fark var:
- Dedektör olarak
openvinoseçipmodelbölümünü hiç yazmazsan Frigate bu hazır modeli kendisi seçiyor. Ben bölümü yine de dosyada bırakıyorum; neyin kullanıldığı açıkça görünsün. - Maskelerin yazılış biçimi değişti. Yeni biçimi Frigate’in ayarları bölümünde gösterdim.
- Eski bir sürümün yapılandırmasıyla açılırsa Frigate dosyayı yeni biçime kendisi çeviriyor. Eski dosyayı da aynı klasöre
backup_config.yamladıyla kaydediyor.
Dedektörü seç, performansı ayarla
Frigate’in ne kadar rahat çalışacağını iki iş belirliyor: nesne algılama ve kameradan gelen görüntünün çözülmesi. İkisini de ayrı ayrı hızlandırabilirsin.
OpenVINO: CPU mu, GPU mu?
Videodaki yapılandırmada OpenVINO işlemcide (CPU) çalışıyor. İşlemcin Intel’se ve içinde bir grafik birimi varsa algılamayı oraya taşı. Hem algılama hızlanır hem de işlemci rahatlar. Frigate’in belgelerine göre OpenVINO, 6. nesil (Skylake) ve sonraki Intel işlemcilerin grafik birimlerinde çalışıyor.
Bunun için yapılandırmadaki detectors bölümünü bulup şöyle değiştirmen yeterli:
detectors:
ov:
type: openvino
device: GPU # (işlemcinin grafik birimi)
Frigate’in belgelerindeki örneklerden birinde AUTO da geçiyor. O zaman cihazı OpenVINO kendisi seçiyor. Ben neyin kullanıldığını bilmek için açıkça CPU ya da GPU yazmayı tercih ediyorum.
Çok kameran varsa: Tek dedektör bütün kameralara yetişmeyebilir. Grafik birimin güçlüyse ikinci bir OpenVINO dedektörü ekleyebilirsin:
detectors:
ov_0:
type: openvino
device: GPU
ov_1:
type: openvino
device: GPU
Bu her işlemcide işe yaramıyor. Frigate’in belgelerindeki tabloya göre Intel N100 ve HD 530 aynı anda yalnızca tek dedektör çalıştırabiliyor.
Başka bir dedektör kullanacaksan
- Google Coral: USB Coral için
detectorsbölümünetype: edgetpuvedevice: usbyaz. OpenVINO’ya aitmodelbölümünü de silmen gerekiyor, çünkü o model Coral’da çalışmaz. Frigate artık yeni kurulumlar için Coral’ı önermiyor ama elinde varsa hâlâ iyi bir seçenek. - Hailo-8L (Raspberry Pi 5): Hailo’nun ayarlarında kendi modeli de yazılıyor. Hazır örnekleri Frigate’in dedektör belgesinde (yeni sekmede açılır) bulabilirsin.
- İşlemcide
cpudedektörü: Frigate bunu önermiyor. Grafik birimin yoksa bile OpenVINO’yuCPUile kullanmak çoğu zaman daha verimli.
Aynı anda tek tür dedektör kullanabiliyorsun. Örneğin OpenVINO ile Coral’ı birlikte çalıştıramazsın.
Görüntü çözmeyi hızlandır
Dedektör yalnızca nesne algılamayı hızlandırıyor. Kameradan gelen sıkıştırılmış görüntüyü açmak (çözmek) da epey işlemci gücü istiyor. Frigate bu işi donanım hızlandırmayla grafik birimine yaptırabiliyor.
Bu ayarın varsayılan değeri auto. Frigate uygun donanımı kendisi bulmaya çalışıyor ve sonucu günlüğe yazıyor. Günlükte donanım hızlandırmanın bulunamadığını söyleyen bir uyarı görürsen ayarı kendin yap. Aşağıdaki bölümü yapılandırma dosyasının en üst düzeyine, mqtt: satırıyla aynı hizaya yaz. Böylece bütün kameralarda geçerli olur:
ffmpeg:
hwaccel_args: preset-vaapi # (Intel işlemcine göre: aşağıdaki tabloya bak)
| Intel işlemcin | Yazacağın değer |
|---|---|
| 1–7. nesil | preset-vaapi |
| 8–12. nesil | preset-vaapi (preset-intel-qsv-h264 de olur) |
| 13. nesil ve sonrası, Intel Arc | preset-intel-qsv-h264 (kameran H.265 gönderiyorsa preset-intel-qsv-h265) |
Donanım hızlandırmayı elle yazdıysan ve çalışmazsa Frigate işlemciye geri dönmüyor, günlüğe hata yazıyor. Böyle bir durumda önce satırı silip auto’ya dön. Grafik birimini yine de kullanmak istiyorsan Frigate (Full Access) türünü dene.
Performansı izle
Frigate’in menüsünden Sistem metrikleri’ni aç:
- Genel sayfasındaki Algılayıcılar bölümünde Algılayıcı Çıkarım Hızı yazıyor. Frigate’in belgelerine göre grafik biriminde 30 ms civarı bile birkaç kameraya yetebiliyor. Coral ise modeli aynı anda yalnızca bir kez çalıştırabildiği için orada 10 ms civarı gerekiyor.
- Kameralar sayfasında her kameranın işlemci kullanımı ve kare hızları var. Kameranın adının yanındaki ⓘ simgesine basarsan Kamera Detayları açılır. Bu pencere akışların Çözünürlük ve Kodlama bilgisini gösteriyor.
widthveheightdeğerlerini buradan da öğrenebilirsin.
Daha az işle daha iyi algılama
- Algılama için alt akışı kullan. Yüksek çözünürlük algılamayı iyileştirmiyor, işlemciyi yoruyor.
fpsdeğerini 5’te bırak. Daha yüksek değer yükü aynı oranda artırıyor.- Hareket maskesi kullan. Kameranın saat damgası ya da rüzgârda sallanan ağaçlar dedektörü boşuna çalıştırır. Bunu Frigate’in ayarları bölümünde anlattım.
- Kamerayı doğru yere koy. Frigate’in belgelerine göre görüntüyü çok hızlı geçen nesneler için çözüm kare hızını artırmak değil. Kamerayı nesnelerin ona doğru yürüyeceği bir açıyla koymak daha iyi sonuç veriyor.
Algılanacak nesneleri seç
Frigate’in hazır modeli COCO adlı büyük bir görüntü veri setiyle eğitilmiş. Frigate varsayılan olarak yalnızca kişileri (person) izliyor. Başka nesneleri de izlemek istersen onları objects bölümüne eklemen yeterli.
Yapılandırmada kameranın altındaki objects bölümünü bul ve satırları şöyle ekle. Dosyadaki diğer satırlara dokunma:
cameras:
tapo_kamera:
objects:
track:
- person
- car # (araba; Frigate kamyonları da bu adla gösteriyor)
- dog # (köpek)
- cat # (kedi)
Bu bölüm kameranın altında durduğu için yalnızca o kamerada geçerli. Bütün kameralarda geçerli olsun istersen aynı objects bölümünü dosyanın en üst düzeyine de yazabilirsin. Nesne adlarını aşağıdaki listede yazdığı gibi, İngilizce ve küçük harfle yaz. sports ball ya da cell phone gibi iki kelimelik adlar da olduğu gibi yazılıyor.
Hazır modelin tanıdığı nesneler
| Grup | Yapılandırmaya yazacağın ad (Türkçesi) |
|---|---|
| İnsan | person (kişi) |
| Taşıtlar | bicycle (bisiklet), car (araba, kamyon), motorcycle (motosiklet), bus (otobüs), train (tren), boat (tekne), airplane (uçak; OpenVINO’nun hazır modelinde bu ad airplan diye yazılmış) |
| Sokak | traffic light (trafik lambası), fire hydrant (yangın musluğu), stop sign (dur tabelası), parking meter (parkmetre), bench (bank) |
| Hayvanlar | bird (kuş), cat (kedi), dog (köpek), horse (at), sheep (koyun), cow (inek), elephant (fil), bear (ayı), zebra (zebra), giraffe (zürafa) |
| Eşyalar | backpack (sırt çantası), umbrella (şemsiye), handbag (el çantası), tie (kravat), suitcase (valiz) |
| Spor | frisbee (frizbi), skis (kayak), snowboard (snowboard), sports ball (top), kite (uçurtma), baseball bat (beyzbol sopası), baseball glove (beyzbol eldiveni), skateboard (kaykay), surfboard (sörf tahtası), tennis racket (tenis raketi) |
| Mutfak | bottle (şişe), wine glass (kadeh), cup (fincan), fork (çatal), knife (bıçak), spoon (kaşık), bowl (kâse) |
| Yiyecekler | banana (muz), apple (elma), sandwich (sandviç), orange (portakal), broccoli (brokoli), carrot (havuç), hot dog (sosisli), pizza (pizza), donut (donut), cake (pasta) |
| Mobilya | chair (sandalye), couch (kanepe), potted plant (saksı bitkisi), bed (yatak), dining table (yemek masası), toilet (klozet) |
| Elektronik | tv (televizyon), laptop (dizüstü bilgisayar), mouse (fare), remote (kumanda), keyboard (klavye), cell phone (cep telefonu) |
| Ev aletleri | microwave (mikrodalga), oven (fırın), toaster (ekmek kızartma makinesi), sink (lavabo), refrigerator (buzdolabı) |
| Diğer | book (kitap), clock (saat), vase (vazo), scissors (makas), teddy bear (oyuncak ayı), hair drier (saç kurutma makinesi), toothbrush (diş fırçası) |
Evde en çok işe yarayanlar bence person, car, dog, cat, bicycle ve motorcycle. Frigate kişi ve arabaları varsayılan olarak Uyarılar’a, diğer nesneleri Tespitler’e koyuyor.
Yanlış algılamaları azalt
Model bazen kediyi ya da bir gölgeyi kişi sanabilir. Bunun için her nesneye filtre koyabilirsin. Aşağıdaki satırları kameranın altındaki objects bölümüne, track listesinin altına ekle:
cameras:
tapo_kamera:
objects:
filters:
person:
min_area: 5000 # (kişi kutusunun en küçük alanı, piksel cinsinden)
threshold: 0.75 # (kişi sayılması için gereken güven; varsayılanı 0.7)
Değerler örnek; kendi kamerana göre değiştir. min_area uzaktaki küçük kutuları eler. threshold ise Frigate’in bir nesneyi gerçekten o nesne saymadan önce ne kadar emin olması gerektiğini belirler. Bu iki değeri az az değiştir ve sonucu Hata Ayıklama görünümünde izle.
Kaydet ve başlat
Yapılandırma hazır. Kurulumun ikinci aşamasında dosyayı kaydedip Frigate’i yeniden başlatıyoruz.
- Yapılandırma düzenleyicisindeki Kaydet & Yeniden Başlat’a bas.
- Frigate yeniden başlarken biraz bekle.
- Frigate’in ana sayfasında (Canlı) kameranın görüntüsü belirir.
Düzenleyicide bir de Sadece Kaydet düğmesi var. Bu düğme dosyayı kaydediyor ama Frigate’i yeniden başlatmıyor. Değişikliğin Frigate bir sonraki kez başladığında geçerli oluyor.
Görüntü gelmiyorsa günlüğe bak. Frigate’in menüsünden Sistem günlükleri’ni aç ya da Home Assistant’ta uygulamanın Günlük sekmesine bak. Hata mesajlarının ne anlama geldiğini Takılırsan bölümündeki tabloda topladım.
Frigate’in ayarları: kayıt, anlık görüntü ve maskeler
Frigate çalışıyor. Şimdi onu evine göre ayarlayalım. Frigate’in Ayarlar sayfası, videoyu yayımladıktan sonra 0.18 ile epey büyüdü. Artık yapılandırmanın tamamını burada formlarla yapabiliyorsun. Frigate’in belgeleri de ayarları buradan yapmayı öneriyor. Sayfayı Frigate’in dişli menüsündeki Ayarlar’dan açıyorsun.
Sayfanın menüleri Türkçe arayüzde henüz büyük ölçüde İngilizce. Sol menüde iki ana grup var: Global configuration bütün kameralar için, Kamera Ayarları ise tek bir kamera için. Bir bölümdeki değişikliği Kaydet ile, bütün değişiklikleri birden Hepsini Kaydet ile kaydediyorsun. Bazı ayarlar Frigate’in yeniden başlamasını istiyor; Frigate bunu kaydederken söylüyor.
Aşağıda her ayarın YAML karşılığını da verdim. Ayarları ister Ayarlar sayfasından, ister yapılandırma düzenleyicisinden yap; ikisi aynı dosyayı değiştiriyor.
Kayıtları aç
Kayıt için Tapo’nun yüksek kaliteli stream1 akışını ikinci bir giriş olarak ekliyoruz. Yapılandırmada kameranın ffmpeg bölümünü şöyle değiştir:
cameras:
tapo_kamera:
ffmpeg:
inputs:
- path: rtsp://kamera_kullanici:kamera_parolasi@KAMERA_IP:554/stream2 # (algılama akışı)
roles:
- detect
- path: rtsp://kamera_kullanici:kamera_parolasi@KAMERA_IP:554/stream1 # (kayıt akışı)
roles:
- record
output_args:
record: preset-record-generic-audio-aac
output_args satırı kameranın sesini kayıt dosyasına uygun biçime (AAC) çeviriyor. Frigate’in belgelerine göre Tapo kameraların sesi bazen kayıt dosyasına yazılamıyor. O zaman canlı görüntü çalışsa da kayıtlar sessizce oluşmuyor. Bu satır sorunu baştan önlüyor. Kayıtta ses istemiyorsan değeri preset-record-generic yap.
Ardından kayıt ayarlarını dosyanın en üst düzeyine, mqtt: satırıyla aynı hizaya ekle:
record:
enabled: true
motion:
days: 3 # (hareket olan anları kaç gün saklasın)
alerts:
retain:
days: 14 # (uyarıları kaç gün saklasın)
mode: motion
detections:
retain:
days: 7 # (tespitleri kaç gün saklasın)
mode: motion
| Ayar | Ne demek? |
|---|---|
motion: days | Görüntüde hareket olan her anı, nesne olmasa da bu kadar gün saklar. |
alerts: retain: days | Uyarı sayılan anları (varsayılan olarak kişi ve araba) bu kadar gün saklar. |
detections: retain: days | Geri kalan tespitleri bu kadar gün saklar. |
mode: motion | Bu anların yalnızca hareket olan bölümlerini saklar; yer kazandırır. |
Gün sayıları benim örneğim; diskine göre değiştir. Bu satırları yazmazsan Frigate uyarıları ve tespitleri 10 gün saklıyor. Kesintisiz kayıt istersen record bölümüne continuous: ve altına days: 3 satırını da ekleyebilirsin. Ama disk o zaman çok daha çabuk dolar. Disk dolmak üzereyken, yani yaklaşık bir saatlik kayıt yeri kalınca Frigate en eski kayıtları siliyor. Bunu bir emniyet kemeri gibi düşün; asıl ayar gün sayıları.
Anlık görüntüleri aç
Anlık görüntü, algılanan her nesnenin en iyi karesinin fotoğrafı. Bildirimlerde ve Home Assistant’ın Medya sayfasında çok işine yarayacak. Bu bölümü de dosyanın en üst düzeyine ekle:
snapshots:
enabled: true
retain:
default: 14 # (anlık görüntüleri kaç gün saklasın)
Gün sayısını yazmazsan Frigate anlık görüntüleri 10 gün saklıyor. Aynı ayarları Ayarlar’da Global configuration altındaki Recording ve Snapshots sayfalarından da yapabilirsin.
Kayıtlar için ayrı bir disk
Kayıtlar Home Assistant’ın diskini doldurmasın istersen kayıt klasörünü bir ağ diskine (NAS) taşıyabilirsin. Frigate’in belgesindeki yol (yeni sekmede açılır) kısaca şöyle:
- Frigate uygulamasının sayfasında Durdur’a bas.
- Daha önce kayıt aldıysan
media/frigateklasörünü boşalt ya da başka bir yere taşı. Belgede iki durum da adım adım anlatılıyor. - Ayarlar → Sistem → Depolama’ya gir ve Depolama alanı ekle’ye bas.
- Ad alanına
frigateyaz. Bu ad zorunlu, çünkü Frigate kayıtları bu adı taşıyan klasöre yazıyor. - Kullanım olarak Medya’yı seç, Tip olarak NAS’ının türünü (Samba/Windows (CIFS) ya da Ağ Dosya Sistemi (NFS)) seç ve bilgilerini gir.
- Bağlan’a bas ve Frigate’i yeniden başlat.
Home Assistant 2026.11 ile gelen yerel disk desteğinde de Medya kullanımını seçebiliyorsun. Nasıl eklendiğini HACS bitti yazısında anlattım. Frigate’in belgeleri bu yolu henüz anlatmıyor; denersen diske de frigate adını ver.
Maske mi, bölge mi?
Frigate’te görüntünün bir kısmıyla ilgili üç araç var. Frigate’in belgelerinde hangisinin ne zaman kullanılacağını anlatan bir tablo var; kısaca şöyle:
| Ne istiyorsun? | Hangi araç? |
|---|---|
| Yalnızca bahçeye giren kişiler için uyarı almak, kaldırımdan geçenleri saymamak | Bölge ve required_ |
| Hep aynı noktada yanlış algılanan bir şeyi (ör. kişi sanılan bir ağaç dibi) elemek | Nesne maskesi |
| Saat damgası, gökyüzü ya da sallanan ağaçlar gibi alanlardaki hareketi yok saymak | Hareket maskesi |
| Bir kamerada bir nesneyle hiç ilgilenmemek (ör. kediler) | O nesneyi track listesinden çıkarmak |
Hareket maskesi çiz
- Frigate’te Ayarlar’ı aç ve Kamera Ayarları altındaki Maskeler / Alanlar sayfasına geç.
- Sayfanın üstünden kameranı seç.
- Yeni Hareket Maskesi’ne bas.
- Görüntünün üstüne tıklayarak maskenin köşelerini işaretle ve şekli tamamla.
- Maskeye bir ad ver ve kaydet.
Maskeleri YAML’de yazacaksan 0.18’deki yeni biçimi kullanman gerekiyor. 0.17’de bir maske yalnızca koordinatlardan oluşan bir satırdı. 0.18’de her maskenin bir adı, ekranda görünen bir adı ve açma kapama ayarı var. Eski biçimdeki maskeleri Frigate açılışta kendisi çeviriyor. Yeni biçim şöyle görünüyor:
cameras:
tapo_kamera:
motion:
mask:
saat_damgasi: # (maskenin adı)
friendly_name: Saat damgası
enabled: true
coordinates: "0.000,0.000,0.300,0.000,0.300,0.060,0.000,0.060" # (maske düzenleyicisinin verdiği koordinatlar)
Koordinatları elle yazmana gerek yok. Maskeyi arayüzde çizince Frigate bu satırları dosyaya kendisi yazıyor. Örnekteki koordinatlar, görüntünün sol üst köşesinde ince bir şerit çiziyor.
Bölge çiz
Bölge, görüntüde çizdiğin bir alan. Frigate’in Türkçe arayüzünde bölgelere alan deniyor. Bölgeleri de aynı Maskeler / Alanlar sayfasında Alan Ekle ile çiziyorsun. Bölgenin adı en az iki karakter olmalı, nokta içermemeli ve kameranın adıyla aynı olmamalı. YAML’de bahce gibi sade bir ad kullanmanı öneririm; ekranda görünecek adına Türkçe yazabilirsin. Home Assistant entegrasyonu her bölge için de kişi sayısı gibi ayrı sensörler oluşturuyor.
Uyarıların yalnızca bahçeye girilince oluşması için bölgeyi uyarı ayarına bağla:
cameras:
tapo_kamera:
review:
alerts:
required_zones:
- bahce # (uyarı istediğin bölgenin adı)
Algılamayı dene
Her şey hazır. Şimdi kameranın önüne geç ve Frigate’in seni görüp görmediğine bak.
Hata ayıklama görünümü
- Frigate’te Ayarlar’ı aç ve Hata Ayıklama sayfasına geç.
- Kameranı seç.
- Çerçeveler ve Hareket kutuları seçeneklerini aç.
- Kameranın önünden geç.
Hareket olan yerlerde kırmızı hareket kutuları belirir. Frigate seni tanırsa etrafına bir çerçeve çizer; her nesne türünün çerçevesi ayrı renkte olur. Sayfadaki Nesne Listesi de o an izlenen nesneleri gösterir. Tespit Bölgeleri seçeneğini açarsan Frigate’in dedektöre gönderdiği bölgeleri de görebilirsin. Hareket kutuları hiç durmadan bir yerde beliriyorsa orası bir hareket maskesi adayıdır.
İnceleme ve keşif
- Frigate’in ana menüsündeki İncele sayfasında algılanan anlar Uyarılar ve Tespitler olarak listelenir. Bir önizlemenin üstüne gelince ya da kaydırınca o an oynar. Önizlemeye tıklarsan kaydın tam halini izlersin.
- Keşfet sayfasında izlenen nesneleri tek tek, küçük resimleriyle görebilirsin.
Yanlış bir algılama mı gördün? Kedini kişi sandıysa ya da bir gölgeyi araba sandıysa nesne filtrelerini ayarla. Hep aynı noktada oluyorsa o noktaya bir nesne maskesi çiz.
Home Assistant’a Frigate entegrasyonunu ekle
Frigate kendi başına da çalışıyor. Ama asıl güzellik Home Assistant’a bağlanınca başlıyor. Frigate entegrasyonu kameraları, sensörleri ve anahtarları Home Assistant’a getiriyor. Bu entegrasyon eskiden HACS’ten kuruluyordu. Home Assistant 2026.11’den beri HACS’in yerinde Marketplace var ve Frigate entegrasyonu Marketplace’in kataloğunda duruyor.
Başlamadan önce: MQTT entegrasyonu kurulu olmalı ve Frigate’in yapılandırmasındaki mqtt bölümü dolu olmalı. Frigate entegrasyonu MQTT olmadan kurulmuyor. Varlıklarının çoğu da bilgisini MQTT’den alıyor.
- 1Marketplace'i aç
- 2Frigate'i bul
- 3Kurulum'a bas
- 4Adresi onayla
- 5Varlıklara bak
- Ayarlar → Marketplace’e gir. İlk kez giriyorsan çıkan uyarıyı oku ve Risklerin farkındayım ve kabul ediyorum’a bas.
- Gözat sekmesinde arama kutusuna
frigateyaz. Listede Frigate’le ilgili birkaç proje çıkabilir. Bizim aradığımız, adı yalnızca Frigate olan entegrasyon. GitHub’daki adıblakeblackshear/frigate-hass-integration. - Projenin sayfasını aç ve Kurulum’a bas. Açılan pencerede yine Kurulum’a basarak onayla.
- Kurulum bitince Frigate’in kurulum penceresi kendiliğinden açılır. Açılmazsa Ayarlar → Cihazlar ve hizmetler → Entegrasyon ekle’ye bas ve
Frigateara. - URL alanında
http://ccab4aaf-frigate:5000yazılı gelir. Standart Frigate uygulamasını kurduysan buna dokunma. Frigate (Full Access) kurduysan adresihttp://ccab4aaf-frigate-fa:5000yap. - Kullanıcı Adı (isteğe bağlı) ve Şifre (isteğe bağlı) alanlarını boş bırak. SSL Doğrula’ya da dokunma ve Gönder’e bas.
Frigate’teki her kamera Home Assistant’ta ayrı bir cihaz olarak görünür. Frigate’in kendisi için de Frigate adlı bir cihaz oluşur. Sol menüdeki Medya sayfasında da artık Frigate’in kayıtları ve anlık görüntüleri listeleniyor.
Entegrasyonun güncel sürümü 5.15.6 ve en az Home Assistant 2026.3 istiyor. Marketplace de kurmadan önce projenin istediği sürümü gösteriyor. Unutma: Frigate entegrasyonu da bir topluluk projesi; Home Assistant ekibi onu test etmiyor.
Gelen varlıklar
Kameranın adı tapo_kamera ise en çok kullanacağın varlıklar şunlar:
| Varlık | Ne işe yarar? |
|---|---|
camera. | Canlı görüntü. |
image. | Son algılanan kişinin fotoğrafı. |
binary_ | Kamerada kişi varken açık olur. |
sensor. | Görüntüdeki kişi sayısı. |
binary_ | Kamerada hareket varken açık olur. |
switch. | Algılamayı açar ve kapatır. |
switch. | Kaydı açar ve kapatır. |
switch. | Anlık görüntüleri açar ve kapatır. |
number., number. | Hareket algılamanın hassasiyet ayarları. |
İzlediğin her nesne ve çizdiğin her bölge için de benzer sensörler oluşuyor. Örneğin köpekleri de izliyorsan adı dog_occupancy ile biten bir sensör gelir. Varlık kimlikleri kameranın adından türetiliyor. Kamerana başka bir ad verdiysen seninkiler farklı olur. Kendi varlıklarını Ayarlar → Cihazlar ve hizmetler → Varlıklar sekmesinde tapo_kamera gibi kameranın adıyla arayarak bulabilirsin.
Performans sensörlerini aç: Frigate cihazındaki durum, çalışma süresi, kare hızı ve dedektörün çıkarım hızı gibi sensörlerin çoğu varsayılan olarak devre dışı geliyor. Dedektörün hızını Home Assistant’ta izlemek istersen:
- Ayarlar → Cihazlar ve hizmetler → Cihazlar sekmesinde adı Frigate olan cihazı aç.
- Varlık listesinin altındaki, devre dışı varlıkların sayısını gösteren bağlantıya bas. Türkçe arayüzde bu bağlantı “+5 devre dışı bırakıldı varlıklar” gibi görünüyor.
- Adı inference speed ile biten sensöre bas. Açılan pencerede (gerekirse dişli simgesine basarak) Etkin seçeneğini aç.
- Güncelle’ye bas.
Kameralarını kontrol panelinde daha şık göstermek istersen Marketplace’te Advanced Camera Card’a bakabilirsin. Bu kart eskiden Frigate Card adını taşıyordu. Frigate’in belgelerinde de isteğe bağlı bir yardımcı kart olarak geçiyor.
Otomasyon örnekleri
Frigate’in asıl gücü otomasyonlarda ortaya çıkıyor. İki hazır örnek hazırladım. İkisini de aynı yoldan ekleyeceksin:
- Ayarlar → Otomasyonlar ve sahneler’e gir ve Otomasyon oluşturun’a bas.
- Yeni bir otomasyon oluşturun’u seç.
- Sağ üstteki üç noktadan YAML’de düzenle’yi seç.
- Kutudaki her şeyi sil ve örnek kodu yapıştır.
- Yanında parantez içinde not olan satırları kendi evine göre değiştir ve Kaydet’e bas.
Örneklerdeki notify.mobile_app_telefonum ve light.bahce gibi adları ben uydurdum; senin evinde farklı olacaklar. # ile başlayan notlara dokunmana gerek yok. Home Assistant onları okumaz ve kaydederken siler.
Kişi algılanınca telefona resimli bildirim
Bunun için telefonunda Home Assistant uygulaması kurulu olmalı. Uygulamanın bildirim eylemi notify.mobile_app_ ile başlar ve sonunda telefonunun adı yazar. Kendi eyleminin tam adını Ayarlar → Araçlar → Eylemler sekmesinde mobile_app yazarak bulabilirsin.
alias: Frigate - Kamerada kişi var
description: Frigate yeni bir uyarı oluşturunca telefona resimli bildirim gönderir.
triggers:
- trigger: mqtt
topic: frigate/reviews
conditions:
- condition: template
value_template: >-
{{ trigger.payload_json['after']['severity'] == 'alert'
and (trigger.payload_json['type'] == 'new'
or trigger.payload_json['before']['severity'] != 'alert') }}
- condition: template
value_template: "{{ trigger.payload_json['after']['camera'] == 'tapo_kamera' }}" # (Frigate'teki kamera adın)
actions:
- action: notify.mobile_app_telefonum # (telefonunun bildirim eylemi)
data:
title: Frigate
message: Bahçe kamerasında biri var. # (bildirimde görünecek yazı)
data:
image: "/api/frigate/notifications/{{ trigger.payload_json['after']['data']['detections'][0] }}/thumbnail.jpg"
tag: "{{ trigger.payload_json['after']['id'] }}"
mode: single
Bu otomasyon nasıl çalışıyor? MQTT’deki frigate/reviews konusunu dinliyor. Frigate’in belgeleri bildirimler için bu konuyu öneriyor. Frigate bir inceleme kaydını başlattığında, güncellediğinde ve bitirdiğinde bu konuya mesaj gönderiyor. İlk koşul, kayıt bir uyarıya dönüştüğü anda yalnızca bir kez geçiyor. Böylece aynı olay için telefonun art arda çalmıyor. İkinci koşul, bildirimi yalnızca seçtiğin kamera için gönderiyor; bütün kameralar için istiyorsan bu koşulu sil. Resim, Frigate entegrasyonunun bildirimler için açtığı adresten geliyor.
Dene: Kaydettikten sonra kameranın önünden geç. Bildirim gelmezse otomasyonu aç ve sağ üstteki üç noktadan İzler’i seç. Otomasyonun hangi adımda durduğunu orada görürsün.
Gece bahçede biri varsa ışığı yak
Bu örnek, entegrasyonun kişi var sensörünü kullanıyor. Güneş battıktan sonra kamerada biri görülürse bahçe ışığını yakıyor:
alias: Frigate - Gece bahçe ışığı
description: Gece kamerada kişi görülünce bahçe ışığını yakar.
triggers:
- trigger: state
entity_id: binary_sensor.tapo_kamera_person_occupancy # (Frigate'in kişi var sensörü)
to: "on"
conditions:
- condition: state
entity_id: sun.sun
state: below_horizon
actions:
- action: light.turn_on
target:
entity_id: light.bahce # (yakmak istediğin ışık)
mode: single
sun.sun varlığı Home Assistant’ın güneş entegrasyonundan geliyor; güneş batınca durumu below_horizon oluyor. Frigate’in belgelerine göre kişi var sensörleri daha hızlı tepki versin diye daha az denetimden geçiyor. Bu yüzden bazen yanlış alarmla açılabiliyorlar. Işık yakmak için bu sorun değil. Bildirim gibi yanlış alarmın can sıktığı işlerde ilk örnekteki frigate/reviews yolunu kullan.
Hazır taslakla bildirim
Bildirim otomasyonuyla hiç uğraşmak istemezsen Frigate’in belgeleri bir topluluk taslağı (blueprint) öneriyor: Frigate Mobile App Notifications 2.0 (yeni sekmede açılır). Belgelere göre taslağın oluşturduğu otomasyonu başlangıç noktası olarak kullanıp kendine göre değiştirebilirsin.
Takılırsan
Frigate’in arayüzünde yalnızca Yapılandırma Düzenleyicisi (Güvenli Mod) açılıyor.
Yapılandırmanda bir hata var. Düzenleyici hatanın satırını gösteriyor. Girintilere ve kamera adına (Türkçe karakter ve boşluk olmamalı) bak, düzelt ve Kaydet & Yeniden Başlat’a bas.
Günlükte 401 Unauthorized yazıyor.
Kullanıcı adı ya da parola yanlış. Tapo hesabının değil, Tapo’da açtığın kamera hesabının bilgilerini yazmalısın.
Günlükte Connection refused, No route to host ya da 404 Not Found yazıyor.
Kameranın adresi ya da akış yolu yanlış. IP adresine, 554 bağlantı noktasına ve stream1 / stream2 yazımına bak. Kameranın IP adresi değişmiş olabilir; sabit IP ver.
Günlükte No frames received ... in 20 seconds yazıyor.
Görüntü bağlandıktan sonra kesiliyor. Wi-Fi kameralarda çoğu zaman sinyal zayıf. Kamerayı modeme yaklaştır ya da yeniden başlat.
Akış VLC’de açılıyor ama Frigate’te açılmıyor.
VLC gerekirse UDP’ye geçiyor, Frigate ise TCP kullanıyor. Aynı anda kameraya çok fazla uygulama bağlanıyorsa kamera yeni bağlantıyı da reddedebilir.
Frigate MQTT’ye bağlanmıyor.
host, user ve password satırlarına bak. Kullanıcıyı Ayarlar → Kişiler → Kullanıcılar’da açtığından ve Mosquitto uygulamasının çalıştığından emin ol.
Kişileri algılamıyor.
detect altında enabled: true satırının olduğuna bak. Hata Ayıklama’da Çerçeveler’i açıp kameranın önünden geç. Kameraya çok uzaksan model seni göremeyebilir.
Kedimi kişi sanıyor.
person için threshold değerini biraz yükselt ya da min_ ile küçük kutuları ele. Ayrıntılar
İşlemci çok yükseliyor.
Algılama için stream2’yi kullan ve fps 5’i geçmesin. Dedektörü GPU’ya al ve donanım hızlandırmayı aç. Ayrıntılar
Günlükte no supported devices found yazıyor.
OpenVINO grafik birimini bulamadı. Önce device: CPU ile dene. Grafik birimini kullanmak için Frigate (Full Access) türü gerekebilir.
Canlı görüntü var ama kayıtlar oluşmuyor.
Tapo’nun sesi kayıt dosyasına yazılamıyor olabilir. output_ satırını ekle. Ayrıntılar
Disk çok çabuk doluyor.
Kayıt gün sayılarını azalt ya da kayıtları bir ağ diskine taşı. Ayrıntılar
Frigate entegrasyonu kurulmuyor.
Önce MQTT entegrasyonunu kur. Ayrıntılar
Entegrasyon Bağlantı kurulamadi diyor.
Frigate uygulamasının çalıştığından emin ol. Full Access türünü kurduysan adres http://ccab4aaf-frigate-fa:5000 olmalı.
Bildirim geliyor ama resim yok.
Entegrasyonun seçeneklerindeki bildirim proxy’si açık olmalı. Evden uzaktaysan uygulamanın Home Assistant’ına dışarıdan ulaşabilmesi gerekiyor.
Hangisinden başlamalıyım?
| Durumun | Önerim |
|---|---|
| Intel N100 gibi bir işlemcisi olan mini bilgisayarım var. | Standart Frigate, OpenVINO GPU ve gerekirse preset-vaapi |
| Eski bir bilgisayar ya da AMD işlemci kullanıyorum. | OpenVINO CPU; önce tek kamerayla dene |
| Raspberry Pi 5 kullanıyorum. | Hailo-8L kartı ya da daha güçlü bir bilgisayar |
| Tek bir Tapo kamerayla denemek istiyorum. | Videodaki yapılandırma: algılama stream2’den, yalnızca person |
| Kayıt da istiyorum. | stream1’i record rolüyle ekle, gün sayılarını diskine göre seç |
| Kapıda biri olunca haberim olsun istiyorum. | Resimli bildirim otomasyonu |
| Gece bahçeden biri geçince ışık yansın istiyorum. | Kişi var sensörüyle ışık otomasyonu |
Son söz
Toparlarsak: Frigate için MQTT, Frigate uygulaması, RTSP veren bir kamera ve birkaç satırlık bir yapılandırma yetiyor. Gerisi ince ayar. Önce tek kamerayla başla. Algılamanın oturduğunu görünce kayıtları ve bildirimleri ekle. Her büyük değişiklikten önce de yedek almayı unutma.
Bu yazıdaki kurulumu videoda da adım adım anlattım: Yapay Zeka ile Akıllı Ev: Frigate Nesne Algılama Kurulumu (yeni sekmede açılır). Entegrasyonu kurduğumuz Marketplace’i merak ediyorsan HACS bitti yazısına göz at. Marketplace’ten başka neler kurabileceğini de Home Assistant’ı uçuracak 10 eklenti yazısında anlattım.
Sen Frigate’i hangi kamerayla ve hangi bilgisayarda çalıştırıyorsun? Çıkarım süren kaç milisaniye çıktı? Videonun altına yaz, birlikte karşılaştıralım.
