git404hub

what is smart-file-organizer fr?

kokiste/smart-file-organizer — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 2/5Setup · easy

tl;dr

A Python script that scans your Downloads and Screenshots folders, deletes duplicate files, and archives old ones into zip files, with a safe dry run mode on by default.

vibe map

mindmap
  root((repo))
    What it does
      Finds duplicates
      Archives old sessions
      Cleans folders
    Tech stack
      Python
      pathlib
      hashlib
      zipfile
    Use cases
      Declutter downloads
      Archive screenshots
      Preview before deleting
    Safety
      Dry run mode
      Locked file handling
    Audience
      Vibe coders
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Automatically clean up a cluttered Downloads folder by deleting duplicate files.

VIBE 2

Archive old screenshots into dated zip files to save disk space.

VIBE 3

Preview what would be deleted or archived using dry run mode before running for real.

what's the stack?

Pythonpathlibhashlibzipfile

how it stacks up fr

kokiste/smart-file-organizer0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 30min

Uses a Windows-style venv activation command, so Mac and Linux users need to adjust it.

in plain english

Smart File Organizer is a Python script built to clean up messy Downloads and Screenshots folders on your computer. It looks at the files in those folders, figures out which ones are duplicates, and helps you get rid of clutter without losing anything important. To find duplicates, the script first groups files by size, then confirms true matches using SHA-256 content hashing, a way of comparing files based on their actual content rather than just their name. When it finds a group of duplicates, it keeps the oldest copy and marks the rest for deletion. It also looks at when files were created and groups them into sessions based on how close together their timestamps are. Sessions with no new activity for a while, 30 days by default, get marked as candidates for archiving. Old sessions are zipped into a dated archive folder, while duplicates are deleted. Safety is built in from the start. Both deleting and archiving default to dry run mode, meaning the script only prints what it would do without touching your files until you turn those settings off. If a file is locked because another program has it open, the script skips it and logs the issue instead of crashing. You run it with a simple command after setting up a virtual environment, and you can adjust settings like which folders to scan, where archives and kept files should go, how close together timestamps need to be to count as one session, and how many days of inactivity trigger archiving. One known limitation: archiving decisions are made per session rather than per individual file. In a folder that gets new files often, like Screenshots, a session can stay counted as active indefinitely, so older files inside it may never get archived. The author plans to address this with a per file grace period in the future. This project is part of a five project roadmap the author is using to practice Python file system tools such as pathlib, hashlib, and zipfile.

prompts (copy fr)

prompt 1
Help me set up smart-file-organizer, walk me through creating a virtual environment with uv and running organizer.py.
prompt 2
Modify smart-file-organizer so dry run mode is turned off only for archiving, not deletion.
prompt 3
Add a per file grace period to smart-file-organizer so files inside an active session can still be archived individually.
prompt 4
Explain how the SHA-256 duplicate detection in this script works and add a log file recording every deleted duplicate.

Frequently asked questions

what is smart-file-organizer fr?

A Python script that scans your Downloads and Screenshots folders, deletes duplicate files, and archives old ones into zip files, with a safe dry run mode on by default.

What language is smart-file-organizer written in?

Mainly Python. The stack also includes Python, pathlib, hashlib.

How hard is smart-file-organizer to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is smart-file-organizer for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.