n8n-nodes-tag-media

This is an n8n community node. It lets you read and write metadata tags to media files in your n8n workflows.

These nodes enable embedding metadata into audio files, images, PDFs, and Office documents - useful for digital asset management, media libraries, automated file organization, and content workflows.

n8n is a fair-code licensed workflow automation platform.

Installation Operations Compatibility Usage Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Additional Requirements

This package requires external tools for certain operations:

| Node | Requirement | |------|-------------| | Tag Audio File | Python 3 + mutagen | | Tag Media File | exiftool | | Tag Office Document | Python 3 + python-docx, openpyxl, python-pptx | | Read File Tags | exiftool |

Docker Installation (Recommended)

Add to your n8n Dockerfile:

# Install system dependencies
RUN apk add --no-cache python3 py3-pip exiftool

# Install Python packages
RUN pip3 install --break-system-packages mutagen python-docx openpyxl python-pptx

# Install the node package
RUN cd /usr/local/lib/node_modules/n8n && \
    npm install n8n-nodes-tag-media

Manual Installation

1. Install system dependencies:

   # Debian/Ubuntu
   apt-get install python3 python3-pip libimage-exiftool-perl
   
   # Alpine
   apk add python3 py3-pip exiftool
   
   # macOS
   brew install python exiftool

2. Install Python packages:

   pip3 install mutagen python-docx openpyxl python-pptx

3. Install the node package:

   cd ~/.n8n/nodes
   npm install n8n-nodes-tag-media

4. Restart n8n

Operations

Tag Audio File

Write metadata tags to audio files using ID3, Vorbis Comments, and MP4 atoms.

Supported file types:

| Format | Tag Standard | Extension | |--------|--------------|-----------| | WAV | RIFF INFO + ID3v2.3 | .wav | | MP3 | ID3v2.3 | .mp3 | | FLAC | Vorbis Comments | .flac | | M4A/AAC | iTunes-style MP4 atoms | .m4a, .aac | | OGG | Vorbis Comments | .ogg |

Standard fields: Title, Artist, Album Artist, Album, Year, Genre, Track Number, Disc Number, Composer, BPM, Copyright, Publisher, Comment, Lyrics

Extended properties: Additional metadata fields with dropdown selection for format-specific tags. See the Mp3tag field mapping reference for format compatibility.

Tag Media File

Write EXIF, IPTC, and XMP metadata to images and documents using exiftool.

Supported file types:

| Format | Tag Standards | Extension | |--------|---------------|-----------| | JPEG | EXIF, IPTC, XMP | .jpg, .jpeg | | PNG | XMP, IPTC | .png | | TIFF | EXIF, IPTC, XMP | .tiff, .tif | | PDF | XMP, PDF Info | .pdf | | WebP | EXIF, XMP | .webp | | GIF | XMP | .gif |

Standard fields: Title, Creator, Description, Copyright, Keywords

Extended properties: Dropdown selection for hundreds of EXIF, IPTC, XMP, PDF, and GPS tags, or specify custom exiftool tag names.

Tag Office Document

Write document properties to Microsoft Office files.

Supported file types:

| Format | Description | Extension | |--------|-------------|-----------| | Word | Microsoft Word documents | .docx | | Excel | Microsoft Excel spreadsheets | .xlsx | | PowerPoint | Microsoft PowerPoint presentations | .pptx |

Standard fields: Title, Subject, Author, Description, Keywords, Category

Extended properties: Additional document properties like Manager, Company, Version, and custom properties.

Read File Tags

Read embedded metadata from any supported file type using exiftool.

Supported file types: All formats supported by exiftool, including audio, images, video, documents, and more.

Output options:

• Include all fields
• Include only specific fields
• Exclude specific fields

Compatibility

• Minimum n8n version: 1.111.0
• Tested with: n8n 1.111.0

Platform Notes

• Docker: Recommended for easiest setup of Python and exiftool dependencies
• Windows: Requires Python and exiftool installed and available in PATH
• Linux/macOS: Install dependencies via package manager

Usage

Basic Workflow

1. Use a trigger or file input node to get your file
2. Connect to a Tag node to write metadata
3. The node outputs the modified file as binary data
4. Save or process the file further in your workflow

Example: Tag Audio Files from Database

[Database Trigger] → [HTTP Request (download file)] → [Tag Audio File] → [S3 Upload]

Example: Add Copyright to Images

[Watch Folder] → [Tag Media File (add copyright)] → [Move File]

Extended Properties

All tag nodes support extended properties for format-specific metadata:

1. Enable "Extended Properties" in the node settings
2. Click "Add Property"
3. Select a field from the dropdown or choose "Custom" to enter any tag name
4. Enter the value (supports expressions)

Resources

• n8n community nodes documentation
• exiftool documentation
• mutagen documentation
• Mp3tag field mapping

Development

Prerequisites

• Docker and Docker Compose
• Node.js v22+
• npm

Quick Start

# Install dependencies
npm install

# Build and start n8n with the custom nodes
npm run dev:docker

Then open http://localhost:5678 in your browser.

Available Scripts

| Script | Description | |--------|-------------| | npm run build | Compile TypeScript to JavaScript | | npm run dev:docker | Build and start n8n in Docker with custom nodes | | npm run dev:docker:down | Stop the Docker containers | | npm run dev:docker:logs | View container logs | | npm run dev:docker:rebuild | Rebuild and restart containers | | npm run lint | Check code for errors | | npm run lint:fix | Auto-fix linting issues | | npm test | Run tests |

Development Workflow

1. Make changes to TypeScript files in nodes/ or Python scripts in scripts/
2. Run npm run build to compile
3. Run npm run dev:docker:rebuild to restart n8n with your changes
4. Test in the n8n web UI at http://localhost:5678

License

MIT