Skip to content

victormeloasm/frogglass

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🐸 FrogGlass

The All-Seeing Frog of EXIF β€” Pure Python Metadata Inspector & Cleaner

Python PyQt6 License Status Platform


πŸͺΆ Overview

FrogGlass is a modern open-source desktop application designed for those who care about privacy, transparency, and control over their images.
It allows you to inspect, visualize, and completely remove metadata (EXIF, XMP, IPTC, GPS, ICC, MakerNotes, and more) β€” all through a friendly, frog-themed interface.

No dependencies on exiftool.exe, no external binaries β€” 100% pure Python powered by PyQt6.
Just you, your images, and a wise frog with a magnifying glass. πŸΈπŸ”


πŸ–ΌοΈ Branding & Assets

Type File Purpose
🧩 Icon assets/FrogGlass.ico Used in the executable (PyInstaller)
🐸 Logo assets/logo.png Official FrogGlass logo
πŸ“Έ Screenshot assets/wk.png Example of the application in action

πŸ’š FrogGlass Logo

FrogGlass Logo

πŸͺŸ Screenshot

FrogGlass Logo


✨ Features

  • πŸ“· Reads all metadata: EXIF, XMP, IPTC, ICC, MakerNotes, GPS, comments, thumbnails, etc.
  • πŸ—ΊοΈ GPS Map View β€” see where your photo was taken, directly on an interactive map.
  • 🧭 Reverse Geocoding β€” automatically resolve coordinates into a real-world location.
  • πŸ’£ Strict Metadata Wipe (NUKE Mode) β€” total cleanup, zero traces left.
  • 🧹 Clean Mode β€” removes common EXIF safely while preserving the image.
  • 🧩 Batch Operations β€” select multiple images, clean or export them at once.
  • πŸͺŸ Drag & Drop Support β€” drop images or folders directly into the window.
  • πŸ”„ Auto-Refresh and Persistent List State between sessions.
  • βš™οΈ Preferences Panel β€” customize your defaults:
    • β€œClean in-place” or copy mode
    • Verify after NUKE
    • Open reports automatically after save
  • πŸ“¦ Export Metadata to JSON or HTML reports.
  • πŸ“Š Progress Bar for all heavy operations.
  • πŸŒ— Automatic dark/light theme integration with your OS.
  • 🧠 Fully cross-platform β€” works on Windows, macOS, and Linux.

🧰 Tech Stack

Component Technology
Language Python 3.12+
GUI PyQt6
Image Handling Pillow, piexif
Metadata Parsing lxml, xmltodict
Mapping folium, geopy
Build System PyInstaller

πŸ’Ύ Installation

Clone and install dependencies:

git clone https://github.com/<your-user>/FrogGlass.git
cd FrogGlass
pip install -r requirements.txt
python FrogGlass.py

πŸ”§ Requirements File

PyQt6>=6.6.0
Pillow>=10.2.0
piexif>=1.1.3
folium>=0.16.0
lxml>=5.2.1
xmltodict>=0.13.0
geopy>=2.4.1

🧩 Building a Standalone Executable

You can easily compile FrogGlass into a single .exe file for Windows. All assets (logo.png, wk.png, FrogGlass.ico) are stored inside the assets directory.

🐸 Simple Build Command

pyinstaller --noconfirm --windowed --onefile --icon=assets/FrogGlass.ico FrogGlass.py

This produces:

dist\FrogGlass.exe

The result is a single executable file that can run on any system with no dependencies. You can compress it as a .zip for sharing or publication.


🧭 Usage Guide

πŸ” Inspecting Metadata

  1. Launch FrogGlass.
  2. Drag one or multiple image files into the main window.
  3. Click an image to view all EXIF data.
  4. If the image contains GPS info, press Map to open an interactive view.

🧹 Cleaning / Nuking

  • Clean EXIF β†’ Safe removal (preserves thumbnails, color profiles).
  • Nuke Metadata (strict) β†’ Absolute wipe β€” leaves nothing but the raw image.

πŸ“„ Exporting

  • Export JSON β†’ Full metadata in structured format.
  • HTML Report β†’ Beautifully formatted metadata viewer.
  • You can also export for multiple selected files.

βš™οΈ Preferences

FrogGlass saves your preferences to:

~/.frogglass_state.json

These include:

  • Default cleaning behavior
  • Verification rules
  • Report auto-open setting

🎨 Design Philosophy

FrogGlass was built to be educational, beautiful, and safe:

  • No files ever leave your computer.
  • No remote connections or telemetry.
  • Every operation is transparent and reversible.
  • The frog is curious, not creepy. πŸΈπŸ”

It’s a digital magnifying glass that respects your privacy while revealing the truth hidden inside your photos.


πŸ§™β€β™‚οΈ Author

VΓ­ctor Duarte Melo Independent Researcher β€” Cryptography, Mathematics & Software Engineering Creator of: ECCFrog, KyFrog, FrogPack, and now FrogGlass

πŸ“« GitHub β€’ LinkedIn


πŸ“œ License

Licensed under the MIT License. Free for personal, academic, and commercial use.

Copyright (c) 2025 VΓ­ctor Duarte Melo
Permission is hereby granted, free of charge, to any person obtaining a copy of this software...

🌈 Acknowledgments

  • 🐍 The Python open-source community.
  • β˜• Countless late-night coffees.
  • 🐸 And the spirit of the Frog Mage, forever peering through the glass of truth.

β€œThe eyes of the frog see what others ignore.” – Anonymous Amphibian

⭐ Support the Project

If you like FrogGlass, consider giving it a ⭐ on GitHub β€” it really helps visibility! Spread the word, protect your privacy, and keep your EXIFs clean. πŸ’šπŸΈ

About

🐸 FrogGlass β€” Powerful EXIF Inspector & Cleaner FrogGlass is a modern, open-source Python application that lets you view, explore, map, and completely wipe EXIF metadata from images. Built with PyQt6, it offers a friendly GUI for both casual users and privacy-focused professionals.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages