🗂️ XFScope

[ENG]

XFScope is a desktop filesystem analyzer and disk usage visualization tool for Windows.

It helps you scan folders, understand where disk space is used, find large files and folders, inspect extension statistics, visualize storage distribution, and detect duplicate files using verified size + SHA-256 matching.

Built with Python, PySide6, Matplotlib, and Squarify.

✨ Features

Filesystem scanning

• Recursive folder scanning
• File and folder metadata collection
• Folder size aggregation
• Scan duration tracking
• Skipped error counting
• Cancel scan support

Dashboard

• Total size
• Total files
• Total folders
• Scan duration
• Current scan status

Visual analysis

• Treemap visualization
• Extension statistics chart
• Top folders table
• Top files table
• Search/filter per view

Duplicate detection

• Candidate grouping by file size
• SHA-256 hash verification
• Duplicate group table
• Duplicate files inspection
• Wasted space calculation

Path actions

• Open file
• Open folder
• Open containing folder
• Copy path

Export

• JSON report export
• CSV report export
• Separate CSV files for dashboard, summary, top files, folders, extensions, treemap data, duplicate groups, and duplicate files

Windows packaging

• PyInstaller portable folder build
• Application icon support
• Runtime asset loading for packaged builds

📥 Installation

Recommended — Prebuilt EXE

1. Download the latest release
2. Extract the archive
3. Run:

XFScope.exe

No Python installation is required for end users.

🛠 Run from Source

git clone https://github.com/End1essspace/XFScope.git
cd XFScope
python -m pip install -r requirements.txt
python -m xfscope.app

📦 Portable Build

XFScope can be packaged as a portable Windows folder build.

Current packaging target:

• PyInstaller
• onedir
• windowed
• portable folder build

Build command:

Remove-Item -Recurse -Force .\build,.\dist,.\XFScope.spec -ErrorAction SilentlyContinue; python -m PyInstaller --noconfirm --clean --onedir --windowed --name XFScope --icon .\assets\app_icon.ico --add-data ".\assets\app_icon.ico;assets" --add-data ".\assets\dropdown_arrow.svg;assets" --hidden-import matplotlib.backends.backend_qtagg --hidden-import squarify .\xfscope\app.py

Run packaged app:

.\dist\XFScope\XFScope.exe

⚙️ Requirements

OS

• Windows 10 / Windows 11

Python

• Python 3.13+ for source execution

Dependencies

• PySide6
• matplotlib
• squarify

Install dependencies:

python -m pip install -r requirements.txt

🗂 Project Structure

XFScope/
├─ assets/                   # App icon and UI runtime assets
├─ docs/                     # Architecture, roadmap, development notes
├─ tests/                    # Tests
├─ xfscope/
│  ├─ app.py                 # Application entry point
│  ├─ core/                  # Scanner, analyzer, backend, exports
│  ├─ ui/                    # PySide6 UI shell, pages, styles, actions
│  └─ visualization/         # Treemap and charts
├─ README.md
├─ requirements.txt
└─ LICENSE

🚧 Current Status

Current target:

v0.9.0-rc1

Status:

Packaged MVP release candidate preparation

This is the first packaged MVP candidate of the local filesystem analyzer. It is not yet the full storage intelligence platform with persistent indexing, monitoring, recommendations, historical snapshots, and cleanup automation.

📝 License

This project is distributed under the MIT License.

💡 Author

XCON | RX Telegram: @End1essspace GitHub: End1essspace

---

🗂️ XFScope

[RUS]

XFScope — это desktop-приложение для Windows, предназначенное для анализа файловой системы и визуализации использования дискового пространства.

Программа помогает сканировать папки, понимать распределение памяти, находить крупные файлы и директории, анализировать расширения, визуализировать структуру через treemap и находить дубликаты файлов через проверку размера и SHA-256 hash.

Проект построен на Python, PySide6, Matplotlib и Squarify.

✨ Возможности

Сканирование файловой системы

• Рекурсивное сканирование папок
• Сбор информации о файлах и директориях
• Подсчёт размеров папок
• Отслеживание длительности сканирования
• Подсчёт пропущенных ошибок
• Поддержка отмены сканирования

Dashboard

• Общий размер
• Количество файлов
• Количество папок
• Длительность сканирования
• Текущий статус scan workflow

Визуальный анализ

• Treemap-визуализация
• График статистики расширений
• Таблица крупнейших папок
• Таблица крупнейших файлов
• Поиск/фильтрация на каждой вкладке

Поиск дубликатов

• Группировка кандидатов по размеру файла
• Проверка SHA-256 hash
• Таблица групп дубликатов
• Просмотр файлов внутри выбранной группы
• Подсчёт wasted space

Действия с путями

• Открыть файл
• Открыть папку
• Открыть папку с файлом
• Скопировать путь

Экспорт

• Экспорт отчёта в JSON
• Экспорт отчёта в CSV
• Отдельные CSV-файлы для dashboard, summary, top files, folders, extensions, treemap data, duplicate groups и duplicate files

Windows packaging

• Portable folder build через PyInstaller
• Иконка приложения
• Runtime asset loading для packaged build

📥 Установка

Рекомендуемый способ — готовый EXE

1. Скачайте последний релиз
2. Распакуйте архив
3. Запустите:

XFScope.exe

Для обычного пользователя Python не требуется.

🛠 Запуск из исходников

git clone https://github.com/End1essspace/XFScope.git
cd XFScope
python -m pip install -r requirements.txt
python -m xfscope.app

📦 Portable Build

XFScope может собираться как portable Windows folder build.

Текущий packaging target:

• PyInstaller
• onedir
• windowed
• portable folder build

Команда сборки:

Remove-Item -Recurse -Force .\build,.\dist,.\XFScope.spec -ErrorAction SilentlyContinue; python -m PyInstaller --noconfirm --clean --onedir --windowed --name XFScope --icon .\assets\app_icon.ico --add-data ".\assets\app_icon.ico;assets" --add-data ".\assets\dropdown_arrow.svg;assets" --hidden-import matplotlib.backends.backend_qtagg --hidden-import squarify .\xfscope\app.py

Запуск packaged app:

.\dist\XFScope\XFScope.exe

⚙️ Требования

ОС

• Windows 10 / Windows 11

Python

• Python 3.13+ для запуска из исходников

Зависимости

• PySide6
• matplotlib
• squarify

Установка зависимостей:

python -m pip install -r requirements.txt

🗂 Структура проекта

XFScope/
├─ assets/                   # Иконка приложения и runtime UI assets
├─ docs/                     # Архитектура, roadmap, dev notes
├─ tests/                    # Тесты
├─ xfscope/
│  ├─ app.py                 # Точка входа
│  ├─ core/                  # Scanner, analyzer, backend, exports
│  ├─ ui/                    # PySide6 UI shell, pages, styles, actions
│  └─ visualization/         # Treemap и charts
├─ README.md
├─ requirements.txt
└─ LICENSE

🚧 Текущий статус

Текущая цель:

v0.9.0-rc1

Статус:

Подготовка packaged MVP release candidate

Это первый packaged MVP-кандидат локального анализатора файловой системы. Это ещё не полноценная storage intelligence platform с persistent indexing, monitoring, recommendations, historical snapshots и cleanup automation.

📝 Лицензия

Проект распространяется под лицензией MIT.

💡 Автор

XCON | RX Telegram: @End1essspace GitHub: End1essspace