Skip to content

Documentation : le satellite Android et l'accès à distance - #44

Open
Malvu wants to merge 1 commit into
lfpoulain:betafrom
Malvu:docs/satellite-android
Open

Malvu wants to merge 1 commit into
lfpoulain:betafrom
Malvu:docs/satellite-android

Conversation

@Malvu

@Malvu Malvu commented Nov 10, 2026 •

Copy link
Copy Markdown

Suite du ticket #43.

Ajoute la page Le satellite Android, un lien dans l'index, une entrée au CHANGELOG, et un renvoi depuis la page des satellites audio.

Ce qui change pour l'utilisateur

La documentation explique comment installer et associer l'application, les deux modes d'écoute, et l'accès hors du réseau local par un tunnel WireGuard, avec les quatre pièges rencontrés : une règle de redirection inactive, deux routeurs empilés, un profil limité à une autre application, l'adresse publique qui change.

Ce qui n'est pas touché

Aucun code, aucun binaire, aucune dépendance. Le serveur ne bouge pas, et sa règle « réseau local seulement » reste telle quelle.

Comment c'est vérifié

Les chiffres de la page viennent d'essais réels : association, conversation, 186 ms en 4G Wi-Fi coupé, connexion vue en 10.6.0.3 dans le journal. Les liens internes sont relatifs et vérifiés. Le changement n'ajoute que des fichiers Markdown.

@Malvu Malvu changed the title Documentation : le satellite Android et l'acces a distance Documentation : le satellite Android et l'accès à distance Nov 10, 2026
@Malvu
Malvu force-pushed the docs/satellite-android branch from 98d1da3 to 173448c Compare November 10, 2026 12:35
@lfpoulain

Copy link
Copy Markdown
Owner

Merci pour la page, elle est claire et les pièges WireGuard sont précieux : on nous pose souvent la question de l'accès hors de la maison, et la réponse « on ne présente pas d'adresse publique à Cornelius » est la bonne.

Deux demandes avant de fusionner :

  1. Branche cible. La PR vise main. Peux-tu la recibler sur beta et la rebaser ? Seul le CHANGELOG.md est en conflit.
  2. Dire clairement que c'est un projet tiers. La page est dans docs/fonctionnalites/, au même rang que les fonctions de Cornelius. Il faudrait un encadré en tête : application communautaire, non maintenue par le projet, APK à installer depuis un dépôt tiers, sous la responsabilité de chacun. Et la ligne de licence (modèle du mot d'appel en CC BY-NC-SA 4.0) peut rester dans les limites, mais elle mérite d'être visible dès cet encadré.

Une précision technique à vérifier : la page dit que le téléphone utilise « les trois modèles ONNX fournis par Cornelius ». Si l'application les télécharge depuis le serveur, ajoute-le (ce qu'elle télécharge, et quand) ; si elle les embarque, la phrase est à corriger.

- page docs/fonctionnalites/satellite-android.md, ouverte par un encadré
  d’application communautaire : non maintenue par le projet, APK d’un dépôt
  tiers, installation sous la responsabilité de chacun, licence du modèle
  visible dès l’en-tête
- lien depuis l’index de la documentation et depuis les satellites audio
- entrée au CHANGELOG, placée dans le « Non publié » de la branche beta

La page dit maintenant que les trois modèles ONNX sont embarqués dans l’APK,
lus sur place, et qu’un seul des trois vient du dépôt de Cornelius : les deux
autres viennent d’openWakeWord. Rien ne se télécharge au lancement.

Aucun changement de code : l’application est séparée du dépôt et parle le
protocole des satellites.
@Malvu
Malvu force-pushed the docs/satellite-android branch from 173448c to d4a6e87 Compare November 12, 2026 18:46
@Malvu
Malvu changed the base branch from main to beta November 12, 2026 18:46
@Malvu

Malvu commented Nov 12, 2026

Copy link
Copy Markdown
Author

Merci pour la relecture.

1. Branche cible. La PR vise maintenant beta, et la branche est rebasée dessus : plus de conflit, GitHub la donne fusionnable. Le conflit était bien le seul, et il venait de « Non publié » : sur beta il contient déjà les entrées du 11 novembre, alors que ma branche partait de main (0.3.0) et remplaçait encore « Rien pour l’instant. ». J’ai gardé la section de beta et placé mon entrée en tête, datée du 12 novembre. docs/README.md et la page des satellites passent sans conflit, et les liens de la page existent tous sur beta.

2. Projet tiers. D’accord. Un encadré ouvre désormais la page : application communautaire, écrite et publiée à part, ni maintenance ni support par le projet, APK d’un dépôt tiers à installer en acceptant les applications inconnues, chaque installation sous la responsabilité de la personne qui la fait — et la licence du modèle (CC BY-NC-SA 4.0, usage familial et non commercial, attributions à conserver) dès cet encadré. La ligne des limites reste, en renvoyant à l’encadré pour ne pas la répéter en entier.

3. Modèles ONNX. La phrase était fausse, et pour deux raisons. D’abord l’application ne télécharge rien : les trois modèles sont dans l’APK (app/src/main/assets/models/, 2,6 Mo) et lus sur place par ONNX Runtime, au démarrage de l’écoute. Ensuite un seul des trois vient de Cornelius : cornelius.onnx (CC BY-NC-SA 4.0) ; melspectrogram.onnx et embedding_model.onnx viennent d’openWakeWord 0.5.1 (Apache 2.0). La page dit maintenant cela, et que rien ne se télécharge au lancement.

Pour être complet : côté serveur, les deux modèles de prétraitement sont bien téléchargés à l’installation par perception/install_wake_features.py, mais le téléphone ne dépend pas de ce téléchargement, puisqu’il a les siens dans l’APK.

Toujours du Markdown seul : aucun code, aucun binaire, aucune dépendance.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants