📻 FM Monitor

Système open source de monitoring de stations de radio FM basé sur Raspberry Pi / Linux et RTL-SDR, avec streaming Icecast2, décodage RDS temps réel, alertes email et interface web moderne.

✨ Fonctionnalités

📡 Réception & Analyse

Réception FM via dongle RTL-SDR (V3, V4, compatibles RTL2832U)
VU-mètre temps réel avec historique audio 30 secondes
Détection de silence / perte de signal configurable
Détection d'absence de modulation (porteuse sans programme)

📊 Analyse MPX temps réel

Déviation FM peak + RMS (kHz) — jauge colorée avec seuils configurables
Niveaux L/R séparés — décodage stéréo DSB-SC depuis le signal MPX
Ton pilote 19 kHz — détection et niveau
Signal stéréo 38 kHz — niveau de la sous-porteuse L−R
Sous-porteuse RDS 57 kHz — niveau RF indépendant du décodage
Puissance MPX totale (dBFS)
SNR — rapport signal/bruit (plancher mesuré en 60–75 kHz)
Alerte sur-déviation — email automatique si déviation > seuil

📻 Décodage RDS

PS (Programme Service) — nom de la station (8 car.)
RT (RadioText) — titre/artiste en cours (64 car.) — RT complet uniquement
PI Code — identifiant unique hexadécimal de la station
Logo station — récupération automatique via Radio Browser

🔊 Streaming Audio

Serveur Icecast2 : streaming stable 24/7
Qualité broadcast : MP3 128 kbps
Multi-auditeurs : jusqu'à 100 connexions simultanées
Proxy Flask HTTPS : écoute directement depuis le dashboard

🔔 Alertes & Surveillance

Alertes email automatiques (perte signal + rétablissement)
Watchdog : relance automatique en cas de crash
Historique des alertes et niveaux audio en base SQLite

🌐 Interface Web

Dashboard temps réel (SSE)
Configuration complète via interface web
Statistiques et historique
Page documentation (FM, MPX, RDS, dongles)
Responsive — accessible depuis smartphone et tablette

🔧 Matériel compatible

Dongle	Puce	Notes
RTL-SDR Blog V3	RTL2832U + R820T2	Drivers standard
RTL-SDR Blog V4	RTL2832U + R828D	Recommandé — TCXO 1ppm, meilleure sensibilité. Nécessite le fork officiel
Nooelec NESDR SMArt	RTL2832U + R820T2	Compatible standard
Autres RTL2832U	RTL2832U	Généralement compatibles

Installation drivers RTL-SDR Blog V4

# Bloquer le driver noyau générique
echo 'blacklist dvb_usb_rtl28xxu' | sudo tee /etc/modprobe.d/blacklist-rtl.conf
sudo modprobe -r dvb_usb_rtl28xxu 2>/dev/null

# Compiler le fork officiel
sudo apt install -y git cmake libusb-1.0-0-dev build-essential pkg-config
git clone https://github.com/rtlsdrblog/rtl-sdr-blog
cd rtl-sdr-blog && mkdir build && cd build
cmake .. -DINSTALL_UDEV_RULES=ON
make -j$(nproc) && sudo make install && sudo ldconfig

# Règles udev
sudo cp ~/rtl-sdr-blog/rtl-sdr.rules /etc/udev/rules.d/
sudo udevadm control --reload-rules && sudo udevadm trigger

# Test
rtl_test -t

🚀 Installation

⚡ Installation automatique (recommandée)

⚠️ Bonne pratique : avant d'exécuter un script distant, inspectez-le :
curl -sSL https://raw.githubusercontent.com/LyonelB/fm-monitor/main/install.sh -o install.sh
less install.sh
bash install.sh

Ou directement si vous faites confiance à la source :

curl -sSL https://raw.githubusercontent.com/LyonelB/fm-monitor/main/install.sh | bash

Le script installe automatiquement toutes les dépendances, compile redsea, configure Icecast2, génère les certificats SSL et démarre le service.

Durée : ~10-15 minutes (compilation de redsea incluse)

🔧 Installation manuelle

