Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
51 changes: 43 additions & 8 deletions docs/user/files-and-folders/photos-and-videos.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,11 +26,11 @@ Use the viewer controls to:

## Supported image formats

The preview viewer supports HEIC, HEIF, AVIF, and SVG files in addition to common image formats.
The preview viewer supports JPEG, PNG, GIF, HEIC, HEIF, AVIF, and SVG files.

- HEIC, HEIF, and AVIF previews use a thumbnail generated by the server. If a preview cannot be generated, OpenCloud offers the file for download.
- SVG files can be opened in the preview viewer, but they are not included in the photo roll. Some unusual SVG files, such as files with embedded bitmap images, may not render.
- In end-to-end encrypted folders, the browser decodes images instead of the server. HEIC preview support therefore depends on the browser and is available in Safari. If the browser cannot decode the image, the viewer displays a message.
- In end-to-end encrypted folders, the browser decodes images instead of the server. Support for HEIC, HEIF, and AVIF previews therefore depends on the browser. For example, HEIC previews are available in Safari. If the browser cannot decode the image, the viewer displays a message.

:::note
HEIC, HEIF, and AVIF previews depend on server-side thumbnail generation and the server configuration.
Expand All @@ -42,27 +42,62 @@ For more information, see the [Thumbnail Configuration](/docs/admin/configuratio

## Motion Photos and Live Photos

### Viewing Motion Photos

OpenCloud supports Live Photos created with Apple devices and Motion Photos created with Android devices.

- A play icon identifies a Motion Photo or Live Photo in table and tile views.
- In tile view, hover over the photo to play it in a loop. Use the play icon to start or pause playback.
- When you open the photo in the preview viewer, it plays once automatically and then displays the still image.
- Select “Play Live Photo” or “Play Motion Photo” in the viewer to replay it. The control changes to “Pause Live Photo” or “Pause Motion Photo” during playback.

<!-- TODO: Add a screenshot showing the Motion Photo or Live Photo play icon in tile view and its playback control in the preview viewer. -->
<!-- TODO: Add screenshot showing a recognized Live Photo in tile view. -->

<!-- TODO: Add screenshot showing Live Photo playback controls in the preview viewer. -->

<video controls width="960" style={{ maxWidth: "100%" }} aria-label="Motion Photo playback in OpenCloud">

<source src={require("./img/photos-and-videos/motion-photo-playback.mp4").default} type="video/mp4" />
Your browser does not support embedded videos.
</video>

### Uploading Live Photos

An Apple Live Photo consists of a still image in HEIC or JPG format and a corresponding MOV video. To upload a Live Photo manually through the OpenCloud web interface:

1. Open the folder where you want to store the Live Photo.
2. Upload both the still image (`.HEIC` or `.JPG`) and the corresponding video (`.MOV`) to that folder.
3. Make sure both files have the same base filename. You can rename both files as long as their base filenames remain identical.

For example, you can keep each Live Photo in its own folder:

```text
IMG_0762/
├── IMG_0762.HEIC
└── IMG_0762.MOV
```

The surrounding folder is optional but can make Live Photos easier to organize. The two files can also be renamed together, for example:

```text
Earth.HEIC
Earth.MOV
```

When OpenCloud recognizes the files as a Live Photo, open the still image in the preview viewer to play the animation.

## Video playback

Videos open in the preview viewer and use the browser's video controls. You can play or pause the video, move through the timeline, adjust the volume, and enter full screen mode. The available controls and their appearance can vary by browser.

The toolbar below the viewer groups related actions: navigation between media files, view controls, and file actions such as adding a favorite or deleting the file when available.

<!-- TODO: Update video-screenshot.png to show the current video viewer and grouped toolbar controls. -->
<video controls width="960" style={{ maxWidth: "100%" }} aria-label="Video playback in OpenCloud">

<img src={require("./img/photos-and-videos/video-screenshot.png").default} alt="Video preview in OpenCloud" width="1920"/>
<source src={require("./img/photos-and-videos/video-playback.mp4").default} type="video/mp4" />
Your browser does not support embedded videos.
</video>

## Notes

- The experience depends on the file type and browser capabilities.
- Very large media files may still take a moment to load.
- This feature is meant for quick viewing, not for advanced media editing.
- Very large media files may take longer to load.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -6,27 +6,98 @@ description: Erfahren Sie, wie OpenCloud Fotos in der Vorschau anzeigt und Video

# Fotos und Videos

OpenCloud kann Fotos in der Vorschau anzeigen und Videos direkt in der Weboberfläche abspielen.
Dadurch können Sie Medien einfacher prüfen, ohne die Dateien zuerst herunterladen zu müssen.
OpenCloud kann Fotos, Motion Photos, Live Photos und Videos direkt in der Weboberfläche anzeigen beziehungsweise abspielen. Sie können Medien aus dem aktuellen Ordner durchsuchen, ohne jede Datei zuerst herunterzuladen.

## Fotovorschau

Öffnen Sie ein Foto in der Vorschauansicht, um durch den Photo-Roll zu blättern.
Öffnen Sie ein Foto, um es in der Vorschau anzuzeigen. Die Fotogalerie zeigt die anderen Mediendateien im Ordner an, für die eine Vorschau verfügbar ist. Wählen Sie eine Miniaturansicht aus oder verwenden Sie „Vorherige Mediendatei im Ordner anzeigen“ und „Nächste Mediendatei im Ordner anzeigen“, um zwischen den Dateien zu wechseln.

Mit den Steuerelementen der Vorschau können Sie:

- Das Bild vergrößern oder verkleinern. Sie können dazu auch `Ctrl` beziehungsweise `⌘` unter macOS gedrückt halten und das Mausrad verwenden.
- Das Bild um 90 Grad nach links oder rechts drehen.
- „Zurücksetzen“ auswählen, um die ursprüngliche Vergrößerung und Drehung wiederherzustellen.
- Die Fotogalerie ein- oder ausblenden.
- Den Vollbildmodus aufrufen oder verlassen.

<!-- TODO: photo-roll-screenshot.png aktualisieren, um die aktuelle Fotovorschau, die Fotogalerie und die gruppierten Steuerelemente zu zeigen. -->

<img src={require("./img/photos-and-videos/photo-roll-screenshot.png").default} alt="Photo-Roll-Ansicht in OpenCloud" width="1920"/>

Der Fotobetrachter unterstützt eine Navigation im Photo-Roll-Stil, sodass Sie durch eine Bilderserie blättern können, ohne die Vorschau zu verlassen.
## Unterstützte Bildformate

Die Vorschau unterstützt Dateien in den Formaten JPEG, PNG, GIF, HEIC, HEIF, AVIF und SVG.

- Für die Vorschau von HEIC-, HEIF- und AVIF-Dateien wird eine vom Server erzeugte Miniaturansicht verwendet. Wenn keine Vorschau erzeugt werden kann, bietet OpenCloud die Datei zum Herunterladen an.
- SVG-Dateien können in der Vorschau geöffnet werden, sind jedoch nicht in der Fotogalerie enthalten. Einige ungewöhnliche SVG-Dateien, beispielsweise Dateien mit eingebetteten Bitmap-Bildern, werden möglicherweise nicht dargestellt.
- In Ende-zu-Ende-verschlüsselten Ordnern dekodiert der Browser die Bilder anstelle des Servers. Die Unterstützung für die Vorschau von HEIC-, HEIF- und AVIF-Dateien hängt daher vom Browser ab. HEIC-Vorschauen sind beispielsweise in Safari verfügbar. Wenn der Browser das Bild nicht dekodieren kann, zeigt die Vorschau eine Meldung an.

:::note
Die Vorschau von HEIC-, HEIF- und AVIF-Dateien hängt von der serverseitigen Erzeugung von Miniaturansichten und der Serverkonfiguration ab.
:::

<!--
Weitere Informationen finden Sie in der Dokumentation zur [Konfiguration von Miniaturansichten](/docs/admin/configuration/thumbnail-configuration).
-->

## Motion Photos und Live Photos

### Motion Photos anzeigen

OpenCloud unterstützt Live Photos, die mit Apple-Geräten erstellt wurden, und Motion Photos von Android-Geräten.

- Ein Wiedergabesymbol kennzeichnet Motion Photos und Live Photos in der Tabellen- und Kachelansicht.
- Bewegen Sie den Mauszeiger in der Kachelansicht über das Foto, um es in einer Schleife abzuspielen. Verwenden Sie das Wiedergabesymbol, um die Wiedergabe zu starten oder anzuhalten.
- Wenn Sie das Foto in der Vorschau öffnen, wird es einmal automatisch abgespielt. Anschließend wird das Standbild angezeigt.
- Wählen Sie in der Vorschau „Live Photo abspielen“ oder „Bewegungsaufnahme abspielen“ aus, um es erneut abzuspielen. Während der Wiedergabe ändert sich das Steuerelement in „Live Photo pausieren“ beziehungsweise „Bewegungsaufnahme pausieren“.

<!-- TODO: Screenshot einer erkannten Live Photo in der Kachelansicht hinzufügen. -->

<!-- TODO: Screenshot der Steuerelemente für die Wiedergabe einer Live Photo in der Vorschau hinzufügen. -->

<video controls width="960" style={{ maxWidth: "100%" }} aria-label="Wiedergabe einer Motion Photo in OpenCloud">

<source src={require("./img/photos-and-videos/motion-photo-playback.mp4").default} type="video/mp4" />
Ihr Browser unterstützt keine eingebetteten Videos.
</video>

### Live Photos hochladen

Eine Apple Live Photo besteht aus einem Standbild im HEIC- oder JPG-Format und einem dazugehörigen MOV-Video. So laden Sie eine Live Photo manuell über die OpenCloud-Weboberfläche hoch:

1. Öffnen Sie den Ordner, in dem Sie die Live Photo speichern möchten.
2. Laden Sie sowohl das Standbild (`.HEIC` oder `.JPG`) als auch das dazugehörige Video (`.MOV`) in diesen Ordner hoch.
3. Stellen Sie sicher, dass beide Dateien denselben Basisdateinamen haben. Sie können beide Dateien umbenennen, solange die Basisdateinamen identisch bleiben.

Sie können beispielsweise jede Live Photo in einem eigenen Ordner ablegen:

```text
IMG_0762/
├── IMG_0762.HEIC
└── IMG_0762.MOV
```

Der umgebende Ordner ist optional, kann die Organisation von Live Photos jedoch vereinfachen. Die beiden Dateien können auch gemeinsam umbenannt werden, zum Beispiel:

```text
Earth.HEIC
Earth.MOV
```

Wenn OpenCloud die Dateien als Live Photo erkennt, öffnen Sie das Standbild in der Vorschau, um die Animation abzuspielen.

## Videowiedergabe

Videos öffnen sich im gleichen Vorschaubereich und können direkt im Browser abgespielt werden.
Videos werden in der Vorschau geöffnet und verwenden die Videosteuerung des Browsers. Sie können das Video abspielen oder anhalten, durch die Zeitleiste navigieren, die Lautstärke anpassen und den Vollbildmodus aufrufen. Die verfügbaren Steuerelemente und deren Darstellung können je nach Browser variieren.

Die Symbolleiste unterhalb der Vorschau gruppiert zusammengehörige Aktionen: die Navigation zwischen Mediendateien, Steuerelemente für die Ansicht und Dateiaktionen wie das Hinzufügen zu den Favoriten oder das Löschen der Datei, sofern verfügbar.

<img src={require("./img/photos-and-videos/video-screenshot.png").default} alt="Videovorschau in OpenCloud" width="1920"/>
<video controls width="960" style={{ maxWidth: "100%" }} aria-label="Videowiedergabe in OpenCloud">

Die Videowiedergabe funktioniert direkt in OpenCloud, sodass Sie Clips prüfen können, ohne sie zuerst herunterzuladen.
<source src={require("./img/photos-and-videos/video-playback.mp4").default} type="video/mp4" />
Ihr Browser unterstützt keine eingebetteten Videos.
</video>

## Hinweise

- Das Verhalten hängt vom Dateityp und von den Browserfunktionen ab.
- Sehr große Mediendateien können trotzdem einen Moment zum Laden benötigen.
- Diese Funktion ist für die schnelle Ansicht gedacht, nicht für eine erweiterte Medienbearbeitung.
- Das Laden sehr großer Mediendateien kann länger dauern.
Loading