nc-photos/README.md

62 lines
2.9 KiB
Markdown
Raw Normal View History

2021-04-10 06:28:12 +02:00
# Photos (for Nextcloud)
Photos (for Nextcloud) is a new gallery app for viewing your photos hosted on Nextcloud servers
2021-07-16 20:28:04 +02:00
[<img src="https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png" alt="Google Play" width="160" />](https://play.google.com/store/apps/details?id=com.nkming.nc_photos.paid&referrer=utm_source%3Drepo)
Or the [free ad-supported version](https://play.google.com/store/apps/details?id=com.nkming.nc_photos&referrer=utm_source%3Drepo)
2021-04-10 06:28:12 +02:00
2021-04-20 12:21:17 +02:00
*\*See [Web Support](#web-support) if you want to try the experimental web app*
2021-04-10 06:28:12 +02:00
Features:
2021-06-22 22:20:29 +02:00
- Support JPEG, PNG, WebP, HEIC, GIF images
2021-07-16 20:28:04 +02:00
- Support MP4, WebM videos (Android only)
2021-04-20 15:17:48 +02:00
- EXIF support (JPEG and HEIC only)
2021-04-10 06:28:12 +02:00
- Organize photos with albums that are independent of your file hierarchy
2021-06-22 22:20:29 +02:00
- Sign-in to multiple servers
2021-04-10 06:28:12 +02:00
- and more to come!
2021-08-02 07:53:13 +02:00
Translations (sorted by ISO name):
2021-08-05 15:19:54 +02:00
- français (contributed by mgreil)
2021-08-02 07:53:13 +02:00
- ελληνικά (contributed by Chris Karasoulis)
2021-06-22 22:20:29 +02:00
- Español (contributed by luckkmaxx)
2021-04-10 06:28:12 +02:00
This app does not require any server-side plugins.
2021-04-20 12:21:17 +02:00
## Web Support
Web support is **EXPERIMENTAL** and is provided on a best effort basis. It may be subject to change at any time without notice. Please read carefully the instructions listed below or else the app will likely fail to work.
### Enable CORS support on Nextcloud server
By default your browser will block **all** requests due to the lack of CORS support. To fix it, you can add the following lines to `.htaccess` in your Nextcloud installation directory. This can only be done by admins with remote access rights to the Nextcloud server.
```
...
ModPagespeed Off
</IfModule>
#### DO NOT CHANGE ANYTHING ABOVE THIS LINE ####
# Copy from this line
RewriteCond %{REQUEST_METHOD} OPTIONS
RewriteRule .* / [R=200,L]
SetEnvIf Origin "http(s)?://nkming2.gitlab.io$" AccessControlAllowOrigin=$0
Header always set Access-Control-Allow-Origin %{AccessControlAllowOrigin}e env=AccessControlAllowOrigin
Header always merge Vary Origin
Header always set Access-Control-Allow-Methods "*"
Header always set Access-Control-Allow-Headers "*"
Header always set Access-Control-Allow-Credentials "true"
Header always set Access-Control-Max-Age "86400"
# up to this line
ErrorDocument 403 /
ErrorDocument 404 /
<IfModule mod_rewrite.c>
...
```
You may need to reload the server config and clear browser cache afterwards.
If it's not possible to gain remote access to the server, you can instead disable CORS support in your browser. **WARNING: This is highly discouraged and must only be done with caution**
### HTTP/HTTPS
You are suggested to configure your server to accept HTTPS connections. If that's again, not possible, you must use the HTTP link below as your browser would block all HTTP communications coming from a HTTPS site.
### Ok, I'm ready
Cool. Follow the [https link](https://nkming2.gitlab.io/nc-photos-web) or the [http link](http://nkming2.gitlab.io/nc-photos-web) (use this only if your server doesn't support HTTPS)