Skip to content

Remove metadata from images, videos, and audio files with ease. Use our command-line tool for safe copying or direct overwriting. 🖼️🎵

License

Notifications You must be signed in to change notification settings

knovov/metadata-remover

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

Metadata Remover: Securely Remove Metadata from Media Files 🗑️🔒

GitHub release GitHub issues GitHub stars GitHub forks

Overview

Metadata Remover is a straightforward tool designed to help you eliminate all traceable metadata from your media files. Whether you want to protect your privacy or ensure that your files are free from unwanted information, this tool is for you. It resets timestamps and rechecks the file using ExifTool and FFmpeg, ensuring thorough cleaning.

Key Features

  • Comprehensive Metadata Removal: Removes all types of metadata from various media formats.
  • Reset Timestamps: Resets creation and modification timestamps to prevent tracking.
  • Dual Modes: Operate in safe mode or choose in-place overwrite for efficiency.
  • Compatibility: Works with popular media formats and is compatible with ExifTool and FFmpeg.

Installation

To get started with Metadata Remover, you need to download the latest release. Visit the Releases section to find the appropriate file for your operating system. Download and execute the file to install the tool.

Requirements

Usage

Basic Commands

Once installed, you can use the Metadata Remover via the command line. Here are some basic commands to get you started:

Remove Metadata

To remove metadata from a single file:

metadata-remover remove <path-to-your-file>

Remove Metadata in Safe Mode

To run the tool in safe mode, use:

metadata-remover remove --safe <path-to-your-file>

Overwrite Metadata

To overwrite the existing file with cleaned data:

metadata-remover remove --overwrite <path-to-your-file>

Batch Processing

You can also remove metadata from multiple files at once:

metadata-remover remove --batch <path-to-your-files-directory>/*

Reset Timestamps

To reset timestamps for a file:

metadata-remover reset-timestamps <path-to-your-file>

Example Usage

Here’s an example of how to use the tool effectively:

  1. Remove Metadata:

    metadata-remover remove my_video.mp4
  2. Check Metadata: After cleaning, you can verify that the metadata has been removed:

    exiftool my_video.mp4
  3. Batch Process: Clean multiple files in one go:

    metadata-remover remove --batch /path/to/media/*

Configuration

You can customize the tool's behavior by modifying the configuration file located in the installation directory. Adjust settings such as default modes and file handling preferences.

Configuration Options

  • Default Mode: Set your preferred mode (safe or overwrite).
  • Log Level: Choose the level of logging you want (info, warning, error).
  • File Types: Specify which file types to process by default.

Supported File Formats

Metadata Remover supports a variety of media formats, including:

  • Images: JPEG, PNG, TIFF, BMP
  • Audio: MP3, WAV, FLAC, AAC
  • Video: MP4, AVI, MKV, MOV

Privacy and Security

In today’s digital world, protecting your privacy is crucial. Metadata can reveal sensitive information, such as location data and device details. By using Metadata Remover, you take a proactive step in safeguarding your personal information.

Why Remove Metadata?

  • Privacy Protection: Prevent unwanted tracking and information leakage.
  • Data Security: Ensure that sensitive information does not fall into the wrong hands.
  • Compliance: Meet privacy regulations by removing identifiable information.

Troubleshooting

If you encounter issues while using Metadata Remover, consider the following solutions:

  • Ensure Dependencies are Installed: Check that ExifTool and FFmpeg are correctly installed and accessible in your system's PATH.
  • Check File Permissions: Make sure you have the necessary permissions to read and write files.
  • Consult Logs: Review the logs for any error messages that can help diagnose the problem.

Common Issues

  • File Not Found: Ensure the file path is correct.
  • Permission Denied: Run the command with elevated privileges if necessary.
  • Dependency Errors: Verify that ExifTool and FFmpeg are installed and updated.

Contributing

We welcome contributions to improve Metadata Remover. If you want to contribute, please follow these steps:

  1. Fork the Repository: Click the "Fork" button at the top right of the page.
  2. Clone Your Fork: Clone your forked repository to your local machine.
    git clone https://github.com/your-username/metadata-remover.git
  3. Create a Branch: Create a new branch for your feature or bug fix.
    git checkout -b feature-name
  4. Make Changes: Implement your changes and commit them.
    git commit -m "Description of your changes"
  5. Push Changes: Push your changes to your fork.
    git push origin feature-name
  6. Create a Pull Request: Go to the original repository and create a pull request.

License

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

Acknowledgments

Thanks to the developers of ExifTool and FFmpeg for their invaluable tools that make this project possible. Your work has enabled countless users to manage their media files effectively.

Links

For more information and updates, check the Releases section for the latest versions and features.

Contact

For questions or support, please reach out via the GitHub Issues page or contact the maintainers directly.


This README provides a comprehensive overview of the Metadata Remover tool, detailing its features, usage, and contribution guidelines. For any further inquiries or assistance, feel free to explore the documentation or reach out to the community.