camera-gallery/README.md

📸 Embedded Gallery SPA

A lightweight, responsive single-page photo gallery built for embedded Linux systems (e.g., OpenWrt).

This project provides a modern web interface for browsing, uploading, and managing photos directly on your embedded device — optimized for low-resource environments with PHP-FPM and Nginx.

---

🚀 Features

• Single Page Application (SPA) navigation — no full page reloads
• Dynamic gallery with infinite scroll and lazy loading
• GLightbox integration for fullscreen previews and image metadata
• EXIF caching system — stores camera data, lens, aperture, ISO, shutter speed, etc.
• Drag & drop uploads with progress bars and live updates
• Dark / Light themes with persistent preference
• System stats dashboard (CPU, memory, disk, uptime, swap)
• Web shell interface (optional, secure)
• Admin mode with session-based authentication
• Optimized for low RAM and embedded devices

---

🧱 Directory Structure

/srv/www/ ├── index.php ├── includes/ │ ├── config.php │ ├── api.php │ └── admin_auth.php ├── pages/ │ ├── home.php │ ├── gallery.php │ ├── upload.php │ ├── stats.php │ ├── shell.php │ └── admin.php ├── css/ │ ├── style.css │ ├── home.css │ ├── upload.css │ ├── dashboard.css ├── js/ │ ├── app.js │ ├── home.js │ ├── gallery.js │ ├── upload.js │ ├── stats.js │ ├── shell.js │ ├── admin.js ├── cache/ ├── thumbs/ ├── uploads/ └── logs/

---

⚙️ Requirements

• OpenWrt / Linux
• PHP 8+ with:
  • php-fpm
  • php-session
  • php-exif
  • php-gd
  • php-json
• Nginx (configured to serve /srv/www/)
• ImageMagick (optional) for RAW → JPEG conversion
• Filesystem access to /srv/www/a77ii/sorted/jpg and /srv/www/thumbs/

---

🔧 Installation

1. Copy or extract the ZIP:

   sudo unzip srv_www_final.zip -d /srv/
   
    Set permissions:
   
   

sudo chown -R www-data:www-data /srv/www sudo chmod -R 755 /srv/www

Check PHP-FPM session support:

php -m | grep session

Open your browser:

https://<device-ip>/

🔐 Admin Login

To enable upload and admin features:

Generate a password hash:

php -r "echo password_hash('YourPassword', PASSWORD_BCRYPT);"

Paste the result into includes/config.php:

'upload_password' => '$2y$10$replaceThisWithYourOwnHash',

⚡ Performance Tips

Enable Gzip and Brotli in Nginx for faster page loads:

gzip on; gzip_types text/plain text/css application/javascript application/json; brotli on; brotli_types text/plain text/css application/javascript application/json;

Tune PHP-FPM memory usage for small devices (256MB RAM, 4GB swap):

pm = dynamic
pm.max_children = 5
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3
memory_limit = 64M

📦 Updating

Use the included helper script:

sh update-www.sh srv_www_final.zip

It will back up the old site, extract the new one, and fix permissions automatically. 🧑‍💻 Author

James Blackmore (reclusejay) Built with ❤️ and PHP for embedded systems. 📜 License

This project is released under the MIT License. Feel free to modify, extend, and use it in your own projects.