<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" style="task" id="install-guest-tools" xml:lang="fr">
  <info>
    <revision version="0.1" date="2022-03-29" status="candidate"/>
    <link type="guide" xref="index#use"/>

    <credit type="author copyright">
      <name>Felipe Borges</name>
      <email>felipeborges@gnome.org</email>
      <years>2022</years>
    </credit>

    <include xmlns="http://www.w3.org/2001/XInclude" href="legal.xml"/>

    <desc>Activer les intégrations additionnelles sur votre machine virtuelle.</desc>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Julien Hardelin</mal:name>
      <mal:email>jhardlin@orange.fr</mal:email>
      <mal:years>2014, 2018</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Alain Lojewski</mal:name>
      <mal:email>allomervan@gmail.com</mal:email>
      <mal:years>2014</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>David Ducassou</mal:name>
      <mal:email>david.ducassou@free.fr</mal:email>
      <mal:years>2017</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Guillaume Bernard</mal:name>
      <mal:email>associations@guillaume-bernard.fr</mal:email>
      <mal:years>2017-2024</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Charles Monzat</mal:name>
      <mal:email>charles.monzat@free.fr</mal:email>
      <mal:years>2020-2021</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Jean-Marc Tissières</mal:name>
      <mal:email>jmetissieres@gmail.com</mal:email>
      <mal:years>2022-2023</mal:years>
    </mal:credit>
  </info>

  <title>Installer les outils d’invité</title>

  <p>Les outils d’invité sont constitués d’un ensemble de pilotes et d’utilitaires qui facilitent l’utilisation de votre machine virtuelle. Ils améliorent les performances des dispositifs de saisie et permettent l’ajustement automatique de la résolution de l’écran, le partage du presse-papier et l’échange de fichiers.</p>

  <section id="installing-on-windows">
    <title>Installation sur les machines virtuelles Windows</title>

    <p>Rendez-vous sur le site <link href="https://win.gnomeboxes.org">win.gnomeboxes.org</link> depuis votre machine virtuelle Windows afin de télécharger et d’installer l’application <app>spice-guest-tools</app> qui fournit l’intégration des outils d’invité pour Machines.</p>
  </section>

  <section id="installing-on-linux">
    <title>Installation sur les machines virtuelles Linux</title>

    <p>Dans les distributions Linux les plus populaires, les outils d’invité sont empaquetés sous le nom de <app>spice-vdagent</app>.</p>

    <p>L’agent « spice » (« Spice agent ») pour Linux comprend deux éléments, un processus d’arrière-plan <app>spice-vdagentd</app> et un processus pour la session graphique <app>spice-vdagent</app>. Le processus d’arrière-plan est lancé au démarrage dans les invités soit via un script d’initialisation « Sys-V », soit en tant que service « systemd ». Le processus de session est automatiquement lancé dans les environnements de bureau d’après le fichier <file>/etc/xdg/autostart</file>, et le gestionnaire de session <app>gdm</app>.</p>

    <section id="installing-on-rpm">
      <title>Installation sur les distributions basées sur le système de paquet RPM</title>

      <p>Certaines distributions telles que Fedora, Red Hat Enterprise Linux, CentOS Stream ou OpenSUSE fournissent <app>spice-vdagent</app> dans leurs dépôts.</p>

      <screen>sudo dnf install spice-vdagent</screen>
    </section>

    <section id="installing-on-deb">
      <title>Installation sur les distributions basées sur Debian</title>

      <p>Certaines distributions telles qu’Ubuntu, Debian ou Linux Mint fournissent <app>spice-vdagent</app> dans leurs dépôts.</p>

      <screen>sudo apt install spice-vdagent</screen>
    </section>
  </section>
</page>
