Skip to content

Simple, lightweight metadata removal tool supporting multiple media filetypes that can be ran on Windows, MacOS, and Linux

License

Notifications You must be signed in to change notification settings

RPxGoon/MetaClean

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MetaClean

A simple, lightweight, and fast metadata removal tool designed to support multiple file types across Windows, macOS, and Linux. Screenshot 2025-04-08 at 1 00 35 PM

Features

  • Cross-Platform Support: Runs seamlessly on Windows, macOS, and Linux
  • Modern GUI: Clean, intuitive interface built with Tkinter
  • Batch Processing: Clean multiple files or entire folders at once
  • Live Console: Real-time progress tracking and detailed logs
  • Secure Processing: Files are processed locally with no data transmission
  • Fast Processing: Leverages FFmpeg for efficient metadata removal

Supported File Types

Video Formats

  • MP4 (.mp4)
  • Matroska (.mkv)
  • AVI (.avi)
  • QuickTime (.mov)
  • Flash Video (.flv)
  • WebM (.webm)

Image Formats

  • PNG (.png)
  • JPEG (.jpg, .jpeg)
  • GIF (.gif)
  • Bitmap (.bmp)
  • TIFF (.tiff)

Requirements

  • Python 3.6+
  • FFmpeg (automatically installed for Windows & macOS users)

Installation

  1. Clone the Repository
git clone https://github.com/yourusername/MetaClean.git
cd MetaClean
  1. Install Dependencies
python setup.py

Usage

  1. Launch the Application
python metaclean.py
  1. Select Files
    • Use "SELECT FILE" for single file processing
    • Use "SELECT FOLDER" for batch processing
    • Click "CLEAN" to begin metadata removal
    • Monitor progress in the console (toggle with console button)

How It Works

MetaClean utilizes FFmpeg to safely remove metadata while preserving file content through:

  1. Creating a temporary working copy
  2. Stripping all metadata using FFmpeg
  3. Replacing the original with the cleaned version
  4. Automatic cleanup of temporary files

Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/NewFeature)
  3. Commit your changes (git commit -m 'Add NewFeature')
  4. Push to the branch (git push origin feature/NewFeature)
  5. Open a Pull Request

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.


Made with ❤️ by [RPxGoon]

About

Simple, lightweight metadata removal tool supporting multiple media filetypes that can be ran on Windows, MacOS, and Linux

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages