RF Bug Seeker for Flipper Zero

Read this in other languages: English | Türkçe

---

🇬🇧 English

Overview

RF Bug Seeker is a professional-grade hidden camera and RF bug detector application designed for the Flipper Zero. Built exclusively for the Momentum firmware, it leverages the advanced subghz_devices API to turn your Flipper into an industrial-style signal sweeper.

Whether you are sweeping a hotel room for hidden transmitters, testing your own RF equipment, or analyzing a localized jamming signal, this application provides pinpoint accuracy with an intuitive, analog-style vertical interface.

Key Features

• Interactive Single-Antenna Direction Finding (DF): Automatically triggers when a signal is locked. Guides you to capture LEFT (◄) and RIGHT (►) RSSI snapshots using body shielding (shadowing), compares the values, and calculates the exact transmitter direction (LEFT, RIGHT, FRONT, or BEHIND).
• Premium Tactical Radar Sweep: A rotating concentric dotted radar sweep animation drawn inside the dial, providing real-time feedback of the continuous scanning sweeps.
• Contrast-Inverted Prompt Badges: Dynamic, inverted round black boxes with white text/arrows guide you visually without cluttering the screen.
• Zone-Based Smart Filtering: Automatically filters out the Flipper's internal hardware noise (e.g., the 924-928MHz phantom signals) while maintaining ultra-high sensitivity (-65dBm) across the rest of the spectrum.
• Geiger-Counter Feedback: Features synchronized high-pitch audio clicks and haptic vibration pulses that intensify as you approach the signal source.
• Hybrid Precision Scanning: Prioritizes scanning a curated list of common surveillance and remote frequencies before sweeping the entire Sub-GHz range (300-348, 387-464, 779-928 MHz).
• Auto-Detect External Hardware: Seamlessly detects and utilizes an external CC1101 module (EXT) when connected via GPIO, defaulting back to the internal antenna (INT) when removed.

🎯 Direction Finding (DF) Guide

The Single-Antenna Direction Finding system relies on Body Shielding / Shadowing. Because your body naturally blocks high-frequency RF signals, turning your back to a transmitter shields the Flipper and lowers the captured RSSI strength.

1. Auto-Trigger: Once the Flipper locks onto a signal, the DF calibrator will automatically trigger and prompt you with Press ◄ inside a high-contrast oval badge.
2. Left Snapshot: Hold the Flipper in front of you, face 90° to the LEFT, and press the physical LEFT key. The device will record rssi_left, play a single chirp, and prompt you with Press ►.
3. Right Snapshot: Turn 180° to the RIGHT (facing 90° right relative to your starting position), and press the physical RIGHT key. The device will record rssi_right, play two quick chirps, and instantly compute the source:
   • LEFT / RIGHT: If one side's RSSI is significantly stronger (+3dBm margin).
   • FRONT: If both sides are strong and close (indicating the signal is directly ahead).
   • BEHIND: If both sides are weak (indicating the signal is behind, shielded by your body in both positions).
4. Continuous Swapping: You can press the LEFT or RIGHT keys at any time to retake a snapshot and recalculate. Press OK to unlock the frequency and resume scanning.

Controls

• Up / Down: Manually adjust the signal detection threshold (Sensitivity).
• Left: Snapshot left RSSI during direction-finding calibration.
• Right: Snapshot right RSSI during direction-finding calibration.
• Ok (Short / Long Press): Unlock the current frequency and force the device to resume scanning.
• Back: Safely power down the radio hardware and exit the application.

Installation

This application requires the Momentum Firmware due to its dependency on advanced hardware APIs.

1. Clone or copy this repository into your firmware's applications_user directory:

cp -r rf_bug_seeker /path/to/Momentum-Firmware/applications_user/

2. Compile the application using the fbt build system:

cd /path/to/Momentum-Firmware/
./fbt applications_user/rf_bug_seeker/

3. Copy the resulting .fap file to your Flipper Zero's SD Card:

cp build/f7-firmware-C/.extapps/rf_bug_seeker.fap /media/YOUR_SD_CARD/apps/Sub-GHz/

License

This project is open-source and free to use for educational and security research purposes.

---

🇹🇷 Türkçe

Genel Bakış

RF Bug Seeker, Flipper Zero için tasarlanmış profesyonel düzeyde bir gizli kamera ve RF böcek (dinleme cihazı) tespit uygulamasıdır. Momentum firmware için özel olarak geliştirilmiş olup, Flipper'ınızı endüstriyel standartlarda bir sinyal tarayıcıya dönüştürmek için gelişmiş subghz_devices API'sini kullanır.

Otel odalarında gizli verici taraması yapmak, kendi RF ekipmanlarınızı test etmek veya ortamdaki sinyal bozucuları (jammer) analiz etmek için ihtiyacınız olan tüm hassasiyeti, analog tarzı dikey arayüzü ile sunar.

Temel Özellikler

• İnteraktif Tek Antenli Yön Bulma (DF): Bir frekansa kilitlenildiğinde otomatik tetiklenir. Vücut gölgeleme (body shadowing) yöntemini kullanarak Flipper sizi adım adım sol (◄) ve sağ (►) RSSI örnekleri almaya yönlendirir, oranları karşılaştırır ve vericinin yönünü (LEFT, RIGHT, FRONT, BEHIND) tam olarak söyler.
• Premium Taktik Radar Tarayıcı: İbrenin altında 180 derece dönen dairesel radar tarama animasyonu ile tarama sürecini canlı olarak görselleştirir.
• Yüksek Kontrastlı Bilgi Rozetleri: Yönlendirme komutlarını siyah oval kutucuklar içine beyaz renkle yazarak ekranı son derece okunaklı ve şık hale getirir.
• Bölgesel Akıllı Filtreleme (Zone-Based Smart Filtering): Spektrumun geri kalanında ultra yüksek hassasiyeti (-65dBm) korurken, Flipper'ın kendi donanımından kaynaklanan iç gürültüleri (örneğin 924-928MHz hayalet sinyallerini) otomatik olarak filtreler.
• Geiger Sayacı Geri Bildirimi: Sinyal kaynağına yaklaştıkça yoğunlaşan senkronize yüksek frekanslı ses tıkırtıları (click) ve titreşim vurumları sağlar.
• Hibrit Hassas Tarama: Tüm Sub-GHz aralığını (300-348, 387-464, 779-928 MHz) taramadan önce, yaygın olarak bilinen casus ve uzaktan kumanda frekanslarını içeren öncelikli bir listeyi tarar.
• Otomatik Harici Donanım Tespiti: GPIO üzerinden bağlandığında harici bir CC1101 modülünü (EXT) otomatik olarak algılar ve kullanır. Çıkarıldığında varsayılan olarak dahili antene (INT) döner.

🎯 Yön Bulucu (DF) Kullanım Kılavuzu

Tek antenli yön bulma sistemi Vücut Gölgeleme / Kalkanlama (Body Shielding) fizik prensibine dayanır. Vücudunuz yüksek frekanslı RF sinyallerini doğal olarak engellediğinden, sırtınızı vericiye döndüğünüzde Flipper'ın yakaladığı RSSI sinyal gücü düşer.

1. Otomatik Tetikleme: Flipper bir sinyale kilitlendiğinde, yön bulma motoru otomatik olarak devreye girer ve ekranda siyah oval rozet içinde yanıp sönen bir Press ◄ komutu belirir.
2. Sol Örneklem (Snapshot): Cihazı önünüzde tutup 90° SOLA dönün ve fiziksel LEFT tuşuna basın. Cihaz rssi_left değerini kaydeder, tek bir bip çalar ve ekranda Press ► uyarısı gösterir.
3. Sağ Örneklem (Snapshot): Başlangıç konumunuza göre 90° SAĞA (sol konumunuza göre 180° sağa) dönün ve fiziksel RIGHT tuşuna basın. Cihaz rssi_right değerini kaydeder, iki hızlı bip çalar ve yönü hesaplar:
   • LEFT / RIGHT: Sinyal bir tarafta bariz güçlü ise (+3dBm fark).
   • FRONT: İki tarafta da güçlü ve birbirine yakınsa sinyal doğrudan önünüzdedir.
   • BEHIND: İki tarafta da zayıfsa sinyal arkanızdadır (iki dönüşte de vücudunuz sinyale kalkan olmuştur).
4. Sonsuz Akış: İstediğiniz zaman LEFT veya RIGHT tuşlarına basarak snapshot'ları yenileyebilirsiniz. Kilidi çözmek ve taramaya dönmek için OK tuşuna basmanız yeterlidir.

Kontroller

• Yukarı / Aşağı: Sinyal algılama eşiğini (Hassasiyet) manuel olarak ayarlayın.
• Sol: Yön bulma kalibrasyonu esnasında sol RSSI örneğini kaydeder.
• Sağ: Yön bulma kalibrasyonu esnasında sağ RSSI örneğini kaydeder.
• Ok (Kısa / Uzun Basım): Kilitlenen frekansı serbest bırakın ve cihazı taramaya devam etmeye zorlayın.
• Geri: Radyo donanımını güvenli bir şekilde kapatın ve uygulamadan çıkın.

Kurulum

Bu uygulama, gelişmiş donanım API'lerine olan bağımlılığı nedeniyle Momentum Firmware gerektirir.

1. Bu depoyu klonlayın veya firmware'inizin applications_user dizinine kopyalayın:

cp -r rf_bug_seeker /path/to/Momentum-Firmware/applications_user/

2. Uygulamayı fbt derleme sistemini kullanarak derleyin:

cd /path/to/Momentum-Firmware/
./fbt applications_user/rf_bug_seeker/

3. Oluşan .fap dosyasını Flipper Zero'nuzun SD Kartına kopyalayın:

cp build/f7-firmware-C/.extapps/rf_bug_seeker.fap /media/YOUR_SD_CARD/apps/Sub-GHz/

Lisans

Bu proje açık kaynaklıdır ve eğitim ile güvenlik araştırmaları amacıyla kullanılması ücretsizdir.