Prérequis système

Raspberry Pi 4/5 ou mini-PC Linux (Raspberry Pi OS Lite 64-bit / Debian 13 Trixie / Ubuntu 24.04+)
Python 3.11+
rtl_fm, redsea, ffmpeg, icecast2

1. Cloner le dépôt

git clone https://github.com/LyonelB/fm-monitor.git
cd fm-monitor

2. Installer les dépendances

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

3. Configurer

Copier et éditer le fichier de configuration :

cp config.json.example config.json
nano config.json

Paramètres clés :

{
  "station": {
    "name": "Ma Radio FM",
    "frequency": "98.5M"
  },
  "rtl_sdr": {
    "frequency": "98.5M",
    "gain": "40"
  },
  "email": {
    "enabled": true,
    "sender_email": "votre@gmail.com",
    "sender_password": "mot_de_passe_application",
    "recipient_emails": ["alerte@exemple.com"]
  }
}

Gmail : utilisez un mot de passe d'application, pas votre mot de passe habituel.

4. Générer les certificats SSL

bash generate_ssl.sh

5. Configurer Icecast2

sudo apt install -y icecast2

Éditer /etc/icecast2/icecast.xml et définir le mot de passe source : fmmonitor2026

6. Créer le service systemd

sudo nano /etc/systemd/system/fm-monitor.service

[Unit]
Description=FM Monitor
After=network.target icecast2.service

[Service]
Type=simple
User=votre_user
WorkingDirectory=/home/votre_user/fm-monitor
ExecStart=/home/votre_user/fm-monitor/venv/bin/python3 app.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl enable fm-monitor
sudo systemctl start fm-monitor

7. Accéder au dashboard

https://[IP-de-votre-appareil]:5000

📂 Structure du projet

fm-monitor/
├── app.py              # Application Flask (routes, API)
├── monitor.py          # Moteur de monitoring RTL-SDR / RDS
├── mpx_analyzer.py     # Analyse MPX temps réel (déviation, L/R, SNR...)
├── email_alert.py      # Alertes email
├── auth.py             # Authentification
├── database.py         # Base SQLite (historique, alertes)
├── requirements.txt    # Dépendances Python
├── install.sh          # Script d'installation
├── config.json.example # Exemple de configuration
├── templates/
│   ├── index.html      # Dashboard principal
│   ├── config.html     # Page configuration
│   ├── stats.html      # Statistiques
│   ├── about.html      # Documentation FM/MPX/RDS
│   └── login.html      # Authentification
└── static/             # Assets CSS/JS

📖 Documentation

La page À propos intégrée dans l'interface explique :

Le fonctionnement de la diffusion FM et du signal MPX
Le spectre MPX : déviation, pilote 19 kHz, stéréo 38 kHz, RDS 57 kHz, puissance, SNR
Le système RDS (PS, RT, PI Code)
Radio Browser et la résolution de logo
Les dongles compatibles et leur installation

🛠️ Dépannage

Le dongle n'est pas détecté

lsusb | grep -i realtek
rtl_test -t

Si usb_claim_interface error -6 : le driver noyau a pris le contrôle. Appliquer le blacklist (voir section V4 ci-dessus).

Pas de signal audio

Vérifier la fréquence et le gain dans config.json. Tester manuellement :

rtl_fm -f 98.5M -M wbfm -s 171k -r 44100 - | aplay -r 44100 -f S16_LE

Les emails ne partent pas

Vérifier la config SMTP dans l'interface Configuration
Utiliser le bouton Test Email dans le dashboard
Consulter les logs : journalctl -u fm-monitor -f

Le RDS n'apparaît pas

Le RT complet prend ~20-60 secondes à se stabiliser. Vérifier que redsea est installé :

which redsea
tail -f /tmp/rds_output.json

🗺️ Roadmap

v0.3.1 — Streaming Icecast2 professionnel, SSL, système de licences
v0.3.2 — Open source, RTL-SDR Blog V4, logo Radio Browser, page documentation
v0.4.0 — Script install automatique, historique niveaux audio, nettoyage interface
v0.4.1 — Surveillance modulation + RDS, alertes multi-types, configuration étendue
v0.4.2 — Enregistrement audio à la demande, voyant modulation, player amélioré
v0.4.3 — Corrections durée alertes, Gunicorn, robustesse enregistrement
v0.5.0 — Analyse MPX temps réel (déviation, L/R, pilote, stéréo, RDS RF, SNR), dashboard no-scroll
v0.5.x — Support TEF6686 (Headless TEF Lite) — démodulation stéréo hardware, RDS natif

📄 Licence

MIT — libre d'utilisation, modification et distribution.

🙏 Crédits

RTL-SDR Blog — drivers et matériel
redsea — décodeur RDS
Radio Browser — base de données stations
Icecast2 — serveur de streaming

Changement de source : RTL-SDR ↔ TEF668X Headless

FM Monitor supporte deux sources matérielles, configurables dans config.json sans modifier le code.

Passer en mode TEF668X Headless

Brancher le TEF668X Headless en USB-C (câble données, pas charge seule)
Vérifier la détection : ls /dev/ttyACM0 et aplay -l | grep Tuner
Ajouter la section tef dans config.json :

"tef": {
    "enabled": true,
    "serial_port": "/dev/ttyACM0",
    "alsa_device": "hw:Tuner",
    "signal_threshold_dbf": 20.0,
    "modulation_threshold_dbfs": -40.0
}

Installer la dépendance : pip install pyserial --break-system-packages
Ajouter l'utilisateur au groupe dialout : sudo usermod -a -G dialout $USER
Redémarrer : sudo systemctl restart fm-monitor

Revenir en mode RTL-SDR

Mettre "enabled": false dans la section tef de config.json et redémarrer.

Différences entre les deux modes

Fonctionnalité	RTL-SDR	TEF668X Headless
Signal	dBFS (RMS PCM)	dBf (RF natif)
Déviation FM	✅ (MPXAnalyzer)	❌
Pilote 19 kHz	✅	❌
Stéréo 38 kHz	✅	❌
RDS 57 kHz	✅	❌
Stéréo/Mono	Via MPX	Via bit MS RDS
Niveaux L/R	✅	✅
SNR audio	✅	✅
Qualité réception	Bonne	Excellente

Name		Name	Last commit message	Last commit date
Latest commit History 53 Commits
docs		docs
static		static
templates		templates
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
README.md		README.md
app.py		app.py
auth.py		auth.py
config.example.json		config.example.json
config.json.example		config.json.example
database.py		database.py
email_alert.py		email_alert.py
generate_ssl.sh		generate_ssl.sh
install.sh		install.sh
monitor.py		monitor.py
mpx_analyzer.py		mpx_analyzer.py
rds_lookup.py		rds_lookup.py
requirements.txt		requirements.txt
tailwind.config.js		tailwind.config.js
tef_audio_analyzer.py		tef_audio_analyzer.py
tef_driver.py		tef_driver.py
update.sh		update.sh

Folders and files

Latest commit

History

Repository files navigation

📻 FM Monitor

✨ Fonctionnalités

📡 Réception & Analyse

📊 Analyse MPX temps réel

📻 Décodage RDS

🔊 Streaming Audio

🔔 Alertes & Surveillance

🌐 Interface Web

🔧 Matériel compatible

Installation drivers RTL-SDR Blog V4

🚀 Installation

⚡ Installation automatique (recommandée)

🔧 Installation manuelle

Prérequis système

1. Cloner le dépôt

2. Installer les dépendances

3. Configurer

4. Générer les certificats SSL

5. Configurer Icecast2

6. Créer le service systemd

7. Accéder au dashboard

📂 Structure du projet

📖 Documentation

🛠️ Dépannage

Le dongle n'est pas détecté

Pas de signal audio

Les emails ne partent pas

Le RDS n'apparaît pas

🗺️ Roadmap

📄 Licence

🙏 Crédits

Changement de source : RTL-SDR ↔ TEF668X Headless

Passer en mode TEF668X Headless

Revenir en mode RTL-SDR

Différences entre les deux modes

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases 3

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages