Release 0.2.0

[Majorfi]

Enhanced Photo Management Tools

We're excited to announce a major update to immich-stack that brings powerful new commands for managing your photo library!

🎉 What's New

🔍 Duplicate Detection Command

Why: When migrating from other photo management systems or after multiple imports, duplicates are inevitable. Manually finding them in thousands of photos is time-consuming and error-prone. This command automates the process, helping you reclaim storage space and maintain a clean library.

Find duplicate photos in your Immich library with the new duplicates command:

immich-stack duplicates --api-key your_key

• Identifies photos with identical filenames and timestamps
• Perfect for cleaning up after migrations or multiple imports
• Supports multi-user libraries
• Safe, read-only operation

🗑️ Smart Trash Management

Why: When you delete a photo from a stack in Immich, related photos (like RAW files or burst sequences) often remain, breaking the intended organization. This leads to incomplete cleanups and orphaned files cluttering your library. The fix-trash command automatically identifies and moves these related assets to trash, maintaining stack integrity.

The new fix-trash command ensures your stacks stay consistent when deleting photos:

immich-stack fix-trash --api-key your_key --dry-run

• Automatically finds and trashes related stack members
• Uses your existing stacking criteria
• Preview changes with dry-run mode
• Maintains library organization integrity

🛠️ Additional Improvements

Why We Made These Changes:

• Remove Single-Asset Stacks: Previously, single-asset stacks were automatically removed by default. However, some users prefer to keep these for workflow reasons or future additions. This new flag gives you control over this behavior, defaulting to preserving single-asset stacks while allowing cleanup when desired.
• Enhanced Logging: Production environments need different logging than development. JSON logs integrate with monitoring systems, while debug levels help troubleshoot issues. These options give you the control needed for any deployment scenario.
• Better Architecture: As immich-stack grew beyond simple stacking, the monolithic design became limiting. The modular command structure makes it easier to add new features, maintain existing ones, and allows users to run only what they need.
• Full Backward Compatibility: We respect your existing automation and workflows. All new features are additive, ensuring your current setups continue working without any modifications required.

📋 Complete Workflow Example

# 1. Find duplicates first
immich-stack duplicates --api-key your_key

# 2. Create/update stacks
immich-stack --api-key your_key

# 3. Clean up after deletions
immich-stack fix-trash --api-key your_key

🚀 Getting Started

Docker Users

docker pull ghcr.io/majorfi/immich-stack:latest

Binary Users

Download the latest release from the releases page.

📖 Documentation

• Duplicates Command Guide
• Fix-Trash Command Guide
• Full Documentation

💬 Feedback

We'd love to hear your feedback! Please report any issues or suggestions on our GitHub repository.

🙏 Thank You

Thank you to all users who help make immich-stack better with each release!

---

Note: This update maintains full backward compatibility. Your existing configurations and scripts will continue to work without any changes.

https://github.com/Majorfi/immich-stack/releases/tag/v0.2.0