A sleek, professional disk space analyzer for macOS. Scan your Mac, visualize what's eating your storage, and clean up space — all from a beautiful dark-themed web UI.

• Real-time disk scanning — Quickly scans directories using optimized du calls
• Size visualization — Color-coded distribution bar and percentage indicators for every item
• Drill-down navigation — Click any folder to explore deeper, with breadcrumb navigation
• List & Grid views — Toggle between compact list or visual tile layout
• Search & Sort — Filter by name, sort by size or alphabetically
• Select & Delete — Multi-select files/folders and move to Trash or permanently delete
• Disk overview — See total, used, and free space at a glance
• Keyboard shortcuts — Backspace to go up, Escape to cancel

Select items to clean up with checkboxes. Navigate folders while in select mode by clicking folder names.

Review selected items and total size before moving to Trash or permanently deleting.

• Node.js (v16 or higher)
• macOS

git clone https://github.com/NYOGamesCOM/DiskLens.git
cd DiskLens
npm install

npm start

Then open http://localhost:3847 in your browser.

• Backend: Node.js + Express server that scans the filesystem using optimized du commands
• Frontend: Vanilla HTML/CSS/JS with a professional dark theme (Inter font, glassmorphism accents)
• Safety: Delete operations are restricted to files under the home directory. System paths are protected. "Move to Trash" uses macOS Finder (recoverable), while "Delete Forever" is permanent

• Runtime: Node.js
• Server: Express.js
• Frontend: Vanilla JS, CSS3 (custom properties, grid, flexbox)
• Font: Inter (Google Fonts)
• Icons: Inline SVG + emoji

MIT