N8N Tools - File Converter

Convert between various file formats with this comprehensive N8N community node. Supports conversion between documents, images, audio, video, and spreadsheet formats through the N8N Tools platform.

✨ Features

• 📄 Document Conversion: Convert between PDF, DOCX, TXT, RTF, HTML, MD formats
• 🖼️ Image Processing: Convert between JPG, PNG, GIF, BMP, TIFF, WEBP formats
• 🎵 Audio Conversion: Convert between MP3, WAV, FLAC, AAC, OGG formats
• 🎥 Video Processing: Convert between MP4, AVI, MOV, WMV, FLV, MKV formats
• 📊 Spreadsheet Support: Convert between XLSX, XLS, CSV formats
• ⚡ Batch Processing: Convert multiple files in a single operation
• 🗜️ File Optimization: Reduce file sizes while maintaining quality
• 📥 Multiple Input Sources: Support for Binary data, URLs, and Base64 strings
• 🔒 Secure Processing: API key authentication with your N8N Tools account

🚀 Quick Start

Installation

Install this node in your N8N instance:

Via Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your N8N interface
2. Click Install a community node
3. Enter n8n-nodes-n8ntools-file-converter
4. Click Install

Via npm

npm install n8n-nodes-n8ntools-file-converter

Setup Credentials

1. Sign up at N8N Tools and get your API key
2. In N8N, create new N8N Tools API credentials
3. Enter your API URL: https://api.n8ntools.io
4. Enter your API key

📋 Available Operations

🔄 Convert Format

Convert individual files between supported formats with quality control.

Supported Formats (25+):

• Documents: PDF, DOCX, TXT, RTF, HTML, MD
• Images: JPG, PNG, GIF, BMP, TIFF, WEBP
• Audio: MP3, WAV, FLAC, AAC, OGG
• Video: MP4, AVI, MOV, WMV, FLV, MKV
• Spreadsheets: XLSX, CSV

📦 Batch Convert

Process multiple files simultaneously with ZIP output containing all converted files.

🗜️ Optimize File

Reduce file size while maintaining quality with configurable compression levels.

💡 Usage Examples

Single File Conversion

Convert a PDF document to DOCX format:

// Configuration
Operation: "Convert Format"
Input Source: "Binary File"
Binary Property: "data"
Target Format: "docx"
Quality Settings: "high"

// Output
{
  "operation": "convertFormat",
  "success": true,
  "fileName": "document.docx",
  "fileSize": 245760,
  "mimeType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

Batch Image Conversion

Convert multiple images from PNG to WEBP:

// Configuration  
Operation: "Batch Convert"
Input Source: "Binary Files"
Binary Properties: "image1,image2,image3"
Target Format: "webp"
Quality Settings: "medium"

// Output
{
  "operation": "batchConvert",
  "success": true,
  "processedFiles": 3,
  "zipFileName": "batch_converted.zip",
  "totalSize": 1048576,
  "timestamp": "2024-01-15T10:30:00.000Z"
}

File Optimization

Reduce PDF file size while maintaining readability:

// Configuration
Operation: "Optimize File" 
Input Source: "URL"
File URL: "https://example.com/large-document.pdf"
Compression Level: "high"
Advanced Options: {
  "removeMetadata": true
}

// Output
{
  "operation": "optimizeFile",
  "success": true,
  "originalSize": 5242880,
  "optimizedSize": 1048576,
  "compressionRatio": "80%",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

⚙️ Configuration Options

Input Sources

• Binary File: Process files from N8N binary data
• URL: Convert files directly from web URLs
• Base64: Process Base64 encoded file content

Quality Settings

• High: Maximum quality preservation
• Medium: Balanced quality and file size (default)
• Low: Smaller files with reduced quality

Advanced Options

• Password: Handle password-protected files
• Overwrite: Control file replacement behavior
• Remove Metadata: Strip metadata during optimization

🔧 API Endpoints

| Operation | Endpoint | Method | |-----------|----------|---------| | Convert Format | /api/v1/file-converter/convert | POST | | Batch Convert | /api/v1/file-converter/batch | POST | | Optimize File | /api/v1/file-converter/optimize | POST |

📊 Supported File Formats

Documents

• PDF - Portable Document Format
• DOCX - Word Document
• TXT - Plain Text
• RTF - Rich Text Format
• HTML - HyperText Markup Language
• MD - Markdown

Images

• JPG/JPEG - Joint Photographic Experts Group
• PNG - Portable Network Graphics
• GIF - Graphics Interchange Format
• BMP - Bitmap Image
• TIFF - Tagged Image File Format
• WEBP - Web Picture format

Audio

• MP3 - MPEG Audio Layer III
• WAV - Waveform Audio File Format
• FLAC - Free Lossless Audio Codec
• AAC - Advanced Audio Coding
• OGG - Ogg Vorbis

Video

• MP4 - MPEG-4 Video
• AVI - Audio Video Interleave
• MOV - QuickTime Movie
• WMV - Windows Media Video
• FLV - Flash Video
• MKV - Matroska Video

Spreadsheets

• XLSX - Excel Spreadsheet
• CSV - Comma Separated Values

🛠️ Example Workflows

Document Processing Pipeline

[HTTP Request] → [File Converter] → [Save to S3] → [Send Email]

Batch Image Processing

[Watch Folder] → [File Converter] → [Optimize Images] → [Upload to CDN]

PDF Report Generation

[Database Query] → [Generate HTML] → [File Converter] → [Archive PDF]

🔍 Troubleshooting

Common Issues

File Size Limits

• Maximum file size: 100MB per file
• Batch operations: Up to 20 files per request

Unsupported Formats

• Check the supported formats list above
• Some proprietary formats may not be supported

Quality vs File Size

• Use "high" quality for documents and presentations
• Use "medium" or "low" for web images and social media

📈 Performance Tips

1. Batch Processing: Use batch convert for multiple files of the same type
2. Quality Selection: Choose appropriate quality level for your use case
3. Compression: Enable optimization for web-ready files
4. Format Selection: Choose modern formats (WEBP, MP4) for better compression

🆘 Support

• Documentation: docs.n8ntools.io
• API Reference: api.n8ntools.io/docs
• Community: Discord

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ by N8N Tools