uMediaOps 2.0.0

uMediaOps - Media Management Suite for Umbraco

Comprehensive media management package for Umbraco 17 & 18 that helps you find duplicates, clean up unused media, create backups, and track all operations with audit logging.

Features

Screenshots

Installation

dotnet add package uMediaOps

On Umbraco 17? Use the v1.x branch: dotnet add package uMediaOps --version 1.0.6

The package automatically:

• Registers all services via Umbraco's Composer pattern
• Runs database migrations on first startup
• Adds the "uMediaOps" section to the Umbraco backoffice

Getting Started

After installing the package and restarting your Umbraco site:

1. Log in to the Umbraco backoffice
2. Go to Users section → select your user group (e.g., "Administrators")
3. Under Permissions → Sections, enable the uMediaOps section and save
4. Refresh the page — the uMediaOps icon will appear in the left sidebar
5. Click it to access the Overview dashboard with all features

Configuration

Add to your appsettings.json (optional — defaults are provided):

{
  "uMediaOps": {
    "BackupDirectory": "~/App_Data/uMediaOps/Backups",
    "BackupRetentionDays": 30
  }
}

Requirements

• Umbraco 18.0+
• .NET 10.0+
• SQLite or SQL Server

Version Compatibility

Which version should I use?

• Umbraco 18 → Install uMediaOps version 2.x (dotnet add package uMediaOps)
• Umbraco 17 → Install uMediaOps version 1.x (dotnet add package uMediaOps --version 1.0.6)

Upgrading from 1.x to 2.x

If you're upgrading from Umbraco 17 to Umbraco 18:

1. Update your Umbraco packages to 18.x
2. Update uMediaOps to 2.x: dotnet add package uMediaOps --version 2.0.0
3. Build and run — no code changes or migration steps required

The v2.0 package is API-compatible with v1.x. The only change is the Umbraco version target. All database tables, configuration, and functionality remain the same.

Branch Strategy

• main — Active development for Umbraco 18 (v2.x releases)
• v17/dev — Maintenance branch for Umbraco 17 (v1.x patch releases)

Database Tables

uMediaOps creates the following tables automatically via migrations:

• uMediaOps_FileHashes — SHA256 hashes for duplicate detection
• uMediaOps_References — Media reference tracking
• uMediaOps_AuditLog — Operation audit trail
• uMediaOps_Analytics — Scan statistics and trends
• uMediaOps_Backups — Backup metadata
• uMediaOps_UnusedMediaScans — Unused media scan metadata
• uMediaOps_UnusedMediaItems — Individual unused media items

API Endpoints

All endpoints require backoffice authentication and are available under: /umbraco/management/api/v1/umediaops/

Known Limitations

• Background operations (scans, backups) run in-process. If the app pool recycles mid-operation, work in progress will be lost.
• Progress tracking uses in-process memory cache, designed for single-instance deployments.

Documentation

• Contributing

License

MIT License — see LICENSE for details.