> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-fr/shadefs/introduction-to-shadefs.md).

# Introduction à ShadeFS

## **Vue d'ensemble**

ShadeFS est une solution de montage de lecteur cloud qui transforme complètement votre façon d’interagir avec des fichiers multimédias stockés dans le cloud. Contrairement aux solutions de stockage cloud traditionnelles qui nécessitent le téléchargement complet des fichiers avant d’y accéder (ahem Dropbox), ShadeFS diffuse en temps réel les segments dont vous avez besoin, un peu comme YouTube fournit du contenu vidéo. Cette approche vous donne un accès immédiat à vos médias tout en optimisant l’utilisation de la bande passante.

## **Fonctionnalités clés**

* ShadeFS transforme votre lecteur cloud en un dossier local accessible par défaut via le dossier « /Volumes »
* Lorsque vous montez un lecteur, il apparaît dans votre système de fichiers local comme un disque dur physique, mais avec l’avantage supplémentaire d’un streaming et d’une mise en cache intelligents
* Le système synchronise automatiquement les arborescences de fichiers entre tous les utilisateurs, garantissant que toute votre équipe travaille avec la même structure de contenu, quel que soit son emplacement.
* Les fichiers téléversés sont automatiquement transmis via nos pipelines de génération de proxy et d’analyse IA

## **Configuration requise**

ShadeFS a quelques exigences pour fonctionner de manière optimale sur votre machine.

* Pour travailler avec du contenu vidéo 4K, nous recommandons une vitesse Internet minimale de 500 Mbps en téléchargement
* Les utilisateurs disposant d’une bande passante plus faible devraient envisager de travailler avec des fichiers proxy ou du contenu en résolution inférieure à la 4K
* Votre appareil doit également disposer d’un espace de stockage suffisant pour le cache, avec un minimum de 10 Go pour les opérations de base

## **Premiers pas**

Une fois l’application de bureau téléchargée et ouverte, vous pouvez monter n’importe quel lecteur en y accédant dans le panneau de gauche, en cliquant sur le menu « ... » et en sélectionnant « Monter le lecteur ». Le lecteur apparaîtra dans votre explorateur de fichiers local, que vous utilisiez Windows, macOS ou Linux.

{% embed url="<https://youtu.be/Cl3A47wWuxY?si=BR8w6EY8fmBrkYZN>" %}

## **Configuration du cache**

ShadeFS utilise un système de cache pour optimiser les performances de vos fichiers multimédias. Par défaut, le système crée un cache de 26 Go dans le **.shade** dossier situé dans le répertoire racine de votre utilisateur. Cependant, vous pouvez personnaliser à la fois l’emplacement et la taille du cache pour mieux répondre à vos besoins.

[Gestion du cache ShadeFS](https://academy.shade.inc/shadefs/managing-the-shadefs-cache)

## **Répertoire du cache**

Pour modifier le répertoire de votre cache, accédez à Paramètres/Préférences dans l’application. Vous pouvez ici sélectionner n’importe quel dossier de votre ordinateur ou un lecteur externe comme emplacement du cache. Nous recommandons particulièrement d’utiliser un SSD externe rapide, comme un Samsung T7, pour des performances optimales.

## **Directives d’utilisation de ShadeFS**

## **Autorisations**

L’accès et les capacités de montage de ShadeFS sont réservés aux sous-traitants, membres et administrateurs de l’espace de travail. Lorsque plusieurs utilisateurs montent le même lecteur, ils voient tous une arborescence de fichiers identique, ce qui facilite une collaboration fluide entre équipes à distance.

## **Téléversements**

Pour les téléversements à grande échelle dépassant 1000 éléments ou 100 Go, nous recommandons d’utiliser l’application web ou l’application de bureau plutôt que de téléverser via le lecteur monté. Nous avons optimisé le téléversement via l’interface de l’application pour les fichiers volumineux. Quelle que soit la méthode de téléversement choisie, le contenu sera automatiquement visible à la fois dans l’application web et dans l’application de bureau, déclenchant nos systèmes automatiques de génération de proxy et de traitement par IA.

Les fichiers peuvent être déplacés entre les lecteurs en montant d’abord plusieurs lecteurs, puis en déplaçant les fichiers entre les lecteurs via l’explorateur de fichiers de votre ordinateur

## **Accès hors ligne**

ShadeFS offre des capacités d’accès hors ligne grâce au **marquage**. Pour accéder à des fichiers ou dossiers spécifiques avec une connexion Internet faible (ou sans connexion du tout), faites simplement un clic droit sur les fichiers/dossiers dans l’application et sélectionnez « Épingler au cache ». Cette action télécharge une copie complète du contenu sélectionné dans votre cache local, les rendant entièrement accessibles même hors ligne. Vous pouvez afficher les fichiers que vous avez épinglés via la page **Éléments épinglés** .

Voir plus sur [Épingler des fichiers hors ligne](https://academy.shade.inc/shadefs/pinning-files-offline).

## **Optimisation des performances**

Il existe plusieurs façons de maximiser les performances de ShadeFS.

* Utilisez un SSD externe pour le stockage du cache afin d’améliorer considérablement les vitesses d’accès et la réactivité globale du système
* Nous vous recommandons de configurer la taille de votre cache en fonction de votre ensemble de travail habituel afin de garantir que les fichiers fréquemment consultés restent facilement disponibles
* Bien que ShadeFS soit conçu pour fonctionner efficacement avec la bande passante disponible, essayez de maintenir une connexion Internet stable pendant que vous utilisez le montage
* Pour les utilisateurs travaillant avec du contenu haute résolution sur une bande passante limitée, nous recommandons de créer des fichiers proxy

## **Intégration à l’écosystème Shade**

Contrairement à d’autres outils de diffusion de fichiers, ShadeFS est profondément intégré à l’application web et à l’application de bureau. Lorsque vous téléversez des fichiers via un lecteur monté, ils sont automatiquement indexés dans le système Shade, ce qui les rend immédiatement visibles dans les applications web et de bureau.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.shade.inc/shade-academy/shade-academy-fr/shadefs/introduction-to-shadefs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
