You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Nextcloud bot 4644e8071c
[tx-robot] updated from transifex
2 weeks ago
.github Create stale.yml 11 months ago
.tx Fix tx config 2 years ago
appinfo Update version on master 11 months ago
build Use Codecov exclusively for coverage 3 years ago
css Fix gallery sorting buttons and remove filelist ref # #16076 1 year ago
documentation Use Codecov exclusively for coverage 3 years ago
img Update templates with new .icon-white and .icon-shadow classes; move toggle.svg to core, remove deprecated icons 2 years ago
js Force close all tooltips when closing sharing menu 10 months ago
l10n [tx-robot] updated from transifex 2 weeks ago
lib Don't load shares of files drop 9 months ago
templates Fix gallery sorting buttons and remove filelist ref # #16076 1 year ago
tests Fix PageControllerTest 2 years ago
vendor Update Composer 3 years ago
.gitmodules This is the Nextcloud Gallery app 3 years ago
.scrutinizer.yml Minor config changes 3 years ago
.travis.yml Update master php testing versions 1 year ago Change Icewind's email address 3 years ago Update readme to include Nextcloud 3 years ago Add contributing guidelines 3 years ago
COPYING Newlines 5 years ago
Makefile Move to compiled handlebars 1 year ago Update 6 months ago
codeception.yml Migrate PHP to PSR-4 3 years ago
composer.json Require PHPUnit 6.5 2 years ago
composer.lock Update composer.lock for PHPUnit 6.5 and Codeception 2.3.8 2 years ago
phpdoc.xml Unit tests for ConfigParser 4 years ago

💀Gallery was replaced by 📸 Photos

💀The gallery app has been replaced by the beautiful new app:
:camera_flash: Nextcloud Photos - Your memories under your control

Before reporting an issue or opening a pull request, please checkout the new app and see if your request still needs to be handled there. In case it is, open your PR against the photos app.

Media gallery for Nextcloud which includes previews for all media types supported by your installation.

Provides a dedicated view of all images in a grid, adds image viewing capabilities to the files app and adds a gallery view to public links.

This version is for Nextcloud 14.



  • Support for large selection of media types (depending on server setup)
  • Upload and organise images and albums straight from the app
  • Large, zoomable previews which can be shown in fullscreen mode
  • Sort images by name or date added
  • Per album design, description and copyright statement
  • A la carte features (external shares, browser svg rendering, etc.)
  • Image download and sharing straight from the slideshow or the gallery
  • Switch to Gallery from any folder in files and vice-versa
  • Ignore folders containing a “.nomedia” or “.noimage” file
  • Browser rendering of SVG images (disabled by default)
  • Mobile support

Checkout the full changelog for more.





All the people who have provided patches to:


See this wiki article about the requirements for Gallery.

Supporting the development

There are many ways in which you can help make Gallery a better product

  • Report bugs (see below)
  • Provide patches for nextcloud/server or the app itself
  • Help test new features by checking out new branches on Github
  • Design interface components for new features
  • Develop new features. Please consult with the maintainers before starting your journey
  • Fund a feature, either via BountySource or by directly hiring a community member who is capable of developing and maintaining it

Bug reporting and contributing

Everything you need to know about bug reporting and contributing is located here.


Here is a list of steps you might want to take before using the app

Supporting more media types

First, make sure you have installed ImageMagick and its imagick PECL extension.
Next add a few new entries to your config/config.php configuration file.

  'enabledPreviewProviders' =>
  array (
    0 => 'OC\\Preview\\PNG',
    1 => 'OC\\Preview\\JPEG',
    2 => 'OC\\Preview\\GIF',
    11 => 'OC\\Preview\\Illustrator',
    12 => 'OC\\Preview\\Postscript',
    13 => 'OC\\Preview\\Photoshop',
    14 => 'OC\\Preview\\TIFF'

Look at the sample configuration (config.sample.php) in your config folder if you need more information about how the config file works.
That’s it. You should be able to see more media types in your slideshows and galleries as soon as you’ve installed the app.

Improving performance

Redis for files locking

Using Redis for files locking improves performance by a factor of 10 when loading an album.

Read about it in the Nextcloud Administration Manual


Installing from the app store

  • As an admin, select “Apps” in the menu
  • Go to the “disabled apps” section
  • Enable Gallery

Installing from archive

  • Go to the the releases page
  • Download the latest release/archive to your server’s apps/ directory
  • Unpack the app
  • IMPORTANT: Make sure the folder name is gallery

Installing from Git

In your terminal go into the apps/ directory and then run the following command:

$ git clone

Now you can activate it in the apps menu. It’s called Gallery

To update the app go inside you apps/gallery/* directory and type:

$ git pull --rebase

List of patches

None so far