# Spacelens

Spacelens is an Unraid plugin that shows what is using the space on a disk, pool or share, TreeSize style, with drill-down. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7669/spacelens

## Description

Spacelens is an Unraid plugin that shows what is using the space on a disk, pool or share, TreeSize style, with drill-down. Scans run in the background at low priority and give a treemap, a folder table, the largest files, growth since earlier scans, and optional scheduled scans with notifications when a target grows. User shares are scanned on each disk and pool directly and merged, so every folder shows how much of it is on each disk.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

44/100 (Fair), based on 3 of 4 factors.
- Maintained: 77 (last commit 10 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)

## Links

- Unraid: https://ca.unraid.net/apps/app_28c0fe1896d48acc
- GitHub: https://github.com/dkarzon/spacelens

## Common questions

### What do I need to create before installing Spacelens for the first time?

Create the /boot/config/plugins/spacelens folder on the server first if this is the first install. This lets the matching package already be present, so the install does not try to download it.

### Are changes pushed with dev-sync.sh permanent?

No, dev-sync.sh is for quick testing and changes made this way are lost on reboot. Install the plugin once first so the Spacelens page is registered.

### How does Spacelens handle /mnt/user shares?

It scans the share on each disk and pool that has the relevant folder, in parallel, instead of through /mnt/user. The per-disk results are merged so each folder also shows how much of it is on each disk.

### Will a scan block the UI or use high I/O priority?

The background scanner runs du at low priority with nice and ionice -c3. Drilling into folders uses the stored index and lists files live, rather than rescanning the target.

### How are scheduled scans and growth alerts run?

An hourly cron job, scripts/scheduled.php, handles scheduled scans and growth alerts.

---
Source: Our Local Host (https://ourlocalhost.com/app/7669/spacelens), the self-hosted and open-source app directory.
