Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Add Freebox telephony status monitoring

Aperta
  • Qualcosa non va?
#1,827 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
45/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
python
Ambito
backend

Direzione di ricerca

Read the existing Freebox plugin and its API v6 authorization/token flow, then review the Freebox phone API calls the reporter has tested. Confirm with maintainers whether this belongs in the existing plugin or a companion plugin before choosing an entry point. Done means optional read-only telephony status monitoring reuses the existing token, excludes call and personal data and write actions, and has tests.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Feature request ➕ please feedback 💬
Is there an existing issue for this?
  • I have searched the existing open and closed issues
Is your feature request related to a problem? Please describe

The existing Freebox plugin can discover the Freebox and connected LAN devices, but it does not currently expose telephony status available through the Freebox API.

The Freebox API provides read-only information about the telephone service and connected phone interfaces, for example:

  • telephone service/network state
  • FXS/phone interface status
  • hardware fault state
  • DECT enabled/registration state
  • hook/ringing state

This could be useful for monitoring the Freebox telephone service without creating a separate external monitoring solution.

Describe the solution you'd like

Add optional read-only monitoring of Freebox telephony status to NetAlertX.

The implementation should reuse the existing Freebox authorization/token and should not require a second pairing.

Only non-sensitive operational information should be exposed. In particular, the feature should not collect or expose:

  • call history
  • phone numbers
  • caller names
  • contacts
  • DECT PINs
  • any write/configuration actions

I have confirmed on a Freebox v8 that the existing NetAlertX Freebox authorization can access the Freebox phone API successfully.

I would be happy to help implement this, but before starting I wanted to check whether this is something the maintainers would be interested in and whether you would prefer it to be integrated into the existing Freebox plugin or exposed as a separate companion plugin.

Describe alternatives you've considered

The main alternatives I considered are:

  1. Extending the existing Freebox device-scanner plugin directly.
  2. Adding a small companion Freebox telephony plugin using the existing Freebox pairing/token.
  3. Monitoring the telephone service outside NetAlertX.

A companion plugin may fit the current plugin model better because telephony interfaces are not normal network devices with MAC/IP identities, but I would prefer to follow the maintainers' preferred architecture before implementing anything.

Anything else?

I have already tested the underlying Freebox API read-only calls successfully.

The current Freebox integration uses API v6, and the same existing NetAlertX token was able to retrieve telephone service and phone-interface status without any additional pairing.

The intended scope would be monitoring only. No telephony configuration or call data would be included.

If this feature is considered useful, I am willing to prepare the implementation and tests against next_release following the project contribution guidelines.

Am I willing to test this? 🧪
  • I will do my best to test this feature on the netlertx-dev image when requested within 48h and report bugs to help deliver a great user experience for everyone and not to break existing installations.
Can I help implement this? 👩‍💻👨‍💻
  • Yes
  • No
Lingua principale
Python
Stelle
7.2k
Fork
456
Merge medio
16h 25m
PR unite (30g)
30

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di netalertx/NetAlertX

Tutte le issue di netalertx/NetAlertX

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.