Skip to main content
Version: 2.8.0

Try it with the demo servers

You can try every Immich and Nextcloud source without running your own server. Public demo servers hold a small library of photos, and the examples in these docs and the plugin's showcase notes (Create showcase notes command) point at them.

Read-only, for trying the plugin only

The demo servers are read-only: the credentials below can view photos but cannot change anything. They are run by the plugin's author, so your requests (and your IP address) reach that server. Don't rely on them for anything beyond trying the plugin; they may change or go away.

Sample photos for the use-case notes

The dialog shown by Create showcase notes and Create use-case notes also offers to download 39 sample photos (about 10 MB) for the use-case notes. They come from docs.mkshp.dev, the host of these docs, not from the demo servers. The download happens once, only if you leave Download sample photos on, and the photos are then saved in your vault.

Share links need no connection. Paste any of these into a gallery block:

SourceURLPassword
immich-share (Landscapes album)https://demo-immich.mkshp.dev/share/7XBAej6IyThZOS7izb78XcEJX7QhYwQBmxtHxaBz7TaaqiP5pxWyZQrN6TIvUGRhI9g—
immich-share (Travel album)https://demo-immich.mkshp.dev/share/RAHL6jLQTkqIDaSYjdlHdcbJ4W25u002dyorCdqYVDmoar8xyB7wiE8GARi4QH2eqWwgallery-demo
nextcloud-share (folder)https://demo-nextcloud.mkshp.dev/s/DAxM47SmHesMTqa—
nextcloud-share (folder)https://demo-nextcloud.mkshp.dev/s/ZSBpcMLfaQPCi2Ygallery-demo
nextcloud-share (Photos app album)https://demo-nextcloud.mkshp.dev/apps/photos/public/wD9fLmI1TP6KEq76Yvs9fZrBdfDu8gfc—
```obs-gallery
sources:
  - type: immich-share
    url: https://demo-immich.mkshp.dev/share/7XBAej6IyThZOS7izb78XcEJX7QhYwQBmxtHxaBz7TaaqiP5pxWyZQrN6TIvUGRhI9g
view:
  type: justified
```

Connections (for immich and nextcloud sources)​

The quickest way to get them: run the Create showcase notes command and choose Add connections. The plugin adds both connections to your settings (it never changes an existing connection with the same key) and writes example notes that use them.

To add them by hand instead, use Settings → Gallery View → Providers (see Settings). Use exactly these keys, because the docs examples and showcase notes refer to them. Remove the connections there when you are done trying the plugin.

Immich​

FieldValue
Keyimmich-demo
Server URLhttps://demo-immich.mkshp.dev
API keyY8jMqmnnv5ME9wJl78U1D4cIgSGcigtMemcgWMxxE

What's on the server: 82 assets (75 photos, 7 videos) dated between March 2008 and October 2026, 10 of them favorites. 20 of the photos are an Iceland road trip dated 24–30 August 2026, used by the use-case note Family album (Immich).

KindValues
AlbumsLandscapes 0fe76d50-18b3-4f74-8f7c-3ede043982de (9) · City 0a33a817-9389-45f5-a99d-6ac12f56dc7f (6, one video) · Travel 882fef37-436a-49c1-af1a-e444d0216ee0 (7, one video) · People 9a714fd1-36f8-4b3a-ba48-2f3101895dee (25) · Videos 19d45220-6775-457e-b351-50cbc43375ec (5 videos: MP4, MOV, WebM and a 9:16 portrait clip)
TagsPhotography (30) · Nature (9) · Architecture (5) · Portraits (25) · Iceland (20)
PeopleAlice · Bob · Carol · Dave (7 photos each)

Nextcloud​

FieldValue
Keynextcloud-demo
Server URLhttps://demo-nextcloud.mkshp.dev
Usernamedemo
App passwordpsMXy2P4j2YZSjJuALSukdyzkjhIBAAqgUkQVFavPQPyRqkZfrkAXZhIknna8IIpLHsVgr8M

What's on the server: 40 images (JPEG, PNG and WebP, 14 KB to 2.5 MB) in /Gallery-Demo/Landscapes, /Gallery-Demo/City and /Gallery-Demo/Camera, and 5 videos (MP4, MOV, WebM and a 9:16 portrait clip, 0.5 to 11 MB) in /Gallery-Demo/Videos. The folder share link includes the videos too, under /Videos. Camera uses phone-style names (IMG_2024…, IMG_2025…) for trying filenameFilter, and modified dates range from 2024 to 2026 for trying modifiedAfter / modifiedBefore.

```obs-gallery
sources:
  - type: nextcloud
    connection: nextcloud-demo
    path: /Gallery-Demo/Camera
    filenameFilter: "IMG_2024*"
view:
  type: masonry
```

Photo credits​

Every photo and video on the demo servers is free to use. Thanks to the photographers and film-makers below.

  • CC0 1.0 (deed): 51 photos from StockSnap and 2 videos from Wikimedia Commons. The videos were converted to MP4 without audio, and some Nextcloud copies were resized or converted to PNG/WebP.
  • CC BY 3.0 (deed): 5 video clips from the Blender Foundation open movies Sintel and Big Buck Bunny (© Blender Foundation, blender.org), on both demo servers. They are trailers and short excerpts, some re-encoded (WebM, MOV) or cropped to 9:16 for the format examples.
  • Unsplash License: 44 photos from Unsplash, served by Lorem Picsum, and 20 Iceland photos on the Immich demo, downloaded from Unsplash. The Iceland photos' dates and captions were set for the demo's made-up road trip; they are not when each photo was taken, and the horse close-up is cropped to a square. The IMG_… names in the Nextcloud Camera folder are made up for the filenameFilter examples; the dates in them are not when the photos were taken.

The names Alice, Bob, Carol and Dave in the Immich demo are invented labels for the face-recognition examples, not the names of the people photographed.

Immich demo (82 assets)
FileAuthorSourceLicence
picsum-30.jpgShyamanta BaruahUnsplashUnsplash License
picsum-31.jpgHow-Soon NguUnsplashUnsplash License
picsum-32.jpgRodrigo MeloUnsplashUnsplash License
picsum-33.jpgAlejandro EscamillaUnsplashUnsplash License
picsum-34.jpgAleks DorohovichUnsplashUnsplash License
picsum-35.jpgShane ColellaUnsplashUnsplash License
picsum-36.jpgVadim SherbakovUnsplashUnsplash License
picsum-37.jpgAustin NeillUnsplashUnsplash License
picsum-38.jpgAllyson SouzaUnsplashUnsplash License
picsum-39.jpgLuke ChesserUnsplashUnsplash License
picsum-40.jpgRyan McguireUnsplashUnsplash License
picsum-41.jpgNithya RamanujamUnsplashUnsplash License
picsum-42.jpgLuke ChesserUnsplashUnsplash License
picsum-43.jpgOleg ChursinUnsplashUnsplash License
picsum-44.jpgChristopher SardegnaUnsplashUnsplash License
picsum-45.jpgAlan HavertyUnsplashUnsplash License
picsum-46.jpgJeffrey KamUnsplashUnsplash License
picsum-47.jpgChristopher SardegnaUnsplashUnsplash License
picsum-48.jpgLuke ChesserUnsplashUnsplash License
picsum-49.jpgMargaret BarleyUnsplashUnsplash License
picsum-50.jpgTyler WanlassUnsplashUnsplash License
picsum-51.jpgIreneuiliaUnsplashUnsplash License
picsum-52.jpgCierraUnsplashUnsplash License
picsum-53.jpgJ DuclosUnsplashUnsplash License
picsum-54.jpgNicholas SwansonUnsplashUnsplash License
picsum-55.jpgTyler WanlassUnsplashUnsplash License
picsum-56.jpgSebastian MullerUnsplashUnsplash License
picsum-57.jpgNicholas SwansonUnsplashUnsplash License
picsum-58.jpgTony NaccaratoUnsplashUnsplash License
picsum-59.jpgArt WaveUnsplashUnsplash License
stocksnap-01.jpgDirect MediaStockSnapCC0 1.0
stocksnap-02.jpgDirect MediaStockSnapCC0 1.0
stocksnap-03.jpgDirect MediaStockSnapCC0 1.0
stocksnap-04.jpgDirect MediaStockSnapCC0 1.0
stocksnap-05.jpgDirect MediaStockSnapCC0 1.0
stocksnap-06.jpgDirect MediaStockSnapCC0 1.0
stocksnap-07.jpgDirect MediaStockSnapCC0 1.0
stocksnap-08.jpgMike MoloneyStockSnapCC0 1.0
stocksnap-09.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-10.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-11.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-12.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-13.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-14.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-15.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-16.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-17.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-18.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-19.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-20.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-21.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-22.jpgDirect MediaStockSnapCC0 1.0
stocksnap-23.jpgDirect MediaStockSnapCC0 1.0
stocksnap-24.jpgDirect MediaStockSnapCC0 1.0
stocksnap-25.jpgDirect MediaStockSnapCC0 1.0
ocean-sommaroy.mp4Netha HussainWikimedia CommonsCC0 1.0
city-timelapse-albury.mp4ThennickeWikimedia CommonsCC0 1.0
sintel-trailer.mp4Blender FoundationSintel (blender.org)CC BY 3.0
sintel-portrait-9x16.mp4Blender FoundationSintel (blender.org)CC BY 3.0
big-buck-bunny-trailer.movBlender FoundationBig Buck Bunny (blender.org)CC BY 3.0
big-buck-bunny-clip-vp9.webmBlender FoundationBig Buck Bunny (blender.org)CC BY 3.0
big-buck-bunny-short-6s.mp4Blender FoundationBig Buck Bunny (blender.org)CC BY 3.0
Aurora over Kirkjufell.jpgLandon ArnoldUnsplashUnsplash License
Black sand at Reynisfjara.jpgWith PaulUnsplashUnsplash License
Canyon of Fjaðrárgljúfur.jpgThomas FatinUnsplashUnsplash License
Church above Vík.jpgJon FlobrantUnsplashUnsplash License
Diamond Beach ice.jpgAndy MaiUnsplashUnsplash License
Drifting icebergs at Jökulsárlón.jpgJeremy BishopUnsplashUnsplash License
Face to face with an Icelandic horse.jpgkyler trautnerUnsplashUnsplash License
Glacier view at Jökulsárlón.jpgDenys NevozhaiUnsplashUnsplash License
Hallgrímskirkja against a blue sky.jpgToby ElliottUnsplashUnsplash License
Icebergs in a glacier lagoon.jpgGian-Reto TarnutzerUnsplashUnsplash License
Northern lights at Kirkjufell.jpgJoshua EarleUnsplashUnsplash License
Puffin on a rock.jpgRay HennessyUnsplashUnsplash License
Skógafoss from above.jpgAdrian FiodorUnsplashUnsplash License
Skógafoss up close.jpgKarsten WinegeartUnsplashUnsplash License
Svartifoss and its basalt columns.jpgBailey GalindoUnsplashUnsplash License
The Blue Lagoon.jpgF DUnsplashUnsplash License
Vestrahorn above the Stokksnes dunes.jpgWanderlust in FrameUnsplashUnsplash License
Behind Seljalandsfoss.jpgjossemioUnsplashUnsplash License
Road through the lava fields.jpgTom PodmoreUnsplashUnsplash License
Svínafellsjökull glacier panorama.jpgJoseph CorlUnsplashUnsplash License
Nextcloud demo, /Gallery-Demo (45 files)
FileAuthorSourceLicence
Landscapes/mountain-mountains-landscape-1.jpgMatt FloresStockSnapCC0 1.0
Landscapes/mountain-mountain-landscape-2.webpKristoffer FredrikssonStockSnapCC0 1.0
Landscapes/mountain-mountain-landscape-3.jpgRobert LukemanStockSnapCC0 1.0
Landscapes/mountain-mountain-landscape-4.pngJohannes PlenioStockSnapCC0 1.0
Landscapes/lake-lake-landscape-1.jpgTricia GrayStockSnapCC0 1.0
Landscapes/lake-lake-landscape-2.webpSergei GussevStockSnapCC0 1.0
Landscapes/lake-lake-landscape-3.jpgJoe deSousaStockSnapCC0 1.0
Landscapes/lake-lake-landscape-4.pngTricia GrayStockSnapCC0 1.0
Landscapes/forest-enchanting-forest-1.jpgJohannes PlenioStockSnapCC0 1.0
Landscapes/forest-dock-lake-2.webpTj HolowaychukStockSnapCC0 1.0
Landscapes/forest-girl-woman-3.jpgCaleb FrithStockSnapCC0 1.0
Landscapes/beach-beach-sunset-1.jpgKen CooperStockSnapCC0 1.0
Landscapes/beach-beach-sunset-2.webpFré SonneveldStockSnapCC0 1.0
Landscapes/beach-beach-sunset-3.jpgKristin HardwickStockSnapCC0 1.0
City/skyline-city-skyline-1.jpgJoe deSousaStockSnapCC0 1.0
City/skyline-city-skyline-2.webpMatt BangoStockSnapCC0 1.0
City/skyline-city-skyline-3.jpgMatt BangoStockSnapCC0 1.0
City/skyline-city-skyline-4.pngMatt BangoStockSnapCC0 1.0
City/skyline-city-skyline-5.jpgBurstStockSnapCC0 1.0
City/skyline-city-skyline-6.jpgMike MoloneyStockSnapCC0 1.0
City/street-city-street-1.jpgZachary StainesStockSnapCC0 1.0
City/street-city-streets-2.webpJeffrey BettsStockSnapCC0 1.0
City/street-city-streets-3.jpgJeffrey BettsStockSnapCC0 1.0
City/street-city-street-4.pngLerone PietersStockSnapCC0 1.0
City/street-city-streets-5.jpgKevin LeeStockSnapCC0 1.0
City/street-city-streets-6.jpgMarkus SpiskeStockSnapCC0 1.0
Camera/IMG_20240103_222.jpgArvee MarieUnsplashUnsplash License
Camera/IMG_20240306_037.jpgTina RatajUnsplashUnsplash License
Camera/IMG_20240308_259.jpgLukas SchweizerUnsplashUnsplash License
Camera/IMG_20240511_074.jpgChristian BardenhorstUnsplashUnsplash License
Camera/IMG_20240716_111.jpgBen MooreUnsplashUnsplash License
Camera/IMG_20240921_148.pngIlham RahmansyahUnsplashUnsplash License
Camera/IMG_20241126_185.jpgDyaa EldinUnsplashUnsplash License
Camera/IMG_20250105_444.pngZugrUnsplashUnsplash License
Camera/IMG_20250310_481.jpgZugrUnsplashUnsplash License
Camera/IMG_20250513_296.pngFlorian KlauerUnsplashUnsplash License
Camera/IMG_20250515_518.jpgBrian GonzalezUnsplashUnsplash License
Camera/IMG_20250718_333.jpgZwaddiUnsplashUnsplash License
Camera/IMG_20250923_370.jpgKenneth ThewissenUnsplashUnsplash License
Camera/IMG_20251128_407.jpgGabe RodriguezUnsplashUnsplash License
Videos/sintel-trailer.mp4Blender FoundationSintel (blender.org)CC BY 3.0
Videos/sintel-portrait-9x16.mp4Blender FoundationSintel (blender.org)CC BY 3.0
Videos/big-buck-bunny-trailer.movBlender FoundationBig Buck Bunny (blender.org)CC BY 3.0
Videos/big-buck-bunny-clip-vp9.webmBlender FoundationBig Buck Bunny (blender.org)CC BY 3.0
Videos/big-buck-bunny-short-6s.mp4Blender FoundationBig Buck Bunny (blender.org)CC BY 3.0