Skip to content

README.md

Latest commit

 

History

History
95 lines (64 loc) · 3.88 KB

README.md

File metadata and controls

95 lines (64 loc) · 3.88 KB


💾 About The Project

Metadata Editor

The Metadata Editor is a GUI-based tool designed to view and edit metadata for both files and folders. It provides a convenient interface for modifying standard file properties and leverages system capabilities to customize folder attributes like comments (InfoTips) and tags.

Built by: Zachary Whiteman & Google Gemini Ai.

(back to top)

🔰 Getting Started

This tool helps you organize and tag your files and folders.

🕰️ Prerequisites

To run this script, you will need:

  • Windows Operating System.
  • PowerShell 5.1 or newer.
  • .NET Framework: Required for the Windows Forms GUI.

💽 Installation & Execution

  1. Download: Download the MetaData Editor Tool.ps1 script file.
  2. Unblock: Right-click the file, go to Properties, and click Unblock.
  3. Run: Execute the script from a PowerShell console. 
    .\MetaData Editor Tool.ps1

(back to top)

🚀 Usage

The application features a dynamic interface for editing properties.

  1. Select Item: Choose a file or folder to edit.
  2. Edit File Metadata: For files, you can modify standard properties like Title, Subject, Authors, and media-specific tags like Artist and Album. The tool uses the Windows Shell to access these extended properties.
  3. Edit Folder Metadata: For folders, the tool allows you to set a custom "InfoTip" (which appears as a comment when hovering) and tags. It achieves this by creating or modifying the desktop.ini file within the folder.
  4. Save: Apply your changes to write the metadata back to the item.

(back to top)

✨ Key Features

  • Unified Interface: Handle both file and folder metadata in one tool.
  • Folder Customization: Easily add comments to folders using desktop.ini manipulation.
  • Extensive Properties: Supports a wide range of file properties including details for documents, music, and images.
  • Dynamic UI: The property editing grid is generated dynamically based on the selected item type.
  • Safe Handling: Reads and writes desktop.ini files carefully to preserve existing system attributes.

(back to top)

🛠️ Technology Stack

  • Scripting Language: PowerShell 5.1+
  • GUI Framework: .NET Windows Forms (WinForms).
  • COM Object: Shell.Application for accessing file extended properties.
  • System: desktop.ini file manipulation for folder customization.

(back to top)

📐 Architecture & Security Notes

  • System Files: When customizing folders, the script creates a hidden, system-marked desktop.ini file inside the folder. This is standard Windows behavior for folder customization.
  • COM Interaction: The script relies on the Windows Shell COM object, ensuring compatibility with how Windows Explorer sees metadata.

(back to top)

🪪 License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

☎️ Contact

Zach Whiteman - elitesoftwarecolimited@gmail.com

HuggingFace - https://huggingface.co/EliteSoftware

HuggingFace (Personal) - https://huggingface.co/TheShadyRainbow

LinkTree - https://linktr.ee/zachrainbow

Patreon - https://www.patreon.com/c/EliteSoftwareCo

(back to top)