1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
# Gallery
[](https://travis-ci.org/owncloud/gallery)
[](https://scrutinizer-ci.com/g/owncloud/gallery/?branch=master)
[](https://scrutinizer-ci.com/g/owncloud/gallery/?branch=master)
Media gallery for ownCloud which includes previews for all media types supported by your ownCloud 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 8.2. If you need the same app for older versions of ownCloud. Use Gallery+ from the app store.**
## Featuring
* Support for large selection of media types (depending on ownCloud setup)
* Large, zoomable previews which can be shown in fullscreen mode
* Sort images by name or date added
* Per album description and copyright statement
* A la carte features (external shares, native svg, etc.)
* Image download straight from the slideshow or the gallery
* Seamlessly jump between the gallery and the files view
* Ignore folders containing a ".nomedia" file
* Native SVG support (disabled by default)
* Mobile support
Checkout the [full changelog](CHANGELOG.md) for more.
## Maintainers
### Current
* [Olivier Paroz](https://github.com/oparoz)
* [Jan-Christoph Borchardt](https://github.com/jancborchardt) (Design)
### Alumni
* [Robin Appelman](https://github.com/icewind1991)
## Contributors
* All the people who have provided patches to [Gallery(+)](https://github.com/owncloud/gallery/pulls?q=is%3Apr+is%3Aclosed) and [Pictures](https://github.com/owncloud/gallery-old/pulls?q=is%3Apr+is%3Aclosed) over the years
## Requirements
### Browser compatibility
This list is based on the current knowledge of the maintainers and the help they can get.
It will evolve if and when people provide patches to fix all known current issues
#### Fully supported
* Desktop: Firefox, Chrome
* Mobile: Safari, Chrome on Android 5+ and iOS 8.x, BlackBerry 10, Firefox
#### Partially supported
May not look as nice, but should work
* Desktop: Internet Explorer 9-11, Edge
* Mobile: Opera, Chrome on Android 4
#### Not supported
* Desktop: Internet Explorer prior to 9, Safari, Opera
* Mobile: Windows Phone
### Server requirements
#### Required
* ownCloud >= 8.1
* [See ownCloud's requirements](https://doc.owncloud.org/server/8.1/admin_manual/installation/source_installation.html#prerequisites)
#### Recommended
* FreeBSD or Linux server
* PHP 5.5 with caching enabled
* EXIF PHP module
* A recent version ImageMagick with SVG and Raw support
* MySQL or MariaDB instead of Sqlite
* A powerful server with lots of RAM
## Supporting the development
There are many ways in which you can help make Gallery a better product
* Report bugs (see below)
* Provide patches for both [`owncloud/core`](https://github.com/owncloud/core) and the app
* 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](https://www.bountysource.com/teams/interfasys/issues?tracker_ids=9328526) or by directly hiring a maintainer or anybody else who is capable of developing and maintaining it
## Bugs
### Before reporting bugs
* Read the section about server and browser requirements
* Make sure you've disabled the original Pictures app
* Read the "Known issues" section below
* Get the latest version of the app from [the releases page](https://github.com/owncloud/gallery/releases)
* [Check if they have already been reported](https://github.com/owncloud/gallery/issues)
### Known issues
#### Within deep folders
* It may take longer to initialise the view as we're parsing every parent folder to look for configuration files
#### Configurations
* If you have write access on a share belonging to another ownCloud instance, editing the configuration file in your folder will also modify the original folder
### When reporting bugs
* Enable debug mode by putting this at the bottom of **config/config.php**
```
DEFINE('DEBUG', true);
```
* Turn on debug level debug by adding **`loglevel" => 0,`** to your **config/config.php** and reproduce the problem
* Check **data/owncloud.log**
Please provide the following details so that your problem can be fixed:
* **Owncloud log** (data/owncloud.log)
* **Browser log** (Hit F12 to gain access)
* ownCloud version
* App version
* Browser version
* PHP version
## Preparation
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 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
#### 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 [Administration Manual](https://doc.owncloud.org/server/8.0/admin_manual/configuration_server/js_css_asset_management_configuration.html)
## Installation
### Installing from archive
* Go to the [the releases page](https://github.com/owncloud/gallery/releases)
* Download the latest release/archive to your server's **owncloud/apps/** directory
* Unpack the app
* **IMPORTANT**: Make sure the folder name is gallery
### Installing from Git
In your terminal go into the **owncloud/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 **owncloud/apps/gallery/** directory and type:
```
$ git pull --rebase
```
## List of patches
None so far
|
