Messy-Little-Gadgets is a growing collection of miscellaneous Python scripts and tools. Each script is self-contained and solves a simple, practical problem.

🧩 Included Tools

🌳 Directory Tree Analyzer — `directory_tree_analyzer.py`

Analyze a directory with a detailed tree view and rich statistics.

🌳 Recursive colored directory tree
📊 File/dir count, total size
📁 Extension stats (Top 15 with size & percentage)
📂 Depth distribution (per-level bar charts)
📦 Size bucket distribution (<1KB ~ >1GB)
🐘 Top 15 largest files
🕳️ Deepest directories

python directory_tree_analyzer.py

📊 Resource Monitor — `resource_monitor.py`

Monitor the Top 10 memory & CPU consumers, refreshing every 30 seconds.

🔝 Memory Top 10 & CPU Top 10 (process / PID / usage / bar)
💾 Total memory, CPU usage, core counts
🎨 Color-coded usage bars

python resource_monitor.py

🔍 Port Checker — `port_checker.py`

Check whether a port is occupied, find the occupying process, and optionally force-kill it.

🛡️ UAC elevation (run as admin)
🔍 Detect port occupancy (bulk query: 80, 443, 8000-8010)
🕵️ Find occupying process (name / PID / command line)
💀 Force-kill the process (with confirmation)
🚫 System-critical process protection

python port_checker.py

🔄 Directory Sync — `directory_sync.py`

A universal directory synchronization tool.

🔁 One-way / Two-way sync modes
🔍 MD5-based change detection
⏱️ Periodic checking (default 5s)
⚙️ Manual input or env vars configuration (DIRSYNC_SRC/DST/MODE/INTERVAL)

🎵 Music Downloader — `music_downloader.py`

A simple Tkinter GUI tool to search and download music from an online source.

🔍 Search songs by keyword
⬇️ Download a song by its ID
🔥 Hot songs list browsing
📂 Custom save path via file dialog

🔐 Argon2 Password Hasher — `argon2_password_hasher.py`

A secure password hashing utility using Argon2id (2025 recommended parameters).

🧂 Auto salt generation
💾 Hash passwords (Argon2id format)
✔️ Verify passwords
🔄 Rehash check for parameter updates

📁 Project Structure

Messy-Little-Gadgets/
├── directory_tree_analyzer.py   # Directory tree analyzer
├── resource_monitor.py          # Memory/CPU Top 10 monitor
├── port_checker.py              # Port occupancy checker
├── directory_sync.py            # Directory sync tool
├── music_downloader.py          # Music download GUI tool
├── argon2_password_hasher.py    # Argon2 password hasher
├── image_resolution_scanner.py  # Image resolution scanner
└── README.md                    # This document

📄 License

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

🙏 Note

Each gadget is independent and minimal. More little tools will be added over time. Feel free to use them in your own projects.

README.md

🧰 Messy-Little-Gadgets

🧩 Included Tools

🌳 Directory Tree Analyzer — directory_tree_analyzer.py

📊 Resource Monitor — resource_monitor.py

🔍 Port Checker — port_checker.py

🔄 Directory Sync — directory_sync.py

🎵 Music Downloader — music_downloader.py

🔐 Argon2 Password Hasher — argon2_password_hasher.py