{"id":13674627,"url":"https://github.com/dmpop/pellicola","last_synced_at":"2026-01-18T19:45:23.486Z","repository":{"id":9630834,"uuid":"11560700","full_name":"dmpop/pellicola","owner":"dmpop","description":"Pastebin for your photos","archived":false,"fork":false,"pushed_at":"2025-05-27T11:09:48.000Z","size":33765,"stargazers_count":182,"open_issues_count":0,"forks_count":16,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-12-15T00:19:11.403Z","etag":null,"topics":["photography","php","webapp"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dmpop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-07-21T11:21:44.000Z","updated_at":"2025-11-06T19:30:31.000Z","dependencies_parsed_at":"2023-11-16T15:55:36.034Z","dependency_job_id":"f92d5881-a99b-4cda-baf4-81b27fbb4b6c","html_url":"https://github.com/dmpop/pellicola","commit_stats":null,"previous_names":["dmpop/pellicola","dmpop/mejiro"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dmpop/pellicola","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmpop%2Fpellicola","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmpop%2Fpellicola/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmpop%2Fpellicola/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmpop%2Fpellicola/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dmpop","download_url":"https://codeload.github.com/dmpop/pellicola/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dmpop%2Fpellicola/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28549722,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-18T19:22:41.102Z","status":"ssl_error","status_checked_at":"2026-01-18T19:22:26.310Z","response_time":98,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["photography","php","webapp"],"created_at":"2024-08-02T11:00:55.506Z","updated_at":"2026-01-18T19:45:23.480Z","avatar_url":"https://github.com/dmpop.png","language":"PHP","funding_links":[],"categories":["Software"],"sub_categories":["Photo and Video Galleries","Photo Galleries"],"readme":"## About Pellicola\n\nPellicola is an easy-to-use PHP web app for instant photo publishing.\n\n\u003cimg src=\"pellicola.jpg\" alt=\"Pellicola\"\u003e\n\n## Features\n\n- **Simplicity** Pellicola requires no installation, and it can be deployed on any web server with PHP.\n- **Instant and easy photo publishing** Upload photos, and Pellicola does the rest.\n- **Responsive design** Pellicola works well on mobile devices.\n- **Pagination** Pellicola automatically splits photo collection into pages. You can specify the desired number of photos per page.\n- **Search** Basic search functionality makes it possible to find photos by their file names and descriptions.\n- **Basic EXIF data** The app extracts and displays basic EXIF info for each photo, including aperture, focal length, shutter speed, and ISO.\n- **Show map** If the `$SHOW_MAP` option is enabled, Pellicola displays an embedded map marking the position of the currently viewed geotagged photo. This also enables a dedicated map that shows all photos in the current album.\n- **OpenStreetMap links or Geo URIs** For geotagged photos, Pellicola displays either OpenStreetMap links or geo URIs that show the exact locations where the photos were taken either in OpenStreetMap or in the default map application.\n- **Optional album description** If a _preamble.html_ file exists in the album's folder, Pellicola displays its contents as the album's description.\n- **Optional photo description** You can add a description to each photo by creating an accompanying _.txt_ file. The app can also read and display descriptions from the photo's _UserComment_ EXIF field.\n- **Automatic language detection** Pellicola automatically detects the browser language and picks the description text file with the appropriate language prefix.\n- **Downloads** With the download option in the _config.php_ file enabled, visitors can download photos.\n- **RAW downloads** For each photo in the JPEG format, you can upload the accompanying RAW file, and Pellicola automatically adds a download link to it when the download option is enabled.\n- **Multiple albums** Subdirectories inside the default photo directory are rendered as individual albums.\n- **Statistics** View basic statistics: camera models, focal length stats, the total number of photos and RAW files, disk usage, and the total number of downloads.\n- **Random photo** feature. Can be used to display photos in a browser in full-screen mode.\n- **Access keys** The application supports [access keys](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/accesskey) for common actions.\n- **Internationalization** support. Pellicola automatically detects and picks the right language. Localizing Pellicola is a matter of translating text strings in an appropriate _.ini_ file.\n- **RSS feed** The application automatically generates an RSS feed with newly added photos.\n- **Self-contained and GDPR-compliant** Pellicola has no external dependencies, and it doesn't collect any user data.\n\n## Requirements\n\n* A web server with PHP7 or higher (tested with Apache and lighttpd)\n* PHP libraries: GD, EXIF\n* Git (optional)\n\n## Installation and usage\n\n1. On Debian, Ubuntu, and Raspberry Pi, install Pellicola by running the following command as root: `curl -sSL https://raw.githubusercontent.com/dmpop/pellicola/main/install.sh | bash`. On other distributions, install the required packages and clone the project's Git repository using the command `git clone https://github.com/dmpop/pellicola.git` as root. Alternatively, you can download the ZIP archive and extract it into the document root of the server.\n2. Open the *config.php* file in a text editor and edit settings.\n3. Put photos into the *photos* directory (_.jpg_, _.jpeg_, _.JPG_, and _.JPEG_ as well as RAW files).\n4. Make the _pellicola_ directory writable by the server by running `chown www-data -R pellicola` as root.\n5. Point the browser to _http://127.0.0.1/pellicola/_ (replace _127.0.0.1_ with the actual IP address or domain name of your server).\n\n### Important note about passwords\n\nThe `$DOWNLOAD_PASSWORD` variable in _config.php_ is set to _secret_. To change it, you have to create a hashed version of the desired password. To do this, you can use the following command (replace _secret_ with the desired password.)\n\n```bash\nphp -r 'echo password_hash(\"secret\", PASSWORD_DEFAULT);'\n```\n\nYou can add descriptions to photos by creating accompanying _.txt_ files. For example, to add a description to the _F994362-R1-14-15.jpg_ photo, create the _F994362-R1-14-15.txt_ file containing a short text. You can use HTML markup for formatting the text. To add description files in other languages, use the appropriate language prefix as follows: _de-F994362-R1-14-15.txt_ (for German), _ja-F994362-R1-14-15.txt_ (for Japanese), etc.\n\n## Run Pellicola in a container\n\nPerform the following steps on the machine you want to use as a Pellicola server.\n\n1. Install [Docker](https://docker.com).\n2. Run the `hostname -I` command and note the IP address of the machine.\n3. Create a directory for storing photos.\n4. Clone the Pellicola Git repository using the `git clone https://github.com/dmpop/pellicola.git` command.\n5. Switch to the resulting _pellicola_ directory, open the _config.php_ file for editing and replace the default value of the `base_url` to the IP address of the machine.\n6. Become root using either `su` or `sudo su` command.\n7. Build an image using the `docker build -t pellicola .` command.\n4. Run a container: `docker run -d --rm -p 80:8000 --name=pellicola -v /path/to/photos:/usr/src/pellicola/photos:rw pellicola` (replace _/path/to/photos_ with the actual path to the created directory).\n5. Point the browser to _http://127.0.0.1_ (replace _127.0.0.1_ with the actual IP address or domain name of the machine running the container).\n\n### Deploy Pellicola with docker-compose.yml\n\nUsing the supplied _docker-compose.yml_ file, you can deploy Pellicola on a machine with a domain name assigned to it. This approach automatically enables HTTPS.\n\n1. Open the _Caddyfile_ for editing.\n2. Replace `\u003cemail address\u003e` with the email address you want to use with the Let's Encrypt service.\n3. Replace `\u003cdomain name\u003e` with the domain name assigned to the server.\n4. Save the changes.\n5. Run the `docker compose -d`command.\n\n## Author\n\nDmitri Popov ([dmpop@fastmail.com](mailto:dmpop@fastmail.com))\n\n## Acknowledgments\n\n- Icons: [Iconoir](https://iconoir.com/)\n- Internationalization: [php-i18n](https://github.com/Philipp15b/php-i18n)\n\n## License\n\nPellicola is released under the [GNU General Public License version 3](http://www.gnu.org/licenses/gpl-3.0.en.html) license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmpop%2Fpellicola","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdmpop%2Fpellicola","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdmpop%2Fpellicola/lists"}