Schéma d'URL pour Chute iOS, Chute tvOS, Chute Mac et Chute Android

Chute iOS (à partir de la version 1.0.2) et Chute tvOS prennent en charge les actions suivantes ainsi qu'une option.

Chute Mac enregistre le même schéma chute mais ne répond qu'à deux verbes, install-config et import, sous la forme hôte comme sous la forme chemin : chute://import?url=... et chute:///install-config?url=.... La valeur de url= doit être une adresse http ou https ou un lien de partage (ss://, vmess://, …) ; tout le reste est refusé. Chute Mac demande confirmation avant de récupérer quoi que ce soit, puis transmet l'adresse à l'onglet Profils de la fenêtre principale, qui l'importe : un profil natif est enregistré comme configuration gérée avec un intervalle de mise à jour de 24 heures, un profil Clash ou sing-box est converti et enregistré comme instantané statique, et un lien de partage — ou un abonnement qui renvoie une liste de tels liens — est converti en profil. start, stop, toggle et tv ne sont pas des actions du Mac.

Chute Android gère les liens d'import décrits en fin de page.

Action :

• start | connect | on

  Démarre avec la configuration sélectionnée.

  Exemple : chute://start chute:///start

• stop | disconnect | off

  Arrête la session en cours.

• toggle | switch

  Démarre ou arrête avec la configuration sélectionnée.

• tv (Chute iOS uniquement)

  Ouvre la vue d'importation de configuration distante avec l'URL de configuration indiquée. Cette action n'est disponible que sur Chute iOS ; Chute tvOS ne gère que start/stop/toggle.

  Contrairement aux autres actions, tv n'est reconnue que sur l'hôte : la forme chemin chute:///tv?url=... ne fait donc rien.

  Exemple : chute://tv?url=https://example.com/chute.conf

Option :

• autoclose=true

  Ferme automatiquement Chute une fois l'action terminée. Chute iOS uniquement : Chute tvOS accepte le paramètre et l'ignore, et l'application reste ouverte.

  Exemple : chute:///toggle?autoclose=true

Remarque : sur Chute iOS, seule la première URL d'une activation est traitée ; un raccourci qui remet à Chute plusieurs URL chute:// d'un coup n'en exécute donc qu'une.

x-callback-url

Chute prend en charge la spécification x-callback-url. Le schéma d'URL est « chute » et les actions disponibles sont « start », « stop » et « toggle ».

x-success et x-error doivent être encadrés de doubles accolades, exactement comme dans l'exemple ci-dessous. Une valeur écrite sans elles est lue comme vide et aucun rappel n'est ouvert. x-cancel n'est pas géré.

Exemple : chute://x-callback-url/start?x-success={{ "{{sms://}}" }}&x-error={{ "{{tel://}}" }}

x-success est ouvert dès que Chute a actionné l'interrupteur. Il indique que la demande a été exécutée, pas que le tunnel s'est établi : un démarrage qui échoue, ou une invite VPN que vous refusez, aboutit quand même à x-success. x-error n'est ouvert que lorsque start trouve le tunnel déjà actif ou que stop le trouve déjà arrêté, une fois fermée l'alerte qui le signale ; toggle ne l'ouvre jamais. Sans configuration sélectionnée, aucun des deux rappels n'est ouvert.

Chute Android

Chute Android ouvre les liens chute:// (et les QR codes qui les portent, scannés sur la page Configurations ou dans l'assistant de configuration) uniquement pour importer :

• chute://download?url=... (aussi import, install-config) — télécharge une fois la configuration à url. Un profil natif est enregistré avec un en-tête #!MANAGED-CONFIG <url> dépourvu d'interval= ; un profil Clash ou sing-box est converti et enregistré comme instantané statique, sans cet en-tête.
• chute://subscribe?url=... — un alias de download, pas un abonnement. Il suit le même parcours de téléchargement unique, et comme le fichier qu'il écrit n'a pas d'interval=, l'application ne le rafraîchit jamais. Pour un profil natif, un moteur en cours d'exécution récupère tout de même l'URL toutes les 24 heures et applique le nouveau contenu en mémoire, et le démarrage suivant relit le fichier — voir Configuration gérée. Pour que Chute tienne un abonnement à jour, utilisez Ajouter un abonnement dans l'application, qui demande l'intervalle.
• chute://tv?url=... (aussi remote) — charge le dépôt de configurations distant à url.

Une configuration qu'ajoute un lien ouvert depuis l'extérieur de l'application — téléchargée, ou choisie dans le dépôt qu'ouvre un lien tv — n'est pas sélectionnée : Chute ouvre la page Configurations en la marquant En attente, et elle ne devient la configuration exécutée que lorsque vous touchez Terminé ; un tel lien ne change donc jamais la configuration que Chute exécute.

Un lien ouvert depuis l'extérieur de l'application convertit un profil Clash ou sing-box comme Télécharger depuis une URL sur la page Configurations, tout comme le même lien scanné sur cette page avec Télécharger depuis un QR code ou dans l'assistant de configuration. Seul l'assistant de configuration conserve un profil natif comme abonnement : scanné là, le lien donne une configuration que l'application rafraîchit toutes les 86400 secondes, alors que le même lien ouvert depuis l'extérieur de l'application télécharge le fichier une seule fois et que l'application ne le rafraîchit jamais.

start, stop et toggle ne sont pas des actions d'URL sur Android. Les applications d'automatisation utilisent à la place des Intents de diffusion : com.r3studio.chute.action.START_VPN, com.r3studio.chute.action.STOP_VPN et com.r3studio.chute.action.TOGGLE_VPN.

Une diffusion ne peut pas afficher la boîte de dialogue système de consentement VPN. START_VPN est donc abandonné en silence tant que le consentement n'a pas été accordé, tandis que TOGGLE_VPN ouvre Chute à la place : touchez-y l'interrupteur pour accorder le consentement — ce geste démarre aussi le tunnel — et les diffusions fonctionnent dès lors. En mode de service Proxy local, il n'y a aucun consentement à accorder et les deux fonctionnent immédiatement.