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 | 繁體中文 | 简体中文 | 日本語 | 한국어
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 link the largest direct folders, cleanup candidates and scan limits to their existing views.
- 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.
- 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
- Download
FileTree-<version>-windows-standalone.zipfrom Releases. - Extract the whole ZIP.
- Run
FileTree.exeinside 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.10 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
- Choose a folder or drive, or drag a folder into the window.
- Wait for the scan, then browse the largest folders and files. Bigger chart blocks mean more space used.
- 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
- Detailed usage and technical notes: all features, command-line examples, settings and limitations.
- Build guide: create a standalone app with Nuitka.
- Core API and architecture: integrate with or develop FileTree.
- Update log: changes and validation records.
Security
Report vulnerabilities privately. The policy, supported versions, and operator notes are in SECURITY.md.
License
MIT.
Metadata
Release files for je-file-tree 0.2.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| je_file_tree-0.2.7.tar.gz | 625.2 kB | Without provenance | Details for je_file_tree-0.2.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| je_file_tree-0.2.7-py3-none-any.whl | Python 3 | none | any | Details for je_file_tree-0.2.7-py3-none-any.whl |
Total release size: 1.4 MB
Release files / je_file_tree-0.2.7.tar.gz
| Download URL | je_file_tree-0.2.7.tar.gz |
|---|---|
| Size | 625.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1e81374dc737fac6ffe246020aae293310f83b6070ea498ef114ee3093ebe5e1
|
|
BLAKE2b-256 checksum How to use checksums |
9fa2280d83c26a9ef09ca1c72b3053a43faa5736ebed1ff1c9cd24780dc4971b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Release files / je_file_tree-0.2.7-py3-none-any.whl
| Download URL | je_file_tree-0.2.7-py3-none-any.whl |
|---|---|
| Size | 743.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3be9816908a2192840ad01775ace497a015152b9f12ceb48dd7d8a7d7e2c35d0
|
|
BLAKE2b-256 checksum How to use checksums |
0ded76d69c82bbcb4557e24e3c5ef472891d828b2ff1ba484ae3c771faf904cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.15
|
Security for je-file-tree 0.2.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.