> For the complete documentation index, see [llms.txt](https://docs.splexit.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.splexit.de/user-guide-companion-app/file-browser.md).

# File-Browser

Der File Browser ist die integrierte Medienbibliothek in Splexit. Hier lädst du Dateien hoch, durchsuchst deine Medien, siehst Vorschauen und weist Dateien deinen Mediaslides und Projekten zu. Splexit nutzt keine proprietären Formate — du hast jederzeit vollen Zugriff auf deine Dateien.

### Aufbau

Der File Browser besteht aus drei Bereichen:

| Bereich            | Beschreibung                                                                                                                          |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Dateiliste**     | Alle hochgeladenen Mediendateien in deinem Account                                                                                    |
| **Filter**         | Filterung nach Medientyp — zeigt nur die Dateien an, die zum gewählten Typ passen                                                     |
| **Vorschau-Panel** | Zeigt Bilder, Videos und 3D-Modelle direkt an. Hier siehst du auch Dateidetails, kannst den Namen ändern und die Datei herunterladen. |

### Filter und Medientypen

Der Filter ist ein zentrales Element des File Browsers. Jede Datei in Splexit ist einem **Medientyp** zugeordnet — und der Medientyp bestimmt, wo die Datei eingesetzt werden kann.

{% hint style="warning" %}
\
**Medientyp ≠ Dateityp**\
Medientypen beschreiben die Funktion einer Datei in Splexit (z. B. „3D-Modell" oder „Bild"). Dateitypen sind die technischen Formate (z. B. `.glb` oder `.png`). Beim Hochladen musst du darauf achten, dass der richtige Medientyp ausgewählt ist.<br>
{% endhint %}

#### Kontextabhängiges Öffnen

Wenn du den File Browser aus einem [Mediaslide](/user-guide-companion-app/editor/media-slide-einstellungen.md) oder [Splex-Element ](/user-guide-companion-app/editor/splex-einstellungen.md)heraus öffnest, wird er automatisch im Kontext des ausgewählten Medientyps geöffnet. Das heißt: Du siehst nur Dateien, die zum jeweiligen Typ passen. Das erleichtert die Suche und verhindert Fehlkonfigurationen — du kannst einem 3D-Modell-Slot kein Bild zuweisen.

#### Unterstützte Formate

| Medientyp             | Dateiformate                     | Hinweis                                                                                              |
| --------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------- |
| **3D-Modell**         | `.glb`                           | `.obj` in Vorbereitung                                                                               |
| **3D-Szene (Unity)**  | `.zip` (Asset Bundle)            | Für vollständige Unity-Szenen als Splex-Element                                                      |
| **Bild**              | `.jpg`, `.png`, `.webp`          | —                                                                                                    |
| **Video**             | `.mp4`, `.mov`                   | —                                                                                                    |
| **360°-Panorama**     | `.jpg`, `.png` (equirectangular) | Mono (2:1) und Stereo (Top-Left-Right-Bottom, 1:1) Es wird empfohlen mind. 4K Auflösung zu verwenden |
| **360°-Film**         | `.mp4` (equirectangular)         | Mono und Stereo (Top-Left-Right-Bottom)                                                              |
| **Audio**             | `.mp3`, `.wav`                   | `.m4a` und `.ogg` mit eingeschränkter Unterstützung                                                  |
| **Skript / Dokument** | `.pdf`                           | Inhaltsbeschreibungen, didaktische Ausarbeitungen, Rechte                                            |

### Vorschau-Panel

Wenn du eine Datei in der Liste auswählst, öffnet sich das Vorschau-Panel. Hier kannst du:

* **Bilder** und **Videos** direkt ansehen
* **3D-Modelle** drehen und inspizieren
* **Dateidetails** einsehen (Größe, Format, Upload-Datum)
* Den **Dateinamen** ändern
* Die Datei **herunterladen** — direkt auf dein Gerät
* Die Datei **löschen**

### Dateien hochladen

1. Öffne den File Browser (über das Dashboard oder aus einem Mediaslide heraus).
2. Stelle sicher, dass der richtige **Medientyp** im Filter ausgewählt ist.
3. Klicke auf **Upload**.
4. Die Datei erscheint in der Liste und steht in allen Projekten zur Verfügung.

#### Upload-Größenbegrenzungen

| Medientyp                    | Maximale Dateigröße |
| ---------------------------- | ------------------- |
| **Video** (MP4, MOV)         | 500 MB              |
| **3D-Modell** (GLB)          | 250 MB              |
| **3D-Szene** (ZIP / Unity)   | 250 MB              |
| **Audio** (MP3, WAV)         | 100 MB              |
| **Bilder / PDF / Sonstiges** | 50 MB               |

Dateien, die das Limit überschreiten, können nicht hochgeladen werden.

{% hint style="warning" %}
\
**Große Dateien: App reagiert verzögert**\
Bei großen Dateien (z. B. 3D-Modelle über 50 MB) kann es vorkommen, dass die App nach der Dateiauswahl scheinbar nicht reagiert. Die Datei wird im Hintergrund verarbeitet — einfach abwarten, nicht abbrechen.<br>
{% endhint %}

{% hint style="info" %}
\
**Empfohlene Dateigrößen für die Praxis**\
Die Maximalgrenzen sind technische Limits. Für einen flüssigen Workflow empfehlen wir deutlich kleinere Dateien: 3D-Modelle idealerweise unter 30 MB, Videos unter 100 MB. Große Dateien verlängern sowohl den Upload als auch den Download auf die Endgeräte erheblich.<br>
{% endhint %}

#### Upload auf iOS und Android

Android und iOS schränken den Dateizugriff für Apps ein. Die Splexit-App kann nicht auf das gesamte Dateisystem deines Geräts zugreifen — nur auf bestimmte zugängliche Ordner.

**Auf iOS** ist das besonders relevant: Wenn du eine Datei hochladen möchtest, die sich nicht im zugänglichen Bereich befindet, musst du sie vorher in den Public Ordner verschieben. So geht's:

1. Öffne die iOS-**Dateien**-App.
2. Navigiere zu **Auf meinem iPhone** (oder iPad) → **Splexit**.
3. Verschiebe oder kopiere die gewünschte Datei dorthin.
4. Öffne den File Browser in der Splexit-App — die Datei ist jetzt auswählbar.

**Auf Android** ist der Zugriff weniger eingeschränkt — du kannst in der Regel direkt aus dem Download-Ordner oder der Dateien-App auswählen.

### Sicherheit und Dateizugriff

Deine Dateien sind über deinen Splexit-Account geschützt. Du kannst sie nur mit deinem Login herunterladen — ein Zugriff von außerhalb der Anwendung ist ohne Anmeldung nicht möglich.

#### Dateien in der Präsentation

Für Präsentationen gilt eine Besonderheit: Teilnehmende können über die Funktion „Beitreten als Gast" an einer Präsentation teilnehmen — ohne eigenen Account. Damit sie die Inhalte auf ihren Endgeräten sehen können, erstellt die Companion App kurzfristig **signierte Download-URLs**. Diese werden ausschließlich vom Presenter-Gerät (deinem Host) generiert und die Downloads werden nur von dir ausgelöst.

{% hint style="warning" %}
\
**Dateien auf Endgeräten sind aktuell nicht verschlüsselt**\
Nach dem Download liegen die Dateien offen auf den Teilnehmer-Geräten. Jede Person mit Zugriff auf das Gerät kann die Dateien einsehen. Die Verschlüsselung der lokalen Dateien ist für eine zukünftige Version geplant. Berücksichtige das bei sensiblen oder urheberrechtlich geschützten Inhalten, die nicht weiterverbreitet werden dürfen.<br>
{% endhint %}

### Dateien löschen

Du kannst Dateien im File Browser über das Vorschau-Panel löschen. Dabei gilt eine wichtige Einschränkung:

{% hint style="danger" %}
\
**Referenzen werden nicht automatisch entfernt**\
Wenn du eine Datei löschst, die noch in einem Projekt verwendet wird, bleiben die Verweise in den betroffenen Mediaslides oder Splex-Elementen bestehen — die Datei selbst ist aber nicht mehr vorhanden. Das führt zu inkonsistenten Projekten: Mediaslides verweisen auf eine Datei, die es nicht mehr gibt.<br>
{% endhint %}

Bevor du eine Datei löschst, stelle sicher, dass sie in keinem Projekt mehr in Verwendung ist. Falls doch, lösche oder bearbeite zuerst die entsprechenden Mediaslides oder Splex-Elemente, die auf diese Datei verweisen — und entferne danach erst die Datei selbst.


---

# 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:

```
GET https://docs.splexit.de/user-guide-companion-app/file-browser.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.