🌅 Gallery app for ownCloud, which includes previews for all supported media files
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Remove old CONTRIBUTING.md file Jul 25, 2016
appinfo Prepare for 16.1.1 release Dec 10, 2018
build Various ownCloud text removals Jul 25, 2016
config Apply php-cs-fixer Jun 20, 2018
controller Apply php-cs-fixer Jun 20, 2018
css Rotation picture in gallery. (#764) Jun 11, 2018
documentation Some unit tests for the Environment class Aug 23, 2015
environment Apply php-cs-fixer Jun 20, 2018
http Apply php-cs-fixer Jun 20, 2018
img Rotation picture in gallery. (#764) Jun 11, 2018
js Replace rotaction => rotation Jul 31, 2018
l10n [tx] updated from transifex Jan 23, 2019
middleware Apply php-cs-fixer Jun 20, 2018
preview Merge branch 'master' into adjust-server-version-check Jun 21, 2018
service Add the heic and heif image mimetypes to the gallery base mimetypes. Aug 27, 2018
templates Replace rotaction => rotation Jul 31, 2018
tests Fix acceptance test make target Nov 20, 2018
utility Apply php-cs-fixer Jun 20, 2018
vendor-bin/owncloud-codestyle Do not pin coding-standard to PHP 5.6 Dec 28, 2018
.drone.yml Add lint tests and remove travis Nov 20, 2018
.gitignore Adjust gitignore and codestyle composer.json indent Nov 16, 2018
.gitmodules Publish documentation and reports on GitHub Aug 15, 2015
.php_cs.dist Use notPath regex for c3.php Nov 16, 2018
.scrutinizer.yml Max version is PHP 7 Aug 20, 2015
AUTHORS.md Change Icewind's email address Jul 25, 2016
CHANGELOG.md Set release date for 16.1.1 Dec 11, 2018
CONTRIBUTING.md Add contributing guidelines Jul 23, 2016
COPYING Newlines Jan 27, 2015
Makefile Prepare for 16.1.1 release Dec 10, 2018
README.md Adjust build status for drone Dec 13, 2018
codeception.yml Unit tests for ConfigParser Sep 7, 2015
composer.json Put bamarni/composer-bin-plugin into require-dev Nov 16, 2018
composer.lock Bump codeception/codeception from 2.5.0 to 2.5.2 Jan 1, 2019
phpdoc.xml Unit tests for ConfigParser Sep 7, 2015
phpunit.xml Add CI tests to drone Nov 16, 2018



Build Status Scrutinizer Code Quality Code Coverage PHP 7 ready

Media gallery for ownCloud 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 ownCloud 10.0. If you need the same app for older versions of ownCloud. Use Gallery+ from their respective app stores.



  • 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 straight from the slideshow or the gallery
  • Switch to Gallery from any folder in files and vice-versa
  • Ignore folders containing a ".nomedia" file
  • Browser rendering of SVG images (disabled by default)
  • Mobile support

Checkout the full changelog for more.






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 owncloud/core 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 maintainer or anybody else 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.

  'preview_max_scale_factor' => 1,
  '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 ownCloud Administration Manual

Assets pipelining

Make sure to enable "asset pipelining", so that all the Javascript and CSS resources can be mixed together. This can greatly reduce the loading time of the app.

Read about it in the ownCloud 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 https://github.com/owncloud/gallery.git

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