Skip to content
Jeffrey-Tool-ProjectsPublic

About

See where your disk space goes: a fast folder-size scanner with a tree, a treemap and the largest files (PySide6)

Resources

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

508 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FileTree

Find out what's filling up your disk.

FileTree scans a folder or drive and shows which files and folders take the most space. Use the folder tree, colourful chart and largest-file list to decide what to keep or clean up.

English | 繁體中文 | 简体中文 | 日本語 | 한국어

FileTree: folder sizes on the left, a space-usage chart on the right

Use arrow keys to select budget rows and Tab to reach the editor. Reopening search brings the name field into view.

What you can do

  • Set exact folder limits in Folder budgets. Read usage and excess in your chosen size unit, with a separate observation time and clear waiting or unknown states. Open trends or budgets for the selected folder from Details. Click an over-limit or unknown count to open matching budgets.
  • Save named workspace templates from the tabs captured when the manager opens. Edit a separate load preview, review live replacement counts, and load idle tabs.
  • Result highlights name the largest folders and the largest files, with cleanup candidates and scan limits. A coloured dot and the Removal advice column in Largest files and Search say whether a file is cleanable, needs a check first, is your call, or should be kept.
  • Check your drives: View → Physical disks… lists each physical drive with its type, health, temperature and wear when reported, and its partition layout. It is read-only and can open the Windows disk tools.
  • Plan how to free space: File → Free up space… asks how much you need and lists what the scan found as ranked steps, safest first. Nothing is ticked for you, and what you tick still goes through the Recycle Bin review and questions.
  • See when a drive will fill up: Drive overview shows a free-space forecast per drive, such as about 2 GB per day and the estimated date it is full, from used-space samples FileTree records when the overview opens. Recording can be turned off there.
  • Delete permanently, only when you say so: Shift+Del deletes the selected entries without the Recycle Bin. FileTree asks every time, deletes only what you approved, and leaves anything that changed since the scan.
  • Save named scan presets from the welcome page or Options, then load a path and its scan choices for reuse. Opening the editor keeps other tabs scanning.
  • Keep the last cleanup counts visible, with operation records, available Undo and an explicit rescan of the original folder.
  • Scan only when you ask: after a clean-up or another file operation, FileTree updates the results it can and offers a rescan of the changed folders instead of scanning again by itself.
  • Leave room for other programs: a scan reads with fewer threads while other programs are using the processor and returns to its normal number when the processor is free. Turn it off in Options.
  • Scan NTFS drives faster: run FileTree as administrator and scan a drive or folder on an NTFS drive, and it reads the drive's file table instead of opening every folder. Turn it off in Options.
  • Find large files and folders: see the biggest items first, including after cleaning or rescanning a folder. Charts show their share of the space. Browsing and filtering reuse sorted rows and sort unopened subfolders only when needed.
  • Search and filter: find files by name, type, size or last change. Sorting, units and tree filters keep visible selections. Tree filters reuse unchanged results, map each opened group once, and skip hidden archive members. Tree filters keep large selections and their gaps while retaining less cached data. Large result lists sort with one value calculation per row. Custom ranges accept exact sizes and inclusive local dates; saved searches keep those bounds.
  • Review clean-up suggestions: inspect caches, temporary files and duplicates before acting. Large lists keep selections when changing units or language; large batches of skipped or failed entries remain available in complete, copyable tables. Keeper choices and space estimates keep your selection and view position. Grouped results open together and retain every listed file. The review table keeps selection, path, logical size and risk together; complete evidence and consequences remain scrollable and copyable.
  • See what grew: compare scans to find folders using more space than before.
  • Track a folder over time: choose a loaded folder and a recent or custom period in Scan history. Select chart points or rows to read sizes, signed changes and unknown reasons. In the loaded-folder picker, Enter opens a folder; Use this folder confirms the current folder.
  • Save reports: export results to CSV, JSON or Excel. Large selected-list copies prepare rows and text in batches; a newer copy in any list replaces the pending one.
  • Use your language: switch between English, Traditional Chinese, Simplified Chinese, Japanese and Korean.
  • Explorer folder menu (Windows): add Scan with FileTree from Options. Settings stay responsive; an active Save finishes before closing.

Applied search conditions stay above the results. Remove one condition or clear them all, and choose dates from a calendar.

Install

Windows: no Python needed

  1. Download FileTree-<version>-windows-standalone.zip from Releases.
  2. Extract the whole ZIP.
  3. Run FileTree.exe inside the extracted folder. Keep the other files beside it.

An MSI installer is also available for installation through Windows.

Windows, macOS or Linux: with Python

Requires Python 3.11 or newer:

python -m pip install je_file_tree
je-file-tree

On Windows, you can use py -3 instead of python. For running from source or building a standalone app, see the detailed guide and build guide.

Get started

  1. Choose a folder or drive, or drag a folder into the window.
  2. Wait for the scan, then browse the largest folders and files. Bigger chart blocks mean more space used.
  3. Review anything you want to remove, then right-click → Move to Recycle Bin. FileTree asks for confirmation, displaying filenames and paths as written.

You can stop a scan at any time; the results collected so far stay visible and are marked incomplete. Unexpected scan failures are reported as errors; results are never marked complete after a worker fails. If worker startup fails, already started workers finish before the error is shown. Starting a new scan cancels pending folder-list calculations and discards their old results.

Things to know

  • Moving files to the Recycle Bin or Trash does not free disk space until you empty it.
  • Clean-up suggestions need your review. Background monitoring is off by default and does not clean up automatically.
  • Folders that cannot be read appear under Problems; their contents are missing from the totals.
  • Scans do not follow symbolic links or junctions. File size and space used on disk can differ.
  • Windows may ask for administrator rights at startup. You can decline and scan accessible folders. A restart requested from the window waits in the background; complete or dismiss the Windows prompt to finish. Restart reopens scan tabs in order and rescans their folder lists with each tab’s current scan choices.
  • Advanced actions such as emptying Trash or linking duplicate copies have separate confirmations and consequences; read the detailed guide first.

Keyboard shortcuts

Key Action
Ctrl+O Choose a folder
F5 Rescan
Esc Stop the scan
Ctrl+F Search
Delete Move selected items to the Recycle Bin
F1 Open help
Ctrl+Q Quit

On macOS, use ⌘ instead of Ctrl; use ⌘R to rescan.

Learn more

Security

Report vulnerabilities privately. The policy, supported versions, and operator notes are in SECURITY.md.

License

MIT.

About

See where your disk space goes: a fast folder-size scanner with a tree, a treemap and the largest files (PySide6)

Resources

Security policy

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages