A simple file change tracker with a browser-based GUI (Developed for Linux. Might work in Windows too)
FileSporger scans a directory, records the modification timestamps of all files and subdirectories, and lets you compare two scans to see exactly what changed between them.
Zero dependencies — runs on pure Python 3 standard library. No pip install needed.
I made this simple tool because iam pretty new to using github and iam working on a pretty big project that is based on another repo which recently has had big updates(upstream) so i totally lost control over which file was edited, what was changed, what do i have to change for it to keep working and so on, this makes it all a lot easier. There is probably already tools for this, but this is just really simple and does just what it says it does!
When you maintain a fork of an open source project and pull in upstream changes using "keep their version" during a merge, Git replaces your files silently. You're left wondering:
"Which files did they actually change? What do I need to review and re-apply my customizations to?"
Open source projects often touch dozens of files at different times, making timestamps inconsistent and hard to compare manually. FileSporger solves this by taking a before snapshot, letting you do your merge, then taking an after snapshot — and showing you a clear, filterable list of exactly what changed.
- 📸 Two-scan workflow — scan before and after any operation
- 🔍 Compare scans — see modified, added, and deleted files at a glance
- 💾 Save & load scans — store snapshots as JSON and reuse them across sessions
- 🗂️ Native folder picker — uses your OS file dialog (via tkinter)
- ✏️ Inline diff viewer — see line-by-line changes for text files (opt-in)
- 🔎 Filter & search — filter by status (modified / added / deleted) or search by filename
- 🌙 Dark & light theme — toggle in the top right corner
- ⚡ No installation — just Python 3, nothing else
# Clone or download filesporger.py, then simply run:
python3 filesporger.pyOpens automatically in your browser at http://localhost:5757.
Press CTRL+C in the terminal to stop.
Requirements: Python 3.8+ with tkinter (included by default on most Linux distros).
If tkinter is missing:
sudo apt install python3-tk- Before pulling upstream changes, open FileSporger
- Select your project folder → click ⚡ Skann nå in Scan 1
- Run your
git merge,git pull, or any other operation - Select the same folder in Scan 2 → click ⚡ Skann nå
- Click 🔍 Compare scans → review what changed
- Use the "Kun endrede" filter to focus only on modified files
Check "Lagre filinnhold for diff-visning" before scanning. After comparing, click ⬛ Vis diff on any modified text file to see exactly what lines changed.
You can save a scan to a .json file and reload it later.
This is useful when you want to:
- Compare across multiple sessions
- Share a snapshot with a teammate
- Keep a record of a project's state at a specific point in time
(Add screenshot here)
MIT — see LICENSE
Pull requests welcome! Some ideas for improvements:
- Git integration (auto-detect repo, show
git diff) - Ignore patterns (
.gitignoresupport) - Export changed file list to clipboard or text file
- Windows/macOS support