MotekLab Logo
MotekLab
MetaForge Home
Englishالعربية (Arabic)

Editing Metadata

The Metadata Editor displays all fields extracted from the search result or file inspection.

Fields

| Field | Description | |-------|-------------| | Title | Main title of the media | | Original Title | Original-language title (appears when search provides it) | | Year | Release year | | Description | Synopsis or plot summary | | Director | Director name (comma-separated for multiple) | | Cast | Cast members (comma-separated) | | Genres | Genre tags (comma-separated) | | Season / Episode | TV show season and episode numbers | | Poster URL | URL to poster image or extracted cover frame path |

Bidi Safety

Fields that may mix Arabic text with Latin characters or numbers are wrapped in <bdi> elements with unicode-bidi: isolate — ensuring Arabic movie titles never break the visual layout.

Cover Art

The cover image (poster) can come from several sources:

  • Auto-fetch: Downloads the poster from the search result's poster URL automatically. If no online poster is available, extracts a frame from the video using ffmpeg as fallback.

  • Browse: Click the Browse button to pick an image file from your computer.

  • Save Cover Art: In the Preview dialog, click Save Cover Art to save the current poster image to a file on your computer.

The cover is cached to ~/.cache/moteklab-metaforge/cover/ and can be cleared from Preferences → Cache. After writing tags to MP4 files, the old cover is removed and replaced with the new one. For MKV, the old cover attachment is deleted and the new one is added with proper VLC-compatible tags.

Title Localization

If a search result provides both an English title and an original title, both are stored. The Title field defaults to the English title. Use the Title Localization toggle if you prefer the Original Title as the main tag.

Per-File Rename Override

When writing tags, the file can be automatically renamed according to the output template (see the Preferences → Output tab). The rename behavior is globally controlled by the Enable renaming setting, but you can override it on a per-file basis:

  • In the file navigation area: Located between the active file name and the Next button, a 3-state cycle button toggles between ↻ AUTO (Inherit from global settings), ↻ ON (Force rename), and ✕ OFF (Force skip rename).

  • In the file queue: Each queued file has a smaller cycle button next to it (labeled AUTO / ON / OFF) acting on the same setting.

The override persists until you change it or remove the file from the queue. This is useful when you want most files to follow the global rule but need to explicitly keep or change a specific file's name.