PHPackages wizballesy/librenms-device-photo - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. wizballesy/librenms-device-photo ActivePackage[Utility & Helpers](/categories/utility) wizballesy/librenms-device-photo ================================ LibreNMS plugin for adding, viewing and managing photos for devices. v0.1.0-alpha.27(1w ago)294↓50%GPL-3.0-or-laterBladePHP ^8.2 Since May 16Pushed 1w agoCompare [ Source](https://github.com/WizballESY/librenms-device-photo)[ Packagist](https://packagist.org/packages/wizballesy/librenms-device-photo)[ RSS](/packages/wizballesy-librenms-device-photo/feed)WikiDiscussions main Synced 1w ago READMEChangelog (10)Dependencies (1)Versions (31)Used By (0) LibreNMS Device Photos ====================== [](#librenms-device-photos) **LibreNMS Device Photos** is a LibreNMS plugin for adding, viewing and managing photos for devices. It is useful for documenting switches, firewalls, routers, servers, racks, patch panels, installation details and other physical device-related information directly inside LibreNMS. The plugin adds: - a **Device Photos** widget on the normal LibreNMS device page - a **Manage Device Photos** page for each device - a global **Device Photos Overview** page for administration and cleanup --- Status ------ [](#status) This plugin is currently in **alpha**. It is under active development and may contain bugs, incomplete documentation or breaking changes. Test thoroughly before using it in production. --- Screenshots ----------- [](#screenshots) - [Device Photos widget](docs/screenshots/device-photos.png) - [Fullscreen photo viewer](docs/screenshots/photo-fullscreen.png) - [Manage Device Photos](docs/screenshots/manage-device-photos.png) - [Device Photos Overview](docs/screenshots/device-photos-overview.png) --- Features -------- [](#features) - Upload photos to LibreNMS devices. - View photos directly from the normal LibreNMS device overview page. - Manage photos per device. - Global photo overview page. - Private photo storage outside the public webroot. - Authenticated image delivery through LibreNMS. - Drag and drop upload. - Upload multiple files at once. - Supported upload types: `jpg`, `jpeg`, `png`, `webp`, `heic`, `heif`. - HEIC/HEIF conversion to JPG when ImageMagick supports HEIC/HEIF. - Thumbnail generation. - JPEG thumbnail auto-rotation based on EXIF Orientation. - Missing thumbnail detection and generation. - Stale thumbnail detection and cleanup. - Full-size image viewer with zoom and pan. - Photo date display: - `Photo taken` from EXIF when available. - `File date` from the server file timestamp. - Write `Photo taken` back to JPG/JPEG EXIF metadata using ExifTool. - Reorder owned and linked photos together. - Link photos between devices. - Automatically clean stale links and mixed-order entries when photos or links change. - Detect broken photo links. - Detect orphaned photos from removed LibreNMS devices. - Assign orphaned photos to existing devices. - Soft-delete photos by moving them to a deleted folder. - Restore deleted photos to a selected target device. - Search, pagination and sortable overview table. - Browser-saved page size preference for the overview table. - Cache-busting image URLs. --- Requirements ------------ [](#requirements) - LibreNMS with the package/plugin system available. - PHP `>= 8.2`. - A writable LibreNMS storage directory. Optional, but recommended: - PHP GD extension for thumbnail generation. - ExifTool for writing `Photo taken` metadata to JPG/JPEG files. - ImageMagick with HEIC/HEIF support for HEIC/HEIF uploads. --- Installation ------------ [](#installation) This plugin is installed as a Composer package. Manual copy-based installation is no longer the recommended installation method. ### Install from Packagist [](#install-from-packagist) Recommended installation method: ``` cd /opt/librenms sudo -u librenms ./lnms plugin:add wizballesy/librenms-device-photo v0.1.0-alpha.27 sudo -u librenms php artisan optimize:clear sudo -u librenms php artisan view:clear ``` This uses LibreNMS' plugin package installer and installs the package from Packagist. After installation, open: ``` /plugin/device-photo ``` Testing ------- [](#testing) For alpha release testing, see the [alpha release test checklist](docs/testing-alpha.md). ### Development install from GitHub [](#development-install-from-github) For development testing before a tagged release, you can install directly from the GitHub repository: ``` cd /opt/librenms sudo -u librenms php /opt/librenms/composer.phar config repositories.librenms-device-photo vcs https://github.com/WizballESY/librenms-device-photo sudo -u librenms ./lnms plugin:add wizballesy/librenms-device-photo dev-main sudo -u librenms php artisan optimize:clear sudo -u librenms php artisan view:clear ``` For normal users, prefer the tagged Packagist install above. ### LibreNMS validate note [](#librenms-validate-note) Installing LibreNMS plugin packages modifies: ``` composer.json composer.lock ``` LibreNMS `validate` may warn that these files are locally modified after installing third-party plugin packages. This is expected because the plugin is installed as a Composer dependency inside the LibreNMS application directory. Do not run `./scripts/github-remove` unless you intentionally want to remove local Composer changes. --- Storage directories ------------------- [](#storage-directories) The plugin stores uploaded photos and metadata under LibreNMS `storage/app`. Default paths: ``` storage/app/device-photos storage/app/device-photos/thumbs storage/app/device-photos-deleted storage/app/device-photos-deleted/thumbs storage/app/device-photos-order storage/app/device-photos-links ``` These directories are normally created automatically when the plugin page is opened or when photos are uploaded. If you get permission warnings, verify ownership and permissions. Many LibreNMS installs use `librenms:librenms`: ``` cd /opt/librenms mkdir -p \ storage/app/device-photos/thumbs \ storage/app/device-photos-deleted/thumbs \ storage/app/device-photos-order \ storage/app/device-photos-links chown -R librenms:librenms \ storage/app/device-photos \ storage/app/device-photos-deleted \ storage/app/device-photos-order \ storage/app/device-photos-links find storage/app/device-photos storage/app/device-photos-deleted storage/app/device-photos-order storage/app/device-photos-links \ -type d -exec chmod 2775 {} \; find storage/app/device-photos storage/app/device-photos-deleted storage/app/device-photos-order storage/app/device-photos-links \ -type f -exec chmod 664 {} \; ``` --- Backup ------ [](#backup) Before installing, upgrading or uninstalling the plugin, back up the plugin data stored under LibreNMS `storage/app`. The most important paths are: ``` storage/app/device-photos storage/app/device-photos-deleted storage/app/device-photos-order storage/app/device-photos-links ``` This includes uploaded photos, thumbnails, deleted photos, saved photo order and photo links. Example backup command: ``` cd /opt/librenms sudo tar -czf /root/librenms-device-photo-backup-$(date +%Y%m%d-%H%M).tar.gz \ storage/app/device-photos \ storage/app/device-photos-deleted \ storage/app/device-photos-order \ storage/app/device-photos-links ``` To inspect the backup: ``` tar -tzf /root/librenms-device-photo-backup-YYYYMMDD-HHMM.tar.gz | head ``` Keep this backup somewhere safe before making major changes. --- Configuration ------------- [](#configuration) Default configuration: ``` 'photos_path' => 'app/device-photos', 'order_path' => 'app/device-photos-order', 'links_path' => 'app/device-photos-links', 'max_upload_bytes' => 10 * 1024 * 1024, 'max_pixels' => 40000000, 'allowed_extensions' => [ 'jpg', 'jpeg', 'png', 'webp', 'heic', 'heif', ], ``` ### Link and order metadata [](#link-and-order-metadata) Linked photo metadata is stored under: ``` storage/app/device-photos-links/device-.json ``` Each link entry points from the target device to a photo owned by another device. Example link entry: ``` [ { "owner_device_id": 109, "filename": "device-109-2.png" } ] ``` Custom photo ordering is stored under: ``` storage/app/device-photos-order/device-.json ``` The order file can contain both owned photos and linked photos. Owned photo key example: ``` device-108-1.jpg ``` Linked photo key format: ``` linked:: ``` Example mixed order file: ``` [ "device-108-1.jpg", "linked:109:device-109-2.png", "device-108-2.jpg" ] ``` The plugin keeps existing order where possible, removes stale order entries, and appends new valid uploaded or linked photos to the saved order. ### Deleted photo restore [](#deleted-photo-restore) Deleted photos are moved to: ``` storage/app/device-photos-deleted ``` Deleted thumbnails are moved to: ``` storage/app/device-photos-deleted/thumbs ``` Older alpha releases stored deleted photos under `storage/app/device-photos/deleted`. Alpha 19 and newer use `storage/app/device-photos-deleted` instead. The maintenance panel can detect and migrate the old deleted photo storage. Deleted photo filenames include the original filename plus a deletion timestamp before the file extension. Example deleted filename: ``` device-108-5.deleted-20260518-174625.jpg ``` When restoring a deleted photo, the admin selects the target LibreNMS device. The plugin does not blindly restore the photo to the old device ID from the deleted filename. Instead, the restored photo is renamed to match the selected target device using the next available filename. Example: ``` device-108-5.deleted-20260518-174625.jpg -> device-109-3.jpg ``` Restoring a photo does not rewrite the saved mixed order file. Existing owned and linked photo order is preserved, and the restored owned photo is appended automatically when the target device photo manager is rendered. --- Optional dependencies --------------------- [](#optional-dependencies) On Debian/Ubuntu, the recommended optional packages are: ``` sudo apt install php-gd libimage-exiftool-perl imagemagick libheif1 libheif-plugin-libde265 libde265-0 ``` Package names may vary between distributions. ### PHP GD [](#php-gd) PHP GD is used for thumbnail generation. Check if GD is loaded: ``` php -m | grep -i '^gd$' || echo "GD missing" ``` ### ExifTool [](#exiftool) ExifTool is used when writing `Photo taken` metadata to JPG/JPEG files. ``` command -v exiftool || echo "exiftool missing" ``` ### ImageMagick HEIC/HEIF support [](#imagemagick-heicheif-support) ImageMagick is used for HEIC/HEIF conversion. ``` command -v magick || echo "magick missing" magick -list format 2>/dev/null | grep -Ei 'HEIC|HEIF' || echo "No HEIC/HEIF support shown" ``` HEIC/HEIF uploads require ImageMagick with HEIC/HEIF read support. Uploaded HEIC/HEIF photos are converted to JPG. --- Internal package endpoints -------------------------- [](#internal-package-endpoints) The plugin page is available through LibreNMS as: ``` /plugin/device-photo ``` The package also uses internal authenticated endpoints: ``` /plugin/device-photo-package/image /plugin/device-photo-package/action ``` These are used for image delivery and POST actions. --- Updating -------- [](#updating) To update to a specific release: ``` cd /opt/librenms sudo -u librenms ./lnms plugin:add wizballesy/librenms-device-photo v0.1.0-alpha.27 sudo -u librenms php artisan optimize:clear sudo -u librenms php artisan view:clear ``` Replace `v0.1.0-alpha.27` with the version you want to install. LibreNMS `validate` may warn that `composer.json` and `composer.lock` are modified after installing or updating third-party plugin packages. This is expected because the plugin is installed as a Composer dependency inside the LibreNMS application directory. --- Uninstall --------- [](#uninstall) Disable the plugin: ``` cd /opt/librenms sudo -u librenms ./lnms plugin:disable device-photo sudo -u librenms php artisan optimize:clear ``` Remove the package: ``` cd /opt/librenms sudo -u librenms composer remove wizballesy/librenms-device-photo sudo -u librenms php artisan optimize:clear ``` This does not remove stored photos or metadata. To remove stored plugin data manually: ``` cd /opt/librenms rm -rf storage/app/device-photos rm -rf storage/app/device-photos-deleted rm -rf storage/app/device-photos-order rm -rf storage/app/device-photos-links ``` Be careful: this deletes uploaded photos and metadata. --- Security notes -------------- [](#security-notes) - Images are served through authenticated package endpoints. - Users must have LibreNMS `global-read` access to view photos. - Deleted photos require delete permissions to view. - POST actions use LibreNMS/Laravel web middleware and CSRF protection. - Uploaded filenames are normalized and validated. - Original photos are stored outside the public webroot. --- Support ------- [](#support) If this plugin saves you time or helps your LibreNMS setup, you can optionally support the project here: [Support the project](https://paypal.me/WizballESY) Donations are optional and are not required to use the plugin. --- License ------- [](#license) GPL-3.0-or-later. ### Health Score 43 — FairBetter than 89% of packages Maintenance98 Actively maintained with recent releases Popularity17 Limited adoption so far Community6 Small or concentrated contributor base Maturity43 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 24 Last Release 13d ago PHP version history (2 changes)v0.1.0-alpha.4PHP >=8.2 v0.1.0-alpha.7PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/7f9fa43e58cc841d6636df7314ffce59d7c2e12c7519b067db89efed4be5970b?d=identicon)[WizballESY](/maintainers/WizballESY) --- Top Contributors [![WizballESY](https://avatars.githubusercontent.com/u/96005757?v=4)](https://github.com/WizballESY "WizballESY (293 commits)") ### Embed Badge ![Health badge](/badges/wizballesy-librenms-device-photo/health.svg) ``` [![Health](https://phpackages.com/badges/wizballesy-librenms-device-photo/health.svg)](https://phpackages.com/packages/wizballesy-librenms-device-photo) ``` ### Alternatives [shixinke/php-ide-helper a tool that provides auto-completion for php frameworks and extensions 2211.4k1](/packages/shixinke-php-ide-helper)[magestat/module-floating-buy-button Get your customer attention the most important action in your online store, the purchase. 121.6k](/packages/magestat-module-floating-buy-button) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)