Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/schorschii/autogallery
Simple self-hosted gallery web app for presenting/sharing photos, videos and files
https://github.com/schorschii/autogallery
chapters cloud file gallery html5 iptc photo sharing subtitles video webapp
Last synced: 1 day ago
JSON representation
Simple self-hosted gallery web app for presenting/sharing photos, videos and files
- Host: GitHub
- URL: https://github.com/schorschii/autogallery
- Owner: schorschii
- License: gpl-3.0
- Created: 2024-05-29T17:08:15.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2024-12-10T22:10:25.000Z (about 2 months ago)
- Last Synced: 2025-01-20T10:44:16.150Z (6 days ago)
- Topics: chapters, cloud, file, gallery, html5, iptc, photo, sharing, subtitles, video, webapp
- Language: PHP
- Homepage:
- Size: 2.71 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
README
# AutoGallery
AutoGallery is a simple PHP web app for presenting images, videos and other files with some special features.
## Features
- images
- optional display of IPTC fields
- lightbox with slideshow, fullscreen & download option
- videos
- display chapters and subtitles
- nice 3D effect on mouse hover
- optional password protection
- dark mode
## Installation
1. Copy all files onto your web server.
2. Copy your files (images, videos and other files; sub-directories possible) into the `media` dir.
3. Create `conf.php` from `conf.php.example`.
Optional: change values:
- change gallery title in `const TITLE`
- set a password in `const PASSWORD` (can also be an array with multiple passwords)
- set which IPTC fields should be shown in `const PHOTO_TITLE` and `const PHOTO_SUBTITLE`
## Usage
### Symlinks
The application supports symlinks which allows you to create easy-to-read URLs. Example: you have a folder called "Holidays June 2014". You can create a symlink via `ln -s "Holidays June 2014" "holidays2014"` so you can share the simpler URL `https://gallery.example.com/holidays2014` with your friends. The web app still shows the nice name "Holidays June 2014" as headline even when accessed via shortlink.
### HTML Description
You can display a descriptive text to each folder by creating a file `index.html` in your media folder with the desired HTML content.
### Hide Folders
You can hide folders the common Unix way by adding a "." at the beginning of the folder name. The folder is still accessible!
### Videos with Chapters, Subtitles and Thumbnail
Video subtitles and chapters are read from .vtt files. If you want to add such to a video, you need to create a folder with the same name as the video file (without file extension). Inside this folder, place your .vtt files with the following file name schema.
- Subtitles: `subtitles..vtt`, e.g. `subtitles.de.vtt`
- Chapters: `chapters..vtt`
If you want to show a custom thumbnail, place a file called `thumbnail.jpg` in this folder.
A file tree could look like this:
```
media/
- myvideo.mp4
- myvideo/
-- subtitles.en.vtt
-- subtitles.de.vtt
-- chapters.en.vtt
-- thumbnail.jpg
```
Bonus: if available, you can extract embedded chapters from video files with `ffprobe` from ffmpeg using the `chapters.py` script:
```
python3 chapters.py video.mov > chapters.en.vtt
```
### Statistics
If you want to capture user statistics, you need to create a MySQL/MariaDB database and import the database schema from `sql/SCHEMA.sql`. Then, enter your database credentials in the `STAT_DB_*` constants in `conf.php`. And all requests will be logged into that database.