Documentation

NyzeX MetaStudio is a client-side metadata editing studio that extracts, edits, and exports hidden metadata from images, videos, and audio files — all in your browser, with zero server uploads.

Getting Started

Quick Start

1. Open index.html in any modern browser
2. Click Launch Studio to open the workspace
3. Drag & drop a file onto the drop zone — parsing starts automatically
4. Browse metadata by category in the Analytics panel
5. Edit fields in the Edit tab, then download the updated file

Optional: ExifTool Backend

For deeper extraction (RAW files, all 200+ fields), start the backend:

cd hf-metastudio-api
pip install -r requirements.txt
uvicorn main:app --reload --port 3000

The studio auto-detects the backend at localhost:3000 and falls back to the built-in parser if unavailable.

Workflow

1. Upload — Drop any supported file (image, video, audio) onto the workspace. Files stay on your device.
2. Parse — Metadata is extracted via the built-in parser or ExifTool backend. Fields are grouped into categories: General, Camera, GPS, Copyright, SEO, Dates, Dimensions, Format Details, JFIF, IPTC, XMP, QuickTime.
3. Edit — Switch to the Edit tab to modify, add, or remove metadata fields. GPS coordinates appear on an interactive map. Use the date picker on time-related fields.
4. Export — Download the cleaned file with updated metadata, or export a JSON/PDF metadata report.

Features

Image Metadata

Read and write EXIF, IPTC, and XMP metadata including camera make/model, lens, focal length, aperture, shutter speed, ISO, GPS coordinates, copyright, and descriptions.

Video Analysis

Extract codec information, bitrate, frame dimensions, duration, creation timestamps, rotation, and QuickTime metadata.

Audio Insights

Read sample rate, bit depth, encoder, album art, lyrics, genre, track number, and format-specific tags from MP3, WAV, FLAC, AAC, OGG, and more.

GPS Map View

Plot GPS coordinates on an interactive Leaflet map. Reverse geocoding displays the location address. Supports drag-to-adjust on the edit map.

Privacy Scrub

Strip all sensitive metadata — location, camera serial, author info, timestamps — before sharing files publicly.

AI Analysis

Send files to Google Gemini 2.5 Flash for AI-powered content analysis. Supports images, video frames (4-frame extraction), and audio content.

PDF Export

Generate a professional metadata report as PDF with watermarking and organized sections.

GPS Mapping

The GPS Location panel provides an interactive map powered by Leaflet and a rich detail section split into two parts:

File Location Details

• Interactive Map — Leaflet map with marker at the file's GPS coordinates
• Reverse Geocoding — Coordinates resolved to a human-readable address via Nominatim (with extratags for Wikipedia, population, elevation when available)
• Address Breakdown — Country, State/Prefecture, County, City/Town, Neighbourhood, Road, Postcode
• Coordinate Format — All coordinates displayed as decimal degrees (e.g., 36.000000, 139.000000)

Your IP Geolocation

• Separate Section — Displayed below the file's GPS data with a visual divider
• IP Details — IP address, Country (with full name lookup), Region, City, Postal code, Timezone, ISP, AS Number
• Source — Powered by ipinfo.io; your data stays local and is never stored

How GPS Data Flows

GPSLatitude and GPSLongitude populate the Add Custom Metadata fields (not the accordion) to avoid duplication. The Edit tab preview map shows a draggable marker synced with these custom fields.

Use Current Location

Fetch your browser's GPS position with a progress indicator. Coordinates are added to the custom fields and shown on the map.

AI Analysis

The AI Summary panel uses Google's Gemini API to analyze file content. This is optional and requires an API key.

Setup

1. Get a free API key from Google AI Studio
2. Open the studio Settings panel or set it via localStorage: localStorage.setItem('nx-gemini-key', 'your-key')
3. Select your model from the dropdown (Gemini 2.5 Flash / Gemini 3.5 Flash)
4. Click Summarize

Analysis Types

Follow-up Questions

After an initial analysis, click any suggested question chip or type your own. The follow-up includes the original media context so the AI can reference visual/audio content.

Metadata Editing

The Edit tab provides full control over metadata fields grouped into categories. Each field is displayed in an accordion panel.

Editing Fields

• Click any field value to edit it inline
• Date/time fields show a date picker for easy selection
• Use Add Custom Metadata to create new fields with key/value pairs
• Click Add Field to insert a blank key/value row, or click a suggested tag to auto-fill
• Use Remove Specific Metadata to delete unwanted fields by key name

GPS Custom Fields

When a file contains GPS data, GPSLatitude and GPSLongitude appear in Add Custom Metadata. Edit these to update the map marker position.

Read-Only Fields

Some fields are read-only and cannot be edited: SourceFile, FileSize, MIMEType, FileType, and similar system-generated values.

Exporting

Download Updated File

Click the download button to save your file with all metadata edits applied. The file is reconstructed client-side without any server upload.

JSON Report

Export all metadata as a structured JSON file for programmatic use or archival.

PDF Report

Generate a formatted PDF report with:

• File information header
• Metadata organized by category
• GPS map screenshot (if available)
• Professional watermarking

Theming

MetaStudio uses Material 3 expressive theming with dynamic color.

Color Themes

Contrast Levels

Each theme includes 3 contrast levels in both light and dark modes:

• Standard — light.css / dark.css
• Medium Contrast — light-mc.css / dark-mc.css
• High Contrast — light-hc.css / dark-hc.css

API Reference

The optional FastAPI backend provides extended metadata operations. Start the backend on port 3000 to enable these endpoints.

Backend URL

Configurable via Settings panel or localStorage key nx-backend-url. Defaults to http://localhost:3000.

Keyboard Shortcuts

FAQ

Is my data sent anywhere?

No. All metadata parsing happens client-side in your browser. The only exception is the optional AI Summary feature, which sends file content directly to Google's Gemini API using your own API key.

What file formats are supported?

Images: JPG, PNG, WebP, TIFF, GIF, BMP, HEIC, AVIF. Videos: MP4, MOV, AVI, MKV, WebM, M4V, 3GP. Audio: MP3, WAV, FLAC, AAC, OGG, M4A, OPUS, WMA.

What metadata standards are supported?

EXIF, IPTC, XMP, JFIF, QuickTime, and generic file metadata (dates, dimensions, format details).

Do I need the ExifTool backend?

No. The built-in parser handles most common formats. The ExifTool backend provides deeper extraction for RAW camera files, additional embedded metadata, and more precise write operations.

How do I get a Gemini API key?

Visit Google AI Studio, sign in, and create an API key. Paste it into the Studio's Settings panel or set localStorage.setItem('nx-gemini-key', 'your-key').

Is there a file size limit?

The client-side parser handles files up to 500 MB. The ExifTool backend may have additional limits depending on deployment. For AI audio analysis, files over 10 MB fall back to metadata-only analysis.

Can I edit GPS coordinates?

Yes. GPS coordinates appear in the Add Custom Metadata fields. Edit the Latitude/Longitude values and the map marker updates automatically. You can also drag the marker on the Edit tab map.

What is the "Your IP Geolocation" section in the GPS panel?

It shows your current internet connection's IP address and location (country, city, ISP) via ipinfo.io. This is separate from the file's GPS data — both are displayed in the same panel with a divider, so you can compare the file's capture location with your own connection location.

How do I reset a field?

Clear the field's input value and save. For complete removal, use Remove Specific Metadata and enter the exact key name.