Nextcloud Shared Links

You can display images from a public Nextcloud folder share or Photos app album directly in Gallery View without requiring any Nextcloud account or connection configuration.

The nextcloud-share source type is entirely separate from the authenticated nextcloud source type. It works using public share URLs created on a Nextcloud server.

---

The nextcloud-share Source Schema

sources:
  - type: nextcloud-share
    url: https://cloud.example.com/s/TOKEN
    password: "optional-share-password"
    recursive: true
    filenameFilter: "IMG_*"
    filters:
      mimeTypes:
        - image/jpeg
        - image/png
      minSizeKb: 10
      maxSizeKb: 5000
    sort:
      by: name          # name | size | lastModified
      order: asc        # asc | desc
    limit: 20
view:
  type: grid

Field	Type	Required	Description
type	string	Yes	Must be nextcloud-share.
url	string	Yes	Public share URL from Nextcloud (standard /s/TOKEN or Photos app /apps/photos/public/TOKEN).
password	string	No	Password if the Nextcloud public share link is password-protected.
recursive	boolean	No	When true, scans subdirectories inside the share. Defaults to true.
filenameFilter	string	No	Glob pattern for filename matching (e.g. IMG_*, *.png).
filters.mimeTypes	list of strings	No	Filter files by MIME types.
filters.minSizeKb	number	No	Minimum file size in kilobytes.
filters.maxSizeKb	number	No	Maximum file size in kilobytes.
sort.by	name, size, or lastModified	No	Field to sort files by.
sort.order	asc or desc	No	Sort order (asc or desc).
limit	number	No	Maximum number of images to display.

---

Supported URL Formats

Gallery View automatically parses and resolves several Nextcloud public share URL formats:

• Standard Files Public Link: https://cloud.example.com/s/TOKEN or https://cloud.example.com/index.php/s/TOKEN
• Files App Share Link: https://cloud.example.com/apps/files/s/TOKEN
• Photos App Public Album Link: https://cloud.example.com/apps/photos/public/TOKEN

---

Examples

1. Standard Public Share Link

sources:
  - type: nextcloud-share
    url: https://use23.thegood.cloud/s/abc123456789
view:
  type: grid

2. Password-Protected Share Link

sources:
  - type: nextcloud-share
    url: https://use23.thegood.cloud/s/xyz987654321
    password: "secret-share-password"
view:
  type: thumbnail

3. Nextcloud Photos App Public Album

sources:
  - type: nextcloud-share
    url: https://use23.thegood.cloud/apps/photos/public/albumToken123
view:
  type: carousel

---

Troubleshooting

• Invalid Nextcloud Share URL: Ensure the URL is a valid public share link copied from Nextcloud.
• Authentication Failed / Password Protected: If the share link requires a password, make sure to specify the password property in your YAML block.
• Share Not Found or Expired: The share link may have expired or been deleted by the owner on Nextcloud.