Skip to content

phantasmat2018/DiskCells

Repository files navigation

DiskCells

A disk space analyzer that draws every file and folder as a softly glowing bubble — area scales with byte size, so the biggest space hogs are unmistakable at a glance. Click any bubble to drill in; the scan is incremental and cached, so subsequent launches are near-instant.

DiskCells icon

Download

Pre-built Windows executable: see the Releases page. Just download DiskCells.exe and run — no install, no Python required.

Features

  • Animated bubble visualisation — soft-body physics, file-category colours
  • Incremental scanning with persistent on-disk cache (auto-resumes the last scan target on launch — re-opens to a populated view in seconds)
  • Stop / Resume controls — pause and continue mid-scan
  • Scrollable breadcrumb chain with a thin custom scrollbar
  • UI sound effects — characterised per event (single-bubble blip, multi-bubble scatter, growth-spurt whoosh, navigation pop/back, toggle), with 3–6 randomised variants per category and a global mute toggle
  • Bubble physics rendering at 60 FPS with stable cell layout
  • Capybara mascot — friendly cameo that appears after 2 min of use or on cursor hover in the bottom-left corner; clicks open capybro.app
  • Support button in the toolbar (Donatello + Monobank)

Run from source

pip install -r requirements.txt
python main.py

Or double-click run.bat.

Build a standalone Windows .exe

build.bat

The result lands in dist\DiskCells.exe — a single, portable executable.

Project layout

main.py           entry point — sets app icon, taskbar AppUserModelID
window.py         main window, toolbar, breadcrumbs, drive picker, mascot wiring
canvas.py         QGraphicsView that runs the bubble physics + mascot rendering
cell.py           the bubble itself — gradient, halo, breath animation
scanner.py        background QThread that walks the filesystem
cache.py          persistent on-disk cache of scan trees
sound.py          QSoundEffect-based UI sounds with variant pool per name
capybara.py       headless mascot — frames + audio + state machine
_gen_sounds.py    one-shot generator for the WAV sound variants
theme.py          palette + file-category colors
icons.py          line-art icons drawn by QPainter
assets/           app icon, sound WAVs, capybara frames + audio
_source/          source media (capybara.webm) — not bundled in the .exe
build.bat         one-shot PyInstaller build
run.bat           launch from source

Support

If DiskCells saves you time, you can chip in via the heart button in the toolbar, or directly:

License

MIT.

About

Disk space analyzer with animated bubble visualization тАФ files and folders as glowing colour-coded cells, sized by bytes

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors