Wiki - Winboat

Article wiki - Winboat

Table des Matières

Présentation générale

Winboat est un outil révolutionnaire qui permet d'exécuter des applications Windows directement sous Linux avec une intégration transparente. Fini les ruptures de flux de travail : Winboat fait pont entre ces deux écosystèmes en offrant une interface élégante et intuitive, où les programmes Windows s'intègrent parfaitement à votre environnement de bureau Linux, comme s'ils étaient natifs.

Conçu pour les administrateurs systèmes, les développeurs et les utilisateurs avancés à la recherche d'interopérabilité, l'outil se distingue par sa légèreté et son automatisation native. Il s'intègre sans effort dans vos scripts Bash et vos pipelines CI/CD, permettant de piloter des services, gérer des fichiers et exécuter des commandes à distance via des protocoles sécurisés comme WinRM.

Public cible

  • Administrateurs systèmes gérant des environnements hétérogènes

  • Développeurs needing des outils spécifiques Windows sous Linux

  • Utilisateurs cherchant une alternative légère et sécurisée à la virtualisation classique

Nouveautés de la version v0.9.0

La récente version v0.9.0 (publiée fin 2025) apporte des améliorations majeures :

  • Support de Podman 🐳

  • Support des applications UWP : Il est désormais possible de voir et de lancer directement vos applications Universal Windows Platform.

Bien que toujours en phase bêta, Winboat promet une expérience fluide et entièrement pilotable au clavier pour booster votre productivité au quotidien.

Historique et versions

Développé par TibixDev et hébergé sur GitHub, WinBoat a rapidement conquis la communauté Linux, accumulant plus de 20 000 étoiles. Le projet se positionne comme une solution élégante pour exécuter des applications Windows sous Linux avec une intégration fluide.

Bien que l'outil soit actuellement en phase beta, son développement est très actif. Les utilisateurs doivent s'attendre à quelques instabilités, mais l'essayer est vivement encouragé pour remonter les bogues.

Version 0.9.0 : une étape majeure

Publiée le 23 novembre 2025, la version v0.9.0 marque une évolution significative du projet avec l'arrivée de fonctionnalités très demandées :

  • 🐳 Support de Podman : en plus de Docker, il est désormais possible de choisir Podman lors de l'installation pour conteneuriser Windows. Attention cependant, le passthrough USB n'est pas encore supporté sous Podman.

  • Applications UWP : WinBoat supporte désormais les applications Universal Windows Platform (UWP), permettant de les voir et de les lancer directement depuis l'interface.

Cette version a reçu un excellent accueil, cumulant plus de 160 réactions positives sur GitHub. L'approche reste orientée vers l'automatisation et la simplification des installations, rendant l'expérience Windows sous Linux de plus en plus transparente.

Caractéristiques principales

Winboat se démarque comme un pont élégant entre les écosystèmes Linux et Windows, permettant d'exécuter des applications Windows avec une intégration transparente sur votre bureau Linux.

Points forts

  • Intégration fluide : Il offre une interface soignée qui s'intègre nativement à l'environnement de bureau Linux, rendant l'utilisation d'applications Windows intuitive et déconnectée de la virtualisation classique.

  • Installation automatisée : Le déploiement de l'environnement Windows est grandement simplifié grâce à un processus d'installation automatisé, rapide et sans friction.

  • Support des conteneurs : Depuis la version v0.9.0, Podman est pris en charge lors de l'installation en complément des solutions existantes, offrant ainsi plus de flexibilité pour la gestion des conteneurs.

  • Compatibilité UWP : Winboat permet désormais de détecter et de lancer les applications de la plateforme Windows universelle (UWP), élargissant considérablement le catalogue logiciel accessible.

Limites

  • Projet en bêta : L'outil est toujours en phase de développement actif. Il faut s'attendre à des bugs occasionnels et posséder un minimum d'aisance pour le dépannage.

  • Pas de passthrough USB sur Podman : Le transfert USB (USB passthrough) n'est pas encore supporté lorsque l'on utilise Podman comme moteur de conteneur.

Cas d'usage

Winboat est idéal pour les administrateurs systèmes et les développeurs travaillant sous Linux mais nécessitant des outils spécifiques à Windows (logiciels métiers, suites Office, applications UWP). Il convient parfaitement aux workflows CI/CD où l'automatisation de tâches Windows depuis un hôte Linux est requise, tout en conservant un environnement de travail unifié.

Prérequis système

Avant d'installer Winboat pour exécuter vos applications Windows sous Linux avec une intégration fluide, assurez-vous que votre système répond aux exigences suivantes.

Matériel

  • Processeur : Architecture x86_64 avec support de virtualisation matérielle (VT-x ou AMD-V) activé dans le BIOS/UEFI.

  • Mémoire vive : Minimum 8 Go de RAM (16 Go recommandés pour allouer confortablement la machine virtuelle Windows).

  • Espace disque : Au moins 40 Go d'espace de stockage libre pour l'image Windows et les conteneurs.

Logiciel et Dépendances

  • Système d'exploitation : Distribution Linux récente.

  • Environnement de conteneurisation : Depuis la version v0.9.0, Winboat supporte Podman en plus de Docker. L'un des deux doit être installé et fonctionnel.

  • Environnement graphique : Un serveur X11 ou Wayland fonctionnel pour l'affichage des fenêtres Windows intégrées.

Recommandations

Winboat étant actuellement en phase beta, une certaine aisance avec le dépannage en ligne de commande est conseillée. Notez que le pass-through USB n'est pas encore pris en charge si vous optez pour Podman. Pour une stabilité optimale avec les périphériques externes, priviléciez temporairement Docker.

Installation détaillée

Winboat est actuellement en phase bêta (v0.9.0), mais s'installe facilement grâce à plusieurs méthodes. Avant de commencer, assurez-vous de disposer d'un moteur de conteneur : Docker ou Podman (supporté depuis la v0.9.0, bien que le passthrough USB ne soit pas encore disponible avec ce dernier).

Méthode 1 : Installation via le script officiel (Recommandée)

C'est la méthode la plus rapide pour obtenir la dernière version stable.

  1. Ouvrez votre terminal Linux.

  2. Téléchargez et exécutez le script d'installation :

    curl -fsSL https://winboat.app/install.sh | bash
  3. Lors de l'installation, le script vous demandera de choisir votre runtime de conteneur (docker ou podman).

Méthode 2 : Installation manuelle depuis GitHub

Pour les utilisateurs souhaitant plus de contrôle ou une version spécifique :

  1. Rendez-vous sur la page des releases.

  2. Téléchargez l'archive correspondant à votre architecture (binaire compilé en TypeScript).

  3. Décompressez l'archive et déplacez l'exécutable dans votre PATH :

    tar -xzf winboat-0.9.0.tar.gz
    sudo mv winboat /usr/local/bin/

Méthode 3 : Compilation depuis les sources

Réservée aux contributeurs ou utilisateurs avancés :

  1. Clonez le dépôt :

    git clone https://github.com/TibixDev/winboat.git
    cd winboat
  2. Installez les dépendances et compilez :

    npm install
    npm run build

Note : Étant donné que Winboat est en développement actif, attendez-vous à des bugs occasionnels. N'hésitez pas à remonter les problèmes sur le dépôt GitHub.

Configuration de base

Winboat étant toujours en phase bêta, il est essentiel de maîtriser ses réglages initiaux pour tirer le meilleur parti de l'intégration de vos applications Windows sous Linux. Voici les étapes et bonnes pratiques pour une mise en route optimale.

Choix du moteur de conteneurisation

Lors de la première exécution, Winboat vous invite à sélectionner votre moteur d'exécution. Depuis la v0.9.0, Podman est désormais supporté en alternative à Docker. Si vous privilégiez la sécurité et l'exécution sans daemon root, optez pour Podman. Notez cependant que le passthrough USB n'est pas encore supporté sous Podman.

Prise en charge des applications UWP

La version v0.9.0 introduit le support des applications UWP (Universal Windows Platform). Pour les activer et les lister automatiquement dans l'interface élégante de Winboat, assurez-vous de mettre à jour votre installation via le dépôt GitHub.

Bonnes pratiques

  • Mises à jour régulières : Le projet évolue vite. Surveillez les releases pour bénéficier des dernières corrections de bugs.

  • Résolution d'affichage : Pour une intégration fluide et seamless, ajustez la résolution de la machine virtuelle directement dans les paramètres de Winboat pour qu'elle corresponde à celle de votre hôte Linux.

  • Débogage : En cas de pépins, consultez les logs avec l'option --verbose avant de remonter un incident.

Utilisation et commandes principales

Winboat s'utilise principalement en ligne de commande pour orchestrer vos environnements Windows directement depuis votre terminal Linux. Son interface unifiée permet d'automatiser les tâches courantes avec une syntaxe intuitive et pilotable au clavier.

Initialisation et gestion des machines

Lors de la première utilisation, l'assistant d'installation vous guide pour préparer votre environnement :

  • winboat setup : Lance la configuration initiale. Depuis la version v0.9.0, vous pouvez choisir entre Docker ou Podman comme moteur de conteneurisation.

  • winboat start : Démarre l'environnement Windows virtualisé en arrière-plan.

Exécution d'applications Windows

Le cœur de Winboat réside dans le lancement transparent d'applications Windows qui s'intègrent directement sur votre bureau Linux :

  • winboat run <application> : Exécute une application Windows classique.

  • winboat run-uwp <app> : Lance une application UWP (Universal Windows Platform), une fonctionnalité introduite dans la v0.9.0.

Automatisation et intégration

Winboat excelle dans l'automatisation native et s'intègre parfaitement dans vos scripts Bash ou pipelines CI/CD :

# Exemple de script automatisé
winboat start
winboat run-uwp Microsoft.WindowsCalculator
winboat exec "dir C:Users"

Note : Le projet est actuellement en phase Beta. Le passthrough USB n'est pas encore supporté avec Podman. Prévoyez un peu de dépannage si vous adoptez cet outil au quotidien.

Trucs, astuces et FAQ

Astuces pratiques

  • Choisir Podman comme backend : Depuis la version v0.9.0, Winboat supporte Podman. Sélectionnez-le lors de l'installation pour une solution sans daemon et plus légère. Notez cependant que le passthrough USB n'est pas encore supporté avec Podman.

  • Lancer des applications UWP : Winboat permet désormais de détecter et d'exécuter vos applications Windows UWP directement depuis votre environnement Linux.

  • Automatisation CI/CD : Utilisez la syntaxe CLI de Winboat dans vos scripts Bash pour chaîner des actions entre vos hôtes Linux et Windows sans quitter le terminal.

Problèmes courants et solutions

  • « L'installation de Windows échoue » : Assurez-vous que les virtualisations (KVM/QEMU) sont activées dans votre BIOS et que les modules noyau requis sont chargés.

  • « Winboat est en beta, est-ce stable ? : Le projet est encore en développement actif. Des bugs sont possibles. Consultez les releases sur GitHub pour les derniers correctifs.

FAQ

Puis-je partager des périphériques USB avec Podman ?
Non, le passthrough USB n'est pas encore supporté avec le backend Podman. Utilisez le backend classique si cette fonctionnalité est indispensable.

Comment mettre à jour ?
Téléchargez la dernière version (v0.9.0+) depuis le dépôt officiel et relance le script d'installation pour écraser l'ancienne version.

Ressources et liens utiles

Pour tirer le meilleur parti de Winboat et suivre son développement actif, voici les ressources officielles et essentielles à consulter. L'outil étant actuellement en phase beta, ces liens vous permettront de rester informé des dernières évolutions et de trouver de l'aide en cas de besoin.

Documentation et dépôt officiel

  • Site web officiel : winboat.app — Découvrez la présentation du projet, ses fonctionnalités clés comme l'interface élégante et l'installation automatisée, ainsi que le lien de téléchargement de la version beta.

  • Dépôt GitHub : TibixDev/winboat — Accédez au code source, consultez les README, ouvrez des tickets (issues) pour le support ou contribuez au projet.

Notes de version et mises à jour

  • Dernière version stable : Release v0.9.0 — Publiée fin 2025, cette mise à jour majeure apporte le support de 🐳 Podman (en alternative à Docker) lors de l'installation, ainsi que la prise en charge des applications UWP (Universal Windows Platform). Notez que le passthrough USB n'est pas encore supporté sous Podman.

  • Toutes les releases : Releases GitHub — Historique complet des versions disponibles.

Communauté et suivi

Winboat étant un projet en cours de développement, il est recommandé de surveiller le dépôt pour suivre les correctifs. N'hésitez pas à consulter la section Issues pour les solutions de dépannage courantes.