base on Damselfly is a server-based Photograph Management app. The goal of Damselfly is to index an extremely large collection of images, and allow easy search and retrieval of those images, using metadata such as the IPTC keyword tags, as well as the folder and file names. Damselfly includes support for object/face detection.  # Damselfly - A Photo Management System Damselfly is a server-based Digital Photograph Management system. Damselfly is designed to manage a large, folder-based collection of photographs, with a particular focus on fast search and keyword-tagging workflow. Damselfly includes powerful Machine Learning functions which can help you identify photographs and their subjects, including face detection, face recognition and object detection - allowing you to tag people once, and have Damselfly identify other photos in which they appear. The user-interface and workflow is loosely based on the much-loved Google Picasa app, with a basket to select images for export and other types of processing. Damselfly also provides a desktop/client app which gives closer integraton with your laptop or PC, allowing you to quickly sync a selection of images from the Damselfly basket to a local folder, for editing etc. ## Features * Support for most image formats including JPG, PNG, HEIC, TIFF, Webp, BMP and DNG/CR2/ORF/NEF (RAW) files. * AI / Computer vision image recognition: * Facial detection * Facial Recognition * Object detection and recognition * Image Colour Classification * Full-text search with multi-phrase partial-word searches * Image re-organisation - move/copy images between folders, and delete images (via a trashcan folder) * Advanced search - filter by: * Find visually similar images * Date ranges * Objects/Faces/Identified faces * Camera/Lens Make/Model * File Size * Orientation * Images with no keyword tags <div> <img style="margin: 5px;" src="docs/Damselfly-search.jpg" alt="Advanced Search in Damselfly" width="800"/> <div> * Focus on extremely fast performance - searching a 500,000-image catalogue returns results in less than a second. * Fast keyword tagging workflow with non-destructive EXIF data updates (using ExifTool) - so JPEGs are not re-encoded when keyword-tagged * Face detection and recognition, and object recognition in images * [Multi-user support with user accounts](./docs/Multi-user.md), and role-based entitlements (e.g., users with ReadOnly role are prevented from keyword-tagging images) * Download/export processing to watermark images ready for social media, or sending via Email etc. * GeoLocation with map display of photo locations where metadata exists * Selection basket for saving images from search results: * Images within the basket can be downloaded, exported for use within Digikam/PhotoShop/etc., or uploaded to Wordpress * Baskets can be user-specific, or shared with other users * Server-based deployment, with a web-based front-end UI, so the image library can be accessed via multiple devices without having to copy catalogues or other DBs to local device storage. * Exclude images from Damselfly scanning by adding a `.nomedia` file in any folder. * Themes * Completely automated background indexing of images, so that the collection is automatically and quickly updated when new images are added or updated * Background thumbnail generation * Electron.Net Desktop Client for hosted site to allow closer native integration with client OS * Desktop Client versions for MacOS (universal), Windows and Linux * Synchronise images from server basket select to local filesystem for editing * Other integrations coming in future * Runs on Windows, Linux and OSX, and in Docker. * Built with Microsoft .Net 7, hosted Blazor WebAssembly and EFCore 7. ## Update on Damselfly Face Recognition Support > Damselfly used to provide face-recognition via the Microsoft Azure Face API. However, Microsoft have recently [locked down the use of this API](https://stackoverflow.com/questions/73095624/unable-to-use-azure-face-api-forbidden-error). The latest version of Damselfly now supports full face detection and recognition locally and offline. ## Want to Support Damselfly? Damselfly is free, open-source software. But if you find it useful, and fancy buying me a coffee or a slice of pizza, that would be appreciated! <a href="https://www.buymeacoffee.com/damselfly" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/arial-green.png" alt="Buy Me A Coffee" height="41" width="174"></a> # Getting in Touch You can follow Damselfly on [Twitter](https://twitter.com/damselflyphotos) or ask questions/get support on Reddit ([r/DamselflyPhotos](https://reddit.com/r/damselflyphotos)). If you have problems, feature requests or have found a bug, you can [raise an issue](https://github.com/Webreaper/Damselfly/issues). Or if you want to say hello, [email me](mailto:[email protected]). ## Screenshots <div> <img style="margin: 5px;" src="docs/Damselfly-browsing.jpg" alt="Browsing in Damselfly" width="600"/> <img style="margin: 5px;" src="docs/Damselfly-theme.jpg" alt="Themes in Damselfly" width="600"/> <br/> <br/> <img style="margin: 5px;" src="docs/Damselfly-imageview.jpg" alt="Viewing images in Damselfly" width="600"/> <img style="margin: 5px;" src="docs/Damselfly-AI.jpg" alt="Face and Object Detection in Damselfly" width="600"/> <br/> <img style="margin: 5px;" src="docs/Damselfly-grouping.jpg" alt="Browsing images grouped by date Damselfly" width="600"/> <div> ## Planned Features/Enhancements * Simple non-destructive editing/manipulation - cropping, colour adjustment etc (in progress) * Image de-duplication (in progress) * Support for more image formats, and possibly video * Support for selection and upload to Alamy Stock Image photo service * Synchronisation of local images back to the server * If you have ideas for other features - let me know by [raising an issue](https://github.com/Webreaper/Damselfly/issues)! # How should I use Damselfly? What's the workflow? The photos live in the library on the server, but whenever you want to work on a picture (e.g., in Photoshop, Digikam or your editing tool of choice) you use the Damselfly Deskop app to add the images to the basket, and choose Download => Save Locally, to sync the pictures across the network to your local folder. Once you've finished editing, copy them back to the server (a future feature enhancement will let Damselfly do this for you) where the server will re-index them to pick up your changes. ### Suggested workflow. 1. Images are copied onto a laptop for initial sorting, quality checks, and IPTC tagging using Picasa or Digikam 2. [Rclone](https://rclone.org/) script syncs the new images across the LAN to the network share 3. Damselfly automatically picks up the new images and indexes them (and generates thumbnails) within 30 minutes 4. Images are now searchable in Damselfly and can be added to the Damselfly 'basket' with a single click 5. Images in the basket can be copied back to the desktop/laptop for local editing in Lightroom/On1/Digikam/etc. * Use the Damselfly Desktop client to write the files directly to the local filesystem in the same structure as on the server. * Export to a zip file to download and extract into the local image folder for additional editing 6. Re-sync using RClone to push the images back to the collection [Future enhancement: Damselfly Desktop App will do this for you] ## More information * [Installation](./docs/Installation.md) * [Multi-User and Roles](./docs/Multi-user.md) * [Technical Background](./docs/Technical.md) * [FAQ](./docs/FAQ.md) * [Contributing to Damselfly](./docs/Contributing.md) ## Thanks and Credits * Microsoft [Blazor.Net](https://blazor.net) for allowing me to avoid writing Javascript. ;) * [PumpkinBeth](https://pumpkinbeth.com) (my wife) for taking the photo that appears in Damselfly's logo, and for providing the original inspiration to build Damselfly - as well as the 600,000 photos and counting which make excellent test data! * [SkiaSharp](https://github.com/mono/SkiaSharp) Fast library for Thumbnail generation * [SixLabors ImageSharp](https://github.com/SixLabors/ImageSharp) Portable library for Thumbnail generation * Drew Noakes' [MetadataExtractor](https://github.com/drewnoakes/metadata-extractor-dotnet), for IPTC and other image meta-data indexing * Phil Harvey's [ExifTool](https://exiftool.org/) which Damselfly uses for all of the EXIF write operations * ZZZ Project's [Entity Framework Extensions](https://entityframework-extensions.net) for their excellent EFCore extensions. * [MudBlazor](https://mudblazor.com/) for their excellent Blazor component library * [FaceONNX](https://github.com/FaceONNX/FaceONNX) for their excellent face detection and recognition library * [Font Awesome](https://fontawesome.com/) for their Awesome icons * Chris Sainty for [Blazored](https://github.com/Blazored) Modal and Typeahead, and all his excellent info on Blazor * [Serilog.Net](https://serilog.net/) for logging * Wisne for [Infinite Scroll](https://github.com/wisne/InfiniteScroll-BlazorServer) inspiration ", Assign "at most 3 tags" to the expected json: {"id":"7098","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"