Media

Script: Media_2026-0923-04.ps1 (dotsource from your Media project folder under Chief of Staff / PowerShell / Projects)
Entry point: Get-MediaInfo
Requires: Windows PowerShell 5.1 or PowerShell 7+ with Shell.Application COM (Windows)

Retrieves properties and metadata for picture and video files — dimensions, camera, GPS coordinates (and reverse-geocoded place when available), duration for video, timestamps, and related Shell / EXIF-style fields. This page documents the media-info helper only; Photo_Project management workflows are not covered here yet.

What it returns

Get-MediaInfo returns a cMedia04 object with fields such as:

Identity: FullPath, Directory, Name, Extension, Found, MediaKind (Image | Video | Other), FileSize, Created, LastWrite
Picture / frame: Width, Height, HorizontalResolution, VerticalResolution, RawFormat, PixelFormat, BitDepth
Camera / capture: CameraMaker, CameraModel, DateCreated
GPS / place: Latitude / Longitude (DMS), refs, decimal degrees, Altitude, plus City, State, Country when reverse geocode succeeds
Video: Duration (timespan; Shell duration property, video only)

Parameters

Name	Required	Default	Purpose
`FullPath`	Yes	—	Full path to an image or video file
`UseBitmap`	No	off	Force `System.Drawing.Bitmap` decode for resolution / `PixelFormat` when Shell metadata is thin

Examples

# Dotsource once per session
. "C:\Scripts\Media\Media_2026-0923-04.ps1"

# Basic: properties for one photo
$File = Get-MediaInfo "D:\Photos\sample.jpg"
$File | Format-List

# Video duration + frame size
$Clip = Get-MediaInfo "D:\Video\clip.mp4"
$Clip.Duration
$Clip.Width; $Clip.Height

# Force Bitmap decode when Shell dims are missing
$File = Get-MediaInfo "D:\Photos\sample.jpg" -UseBitmap

How it works

Shell-first: Uses Windows Shell extended properties for camera, GPS, dims, and (for video) duration — cheap for batch scans.
Bitmap fallback: Optional or automatic when an image has no width/height from Shell.
Script-scope class: cMedia04 is compiled once per dotsource (not on every call).
Geocode cache: $global:MediaGeoCache caches Nominatim reverse lookups by rounded lat/long; polite delay only on cache miss.
Helpers: Get-PlaceFromGps, Convert-Dms (also used inline on the hot path).

Supported kinds (by extension)

Image: jpg, jpeg, png, gif, bmp, tif/tiff, heic/heif, webp, jfif
Video: mp4, mov, m4v, avi, mkv, wmv, mpg/mpeg, 3gp, webm
Other extensions still load file identity; media-specific fields may be empty

Notes

Targets Windows (Shell.Application COM). Not intended for non-Windows hosts.
Reverse geocode needs network access to OpenStreetMap Nominatim; failures leave City/State/Country blank.
Photo_Project folder management and catalog workflows are out of scope for this script version.
Keep the .ps1 as the source of truth; the Script source page is for reading/sharing.