A native macOS application for scanning and analyzing video file libraries. Get comprehensive metadata, statistics, and insights about your video collection with a beautiful, premium interface.
Interactive dashboard with clickable metrics and charts. Click any statistic to filter your library.
Browse your video library with powerful filtering options. Quick filter bar provides one-click access to common filters.
High-performance scanning with real-time progress tracking. Clickable error logs help troubleshoot problematic files.
- Cinematic dark theme with warm amber accents
- Quality Gradient - Premium content (HDR, Dolby Vision, Atmos) visually glows
- Interactive dashboard - Click any metric or chart to filter your library
- Quick filter bar - Fast access to common filters (4K, Dolby Vision, Atmos)
- High-performance scanning - Processes 12 files concurrently using Swift Actors
- Pause/Resume - Stop and continue scans at any time
- Crash recovery - Automatic checkpoint saves every 10 seconds; resume interrupted scans on relaunch
- Smart retry logic - Exponential backoff for transient failures on network volumes
- Clickable error logs - Click failed file errors to reveal them in Finder
- Video: Codec (H.264, H.265/HEVC, VP9, AV1, etc.), resolution, bitrate, frame rate, bit depth
- HDR: Dolby Vision, HDR10, HDR10+, HLG detection
- Audio: Codec (AAC, AC3, EAC3, DTS, TrueHD, etc.), channels, Dolby Atmos, DTS:X detection
- Container: MKV, MP4, MOV, AVI, WebM, and more
- Clickable metrics - Click HDR Content or Immersive Audio to see those files
- Clickable charts - Click any legend item to filter (e.g., click "4K" to see all 4K files)
- Resolution distribution with donut chart
- Video codec breakdown with gradient bars
- HDR format statistics with glow effects for premium formats
- Audio codec distribution
- Immersive audio (Atmos/DTS:X) tracking with luminous badges
- Total library size and duration
- Quick filter bar - One-click filters for 4K, Dolby Vision, HDR10, Atmos, DTS:X
- Multi-select filters - Combine multiple resolutions, formats, and codecs
- Click-to-sort columns - Click any column header to sort; click again to reverse
- Resizable columns - Drag column dividers to adjust width
- Click-to-reveal - Click any file row to reveal it in Finder with the file selected
- Quick search across all files
- Context menu: Reveal in Finder, Open with default app, Copy path/filename
- Export - CSV, JSON, or PDF reports
- Integrity Check - Full decode test to detect corrupted files
- Duplicate Detection - Find duplicates by exact hash, partial hash, or fuzzy matching
- macOS 14.0 (Sonoma) or later
- ffprobe is bundled with the app (no additional installation required)
Download the latest DMG from the Releases page.
- Open the DMG file
- Drag Video Analyzer to your Applications folder
- Open the app (see note below about first launch)
Since this app is not signed with an Apple Developer ID, macOS will show a security warning:
"VideoAnalyzer.app cannot be opened because the developer cannot be verified"
To open the app:
- Right-click (or Control-click) on the app in Finder
- Select Open from the context menu
- Click Open in the dialog that appears
You only need to do this once. After the first launch, the app will open normally.
Alternatively, you can allow the app via System Settings:
- Go to System Settings → Privacy & Security
- Scroll down to find the message about VideoAnalyzer being blocked
- Click Open Anyway
git clone https://github.com/bytePatrol/Media_Folder_Visualizer.git
cd Media_Folder_Visualizer
open VideoAnalyzer.xcodeprojBuild and run in Xcode (Cmd+R), or create a release build:
xcodebuild -project VideoAnalyzer.xcodeproj -scheme VideoAnalyzer -configuration Release- Start a scan: Click the folder icon in the toolbar or use File → New Scan (Cmd+N)
- Browse files: Switch to the Files tab to see all scanned videos
- Filter quickly: Use the quick filter bar for common filters (4K, HDR, Atmos)
- Click to explore: Click dashboard metrics or chart legends to filter your library
- View statistics: The Dashboard shows charts and metrics for your library
- Export data: Use File → Export to save as CSV, JSON, or PDF
| Action | Shortcut |
|---|---|
| New Scan | Cmd+N |
| Export | Cmd+E |
| Pause/Resume Scan | Cmd+Shift+P |
| Cancel Scan | Cmd+. |
| Show Dashboard | Cmd+1 |
| Show Files | Cmd+2 |
| Show Scanner | Cmd+3 |
- SwiftUI for the user interface
- Swift Actors for thread-safe concurrent scanning
- GRDB.swift with SQLite WAL mode for the database
- Swift Charts for dashboard visualizations
- Combine for reactive data flow
The app uses a comprehensive design system with:
- VaultColors: Surface colors, text hierarchy (celluloid tones), accents
- VaultSpacing: Consistent spacing scale from 2px to 48px
- VaultTypography: Display, headline, body, caption, and monospace styles
- VaultRadius: Border radius scale (4px to 16px)
- Reusable components: VaultCard, VaultBadge, VaultMetric, VaultProgressRing, VaultFilterChip
- Batch database inserts (50 files at a time)
- Throttled UI updates during scanning
- View recycling for large file lists
- Optimized ffprobe parameters for fast metadata extraction
VideoAnalyzer/
├── App/ # App entry point, delegate, AppState
├── Models/ # Data models, enums
├── Views/
│ ├── DesignSystem.swift # Design tokens and reusable components
│ ├── Dashboard/ # Charts and statistics
│ ├── FileList/ # File browser table, filters
│ ├── Scanner/ # Scan progress and logs
│ └── Settings/ # Preferences
├── Services/
│ ├── Scanning/ # ScanEngine, FFProbeRunner, MetadataParser
│ ├── Database/ # DatabaseManager, VideoFileRepository
│ ├── Recovery/ # Checkpoint and crash recovery
│ └── Export/ # CSV, JSON, PDF export
└── Resources/ # Assets, bundled binaries
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
See CONTRIBUTING.md for detailed guidelines.
This project is licensed under the MIT License - see the LICENSE file for details.
- ffmpeg/ffprobe for video metadata extraction
- GRDB.swift for SQLite database management