Skip to content

UndercodeUtilities/imagesilencer

Repository files navigation

ImageSilencer - Advanced Image Metadata Protection & Cleaning Tool

ImageSilencer


Advanced GUI/CLI tool to hide, extract, strip, and add fake image metadata for ultimate privacy protection

πŸš€ Overview

ImageSilencer is a comprehensive image metadata manipulation tool designed for privacy-conscious users, security researchers, and photographers. It provides real-time folder monitoring and advanced metadata operations to protect against image-based tracking and telemetry.

✨ Features

πŸ”’ Core Protection Features

  • πŸ›‘οΈ Real-time Folder Monitoring - Continuous protection against metadata tracking
  • πŸ” Metadata Extraction - Complete EXIF, XMP, and IPTC data analysis
  • 🧹 Smart Stripping - Remove all metadata while preserving image quality
  • 🎭 Fake Metadata Injection - Add plausible fake data to mislead tracking
  • 🚫 C2PA/JUMBF Removal - Eliminate advanced content provenance data
  • 🧼 Deep Cleaning - Multi-layer metadata eradication

🎯 Advanced Operations

  • πŸ“ Batch Processing - Process entire folders with one click
  • πŸ–₯️ Dual Interface - GUI (Zenity) & CLI for all experience levels
  • 🌈 Live Preview - Real-time metadata before/after comparison
  • ⚑ Multi-Format Support - JPG, JPEG, PNG, GIF, TIFF
  • πŸ”§ Custom Workflows - Create and save processing pipelines

πŸ›‘οΈ Security Features

  • πŸ“Š Logging & Auditing - Complete operation history
  • πŸ”„ Backup Protection - Automatic original file preservation
  • 🎯 Targeted Cleaning - Vendor-specific metadata removal
  • 🚨 Alert System - Notifications for tracking attempts

πŸ›  Installation

🐧 Linux Installation

One-Command Install

cd /tmp && git clone https://github.com/undercodeutilities/imagesilencer.git && cd imagesilencer && bash install

Alternative Methods

Quick Install (Zip)
wget -c https://github.com/undercodeutilities/imagesilencer/archive/main.zip -O imagesilencer.zip \
  && unzip imagesilencer.zip \
  && cd imagesilencer \
  && bash install

Git Clone

git clone https://github.com/undercodeutilities/imagesilencer.git
cd imagesilencer
bash install

πŸͺŸ Windows Installation

πŸ“₯ Download Latest Release

Windows Executable

  1. Download ImageSilencer_Setup.exe from releases
  2. Run the installer
  3. Launch from Start Menu or Desktop

Portable Version

# Download portable version
wget https://github.com/undercodeutilities/imagesilencer/releases/latest/download/ImageSilencer_Portable.zip
unzip ImageSilencer_Portable.zip
cd ImageSilencer_Portable
ImageSilencer.exe

⚑ Quick Start

Prerequisites

  • Linux: exiftool, imagemagick, zenity (automatically installed)
  • Windows: All dependencies included in installer
  • Permissions: Read/write access to target folders

First Run

# After installation, run the tool
sudo u_imagesilencer

Quick Alias (Add to ~/.bashrc)

alias isil='sudo u_imagesilencer'

🎯 Usage Guide

πŸ–±οΈ Interactive Mode (Recommended)

  1. Run the tool: u_imagesilencer
  2. Select operation: Choose from intuitive menu
  3. Pick files/folders: Use GUI file browser or CLI navigation
  4. Configure output: Customize naming and location
  5. Execute: Watch real-time progress with spinner

⌨️ Command Line Mode

Single File Operations

# Hide metadata
u_imagesilencer -i image.jpg -s

# Extract metadata
u_imagesilencer -i image.jpg -e

# Strip all metadata
u_imagesilencer -i image.jpg -x

# Flatten & strip
u_imagesilencer -i image.jpg -r

# Remove C2PA/JUMBF
u_imagesilencer -i image.jpg -c

# Deep clean all
u_imagesilencer -i image.jpg -d

# Add fake metadata
u_imagesilencer -i image.jpg -k

Batch Operations

# Hide metadata in all images in folder
u_imagesilencer -f /path/to/folder -s

# Extract metadata from all images
u_imagesilencer -f /path/to/folder -e

# Add fake metadata to all images
u_imagesilencer -f /path/to/folder -k

πŸŽͺ Operation Types

Operation Description Use Case
Hide Replace metadata with neutral data Basic privacy
Extract View all metadata without modification Forensics
Strip Remove all metadata completely Maximum privacy
Flatten Convert and strip all data Social media
C2PA Remove Target advanced provenance data Content authenticity
Deep Clean Multi-layer complete removal Anti-forensics
Fake Inject plausible fake metadata Misinformation

πŸ“ File Structure

imagesilencer/
β”œβ”€β”€ install                    # Installation script
β”œβ”€β”€ u_imagesilencer           # Main executable script
β”œβ”€β”€ deep_clean_app.py         # Deep clean application
β”œβ”€β”€ create_icon.py            # Icon creation utility
β”œβ”€β”€ build_installer.bat       # Windows installer builder
β”œβ”€β”€ ImageSilencer.spec        # PyInstaller specification
β”œβ”€β”€ DeepClean.spec            # Deep clean app spec
β”œβ”€β”€ clean_icon.ico            # Application icon
β”œβ”€β”€ installer.nsi             # NSIS installer script
β”œβ”€β”€ requirements.txt          # Python dependencies
β”œβ”€β”€ README.md                 # This documentation
β”œβ”€β”€ LICENSE                   # MIT License
β”œβ”€β”€ build/                    # Build directory
β”œβ”€β”€ dist/                     # Distribution files
└── tools/                    # Additional utilities

πŸ— System Architecture

graph TD
    CORE["ImageSilencer Core"] --> GUI["GUI Interface"]
    CORE --> CLI["CLI Interface"]
    CORE --> MONITOR["Folder Monitor"]
    
    GUI --> ZENITY["Zenity Dialogs"]
    GUI --> PROGRESS["Progress Indicators"]
    
    CLI --> INTERACTIVE["Interactive Mode"]
    CLI --> BATCH["Batch Mode"]
    
    MONITOR --> REALTIME["Real-time Protection"]
    MONITOR --> SCHEDULED["Scheduled Scans"]
    
    ENGINE["Processing Engine"] --> EXIFTOOL["EXIF Operations"]
    ENGINE --> IMAGEMAGICK["Image Conversion"]
    ENGINE --> METADATA["Metadata Analysis"]
    
    EXIFTOOL --> HIDE["Hide Data"]
    EXIFTOOL --> EXTRACT["Extract Data"]
    EXIFTOOL --> STRIP["Strip Data"]
    EXIFTOOL --> FAKE["Fake Data"]
    
    IMAGEMAGICK --> FLATTEN["Flatten Images"]
    IMAGEMAGICK --> CONVERT["Format Conversion"]
Loading

πŸ”§ Configuration

Default Settings

  • Log Location: ~/image_silencer.log
  • Output Format: {operation}_{original_filename}
  • Backup Files: Original preservation enabled
  • GUI Mode: Auto-detect based on environment

Customization

Edit these variables in u_imagesilencer:

LOGFILE="${HOME}/image_silencer.log"  # Change log location
DEFAULT_OUTPUT="./processed"          # Change default output
ENABLE_BACKUP=true                   # Toggle backup creation

πŸ› Troubleshooting

Common Issues

# Check system compatibility
sudo u_imagesilencer --check

# Verify dependencies
exiftool -ver
convert -version
zenity --version

# View operation log
tail -f ~/image_silencer.log

# Reset configuration
rm ~/.config/image_silencer.conf

Dependency Installation

The install script handles dependencies automatically:

# Ubuntu/Debian (manual install)
sudo apt update && sudo apt install libimage-exiftool-perl imagemagick zenity

# CentOS/RHEL
sudo yum install perl-Image-ExifTool ImageMagick zenity

# Windows: All included in installer

πŸ“Š Output Examples

Live Processing

🎨 [PROCESSING IMAGE] Input: vacation.jpg
🧹 [DEEP CLEANING] Removing all metadata layers...
βœ… Saved (deep cleaned): silenced_vacation.jpg
πŸ“Š [METADATA REMOVED] 15 EXIF tags, 3 XMP fields, 1 ICC profile

Batch Operations

πŸ”„ [BATCH PROCESSING] Folder: /home/user/Photos
πŸ“ [FOUND] 47 images to process
🎯 [OPERATION] Adding fake metadata...
πŸ“Š [PROGRESS] 15/47 completed (32%)
βœ… [COMPLETED] 47 files processed in 12.3 seconds

⚠️ Legal & Ethical Usage

  • Authorized Use Only - Only process images you own or have permission to modify
  • Educational Purpose - For privacy research and authorized security testing
  • Data Responsibility - Handle extracted metadata ethically and securely
  • Legal Compliance - Follow local privacy and copyright laws
  • Responsible Disclosure - Report vulnerabilities responsibly

πŸ“‘ Stay Connected

WhatsApp Telegram

πŸ“œ Licensing

This project is licensed under the MIT License.

MIT License

πŸ’ Support Our Work

If ImageSilencer protects your privacy, consider supporting development:

Buy Me a Coffee

🌐 Connect With Us

GitHub badge

πŸ“š Resources


⚠️ Disclaimer: This tool is intended for educational purposes, privacy protection, and authorized security testing. Always ensure you have proper rights to modify images. The developers are not responsible for misuse.

Join Our Community: Undercode.help/Community


For advanced usage and automation, refer to the inline help with u_imagesilencer -h

About

ImageSilencer - Advanced image metadata protection with real-time folder monitoring & automatic tracking prevention

Resources

License

Stars

Watchers

Forks

Packages

No packages published