owncloud / owncloud/core

Preview API: expose supported file/MIME types via Capabilities endpoint

Open
#31,267 9 comments 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement technical debt
Dominant language
PHP
Stars
8.8k
Forks
2.1k
Avg merge
20h 7m
Merged PRs (30d)
41

Description

Clients targeting the Preview API at remote.php/dav/files/[user]/[file]?x=[width]&y=[height]&c=[eTag]&preview=1 have no way of telling in advance for which file types a preview can likely be expected to be available.

Ideally, a list of MIME types, for which the Preview API is likely capable of providing a preview, would be available as part of the capabilities endpoint.

Using that list, clients could then see if the MIME type of an item is in that list and only request thumbnails for those items for which this is the case.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by tracing the Capabilities endpoint and the Preview API entry point described in the issue, then identify where supported preview MIME types are defined. Done means the capabilities response exposes a list clients can compare with an item's MIME type before requesting a thumbnail; add or update coverage for that response if the existing endpoint tests are found.

Written by the indexing model from the issue text.

Assessment

Tech stack
php
Domain
api
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.