Skip to content

Priyanshu-byte-coder/keeptrack

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

KeepTrack

KeepTrack

Smart download classifier for Chrome. Captures your "keep or toss" intent at download time — so your Downloads folder stays clean forever.

Platform MV3 License Stars Release Downloads Views Zero Telemetry

KeepTrack Product Overview

Website

Every file you download makes sense in the moment. Two weeks later, your Downloads folder is 200 files deep and you can't remember which ones matter. KeepTrack captures that decision at the exact moment you download — when you actually know the answer.

All controls in your hands — 100% free & open source, 100% local, zero telemetry.


Features

  • Smart Classification — Automatically classifies every download as Keep, Temporary, or Ambiguous using file type, filename keywords, and source domain.
  • Gentle Notifications — Only interrupts for ambiguous downloads. High-confidence decisions happen silently in the background.
  • Weekly Review — 30-second popup review of expiring temporary files. Never miss a file that matters.
  • Label Toggle — Change any file's classification between Keep, Temporary, and Ambiguous anytime from the Settings page.
  • Delete Expired Files — Delete individual files or bulk-delete all expired files directly from the popup with one click.
  • Clean Up Now — Skip the weekly wait and instantly flag all temporary files for review.
  • Dry-Run Preview — On first install, scans existing download history and shows what it would classify each file as. Nothing is moved, deleted, or touched until you activate.
  • All Downloads View — Search, filter, and manage every tracked download from the Settings page.

Demo

full.features.mp4

▶ Video not loading? Watch on YouTube


Installation — Give the repo a ⭐ so you don't miss future updates.

▶ Watch the installation video

Recommended: Direct Download

Download
  1. Download the ZIP from the button above
  2. Unzip to any folder
  3. Open chrome://extensions → enable Developer Mode
  4. Click Load unpacked → select the unzipped folder
  5. Done!

Or Terminal (macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/Priyanshu-byte-coder/keeptrack/gh-pages/install.sh | bash

The script automatically fetches the latest release from GitHub, downloads the ZIP, and extracts it to ~/keeptrack.

Or PowerShell (Windows)

irm https://raw.githubusercontent.com/Priyanshu-byte-coder/keeptrack/gh-pages/install.ps1 | iex

Or Clone from Source

git clone https://github.com/Priyanshu-byte-coder/keeptrack.git

Then load unpacked from chrome://extensions.


How It Works

KeepTrack silently classifies every download as keep, temporary, or ambiguous:

Signal Keep Temporary
File type .pdf, .docx, .xlsx .exe, .msi, .dmg, .torrent
Filename "invoice", "receipt", "contract", "resume" "setup", "installer", "update", "patch"
Source Bank sites, .gov, Gmail, Google Drive Softonic, SourceForge, GitHub releases
  • High confidence → silent, no interruption
  • Ambiguous → quick notification: tap "Keep" or "Temporary"

Who Is This For?

Students — Lecture slides and assignment PDFs auto-kept. Random installers flagged as temporary.

Freelancers — Invoices, contracts, and client files from email auto-kept. Zoom installers and temp attachments flagged for cleanup.

Developers — GitHub release binaries and IDE installers marked temporary. Documentation exports and data backups kept.

Anyone with a messy Downloads folder — Stop spending 30 minutes every month guessing which files matter.


Privacy & Security

  • Zero telemetry. No data leaves your browser.
  • Zero network calls. Works fully offline.
  • All data stays local. Stored in chrome.storage.local on your machine.
  • Chrome Manifest V3. Built on the latest extension platform with minimal permissions.
  • Open source. Read every line of code.

Contributing

See CONTRIBUTING.md.


License

MIT License. See LICENSE.


Made by Priyanshu

About

Chrome extension that captures download intent (keep vs temporary) at download time. Zero telemetry, fully local.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors