Protocole vidbee://

VidBee enregistre un protocole d’URL personnalisé (vidbee://) qui permet de déclencher des téléchargements directement depuis les navigateurs, extensions ou userscripts.

Utilisation de base

Le protocole vidbee:// peut ouvrir VidBee et démarrer automatiquement le téléchargement de vidéos.

Format du protocole

vidbee://download?url=<url-video-encodee>

Paramètres :

url (obligatoire) : l’URL de la vidéo à télécharger, encodée en URL

Exemple

Pour télécharger une vidéo YouTube :

<a href="vidbee://download?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ">
  Télécharger avec VidBee
</a>

Ou en JavaScript :

const videoUrl = 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
const vidbeeUrl = `vidbee://download?url=${encodeURIComponent(videoUrl)}`
window.location.href = vidbeeUrl

Ouvrir VidBee

Pour ouvrir VidBee sans lancer de téléchargement :

vidbee://

Cas d’usage

Extension de navigateur

L’extension VidBee utilise ce protocole pour envoyer l’URL de l’onglet actuel à l’application :

const currentUrl = window.location.href
const deepLink = `vidbee://download?url=${encodeURIComponent(currentUrl)}`
window.location.href = deepLink

Intégration userscript

Le userscript VidBee ajoute des boutons de téléchargement rapide sur les sites pris en charge :

// Un clic déclenche le téléchargement via le protocole
const vidbeeUrl = `vidbee://download?url=${encodeURIComponent(videoUrl)}`
window.location.href = vidbeeUrl

Pages web

Vous pouvez ajouter des liens de téléchargement direct à vos pages web :

<!-- Lien simple -->
<a href="vidbee://download?url=https%3A%2F%2Fexample.com%2Fvideo">
  Télécharger avec VidBee
</a>

<!-- Bouton avec JavaScript -->
<button onclick="openInVidBee('https://example.com/video')">
  Téléchargement rapide
</button>

<script>
function openInVidBee(url) {
  const vidbeeUrl = `vidbee://download?url=${encodeURIComponent(url)}`
  window.location.href = vidbeeUrl
}
</script>

Prise en charge des playlists

Pour télécharger une playlist entière :

vidbee://download?url=<url-playlist-encodee>&type=playlist

Paramètres :

url (obligatoire) : l’URL de la playlist, encodée en URL
type : définir playlist pour télécharger toutes les vidéos de la playlist

Exemple

const playlistUrl = 'https://www.youtube.com/playlist?list=PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf'
const vidbeeUrl = `vidbee://download?url=${encodeURIComponent(playlistUrl)}&type=playlist`
window.location.href = vidbeeUrl

Comment ça marche

Enregistrement du protocole : VidBee s’enregistre comme gestionnaire du protocole vidbee:// lors de l’installation
Analyse de l’URL : quand un lien vidbee://download?url=... est cliqué, le système lance VidBee
Traitement de la file : VidBee extrait l’URL vidéo et l’ajoute à la file de téléchargement
Démarrage automatique : le téléchargement commence automatiquement si l’application est configurée pour cela

Compatibilité des navigateurs

Le protocole vidbee:// fonctionne sur tous les navigateurs majeurs :

Chrome/Edge/Brave
Firefox
Safari

Notes de sécurité

Seules les URL commençant par vidbee:// déclenchent l’application
L’application valide le format d’URL avant traitement
Les URL mal formées sont ignorées avec un avertissement dans les logs

Dépannage

Le protocole ne fonctionne pas

Si cliquer sur des liens vidbee:// n’ouvre pas VidBee :

Vérifier l’installation : assurez-vous que VidBee est bien installé
Réinstaller : essayez de réinstaller VidBee pour ré-enregistrer le protocole
Permissions OS : sur macOS, vérifiez Réglages Système > Confidentialité et sécurité pour d’éventuels blocages
Réglages du navigateur : certains navigateurs demandent une autorisation au premier usage

L’application s’ouvre mais ne télécharge pas

Si VidBee s’ouvre mais que le téléchargement ne démarre pas :

Vérifier l’encodage : assurez-vous que l’URL est bien encodée avec encodeURIComponent()
Vérifier les logs : ouvrez l’application et consultez la console développeur pour les erreurs
Sites pris en charge : vérifiez que l’URL provient d’un site pris en charge

On this page