🐦 BirdView

Ever wondered where all your storage went?

BirdView is a snappy, macOS-inspired dashboard that helps you hunt down space-hogs on your Unraid server (or any home server). It scans your drives, categorizes your junk, and tracks how your storage grows over time.

Why you'll love it

• Fast as heck: Written in Go, so it rips through millions of files in a few minutes.
• Eye Candy: A beautiful frosted glass UI that actually looks good.
• Time Travel: See exactly how much your "Backups" folder grew since last month.
• No Mess: Just one Docker container. No complex setup, no external databases.

Get it running

Unraid (The easy way)

1. Head to the Apps tab.
2. Search for BirdView.
3. Hit Install and you're done!

Configuration

• Storage to Scan: Point this to whatever you want BirdView to analyze (default: /mnt/user).
• AppData: This is where BirdView saves its history database. Keep this persistent so you don't lose your charts!
• Scan Interval: Set how many days to wait between automatic scans. We recommend 7 days to keep your drives happy.
• Web Port: The port where you'll access the dashboard (default: 8080).

How Categorization Works

BirdView doesn't just look at extensions; it's a bit smarter than that. It uses two methods to group your files.

1. Smart Paths: If a file is inside a folder named Backups, TimeMachine, or Docker, it's automatically tagged as Backups or System, regardless of what the file is.
2. File Types: If the folder name doesn't give it away, it looks at the extension:
   • Video: .mp4, .mkv, .avi, .mov, etc.
   • Audio: .mp3, .wav, .flac, etc.
   • Images: .jpg, .png, .gif, .heic, etc.
   • Archives: .zip, .tar, .iso, .dmg, etc.
   • Documents: .pdf, .docx, .xlsx, .txt, etc.
   • System: .db, .log, .json, .yaml, etc.
   • Other: Anything that doesn't fit the above!

Docker Compose

Just copy this into your docker-compose.yml:

version: '3.8'
services:
  birdview:
    image: storken/birdview
    ports:
      - "8080:8080"
    volumes:
      - /mnt/user:/data:ro        # What you want to scan
      - ./appdata:/app/data       # Where to save history
    environment:
      - BIRDVIEW_SCAN_INTERVAL_DAYS=7

License

MIT. Go wild.