Transform Unreal Engine memory reports into beautiful, interactive visualizations. Analyze .memreport files with ease instead of struggling through raw text.
npm install memreport-insightsbash
npx memreport-insights
`
Upload your .memreport file and instantly see beautiful, interactive analysis instead of scrolling through thousands of lines of raw text.
---
๐ธ Screenshots
---
โจ Why Memreport Insights?
$3
- Scrolling through 50,000+ lines of raw text
- No visual hierarchy or organization
- Impossible to spot patterns or trends
- Manual calculation of memory totals
- No way to quickly find specific allocations
$3
- Interactive Tables: Sort, filter, and search through memory data
- Visual Hierarchy: Clear sections with expandable/collapsible organization
- Smart Parsing: Automatic detection of UE4/UE5 versions and formats
- Instant Search: Find any allocation, texture, or object in milliseconds
- Export Ready: Download formatted HTML reports for sharing
- Privacy First: All processing happens in your browser - files never leave your machine
---
๐ฏ Key Features
$3
- Zero Server Processing: Files are analyzed entirely in your browser
- No Data Collection: Your memory reports stay on your machine
- Offline Capable: Works without internet after initial load
$3
- Instant Start: npx memreport-insights and you're ready
- Mobile Responsive: Analyze reports on any device
- Dark/Light Themes: Built-in theme support for long analysis sessions
- Export Options: Save analysis as HTML for team sharing
$3
- UE 4.27: Full support with complete section parsing
- UE 5.1-5.6: Latest Unreal Engine 5 features supported
- Auto-Detection: Automatically detects and adapts to your UE version
$3
- Large File Handling: Efficiently processes multi-MB memory reports
- Lazy Loading: Only renders visible data for smooth scrolling
- Smart Caching: Instant re-analysis of previously loaded files
---
๐ฆ Installation & Usage
$3
`bash
Start immediately - no installation needed
npx memreport-insights
Custom port and options
npx memreport-insights --port 8080 --no-open
`
$3
`bash
Clone and install
git clone https://github.com/cignoir/memreport-insights.git
cd memreport-insights
npm install
Start development server
npm run dev
Build for production
npm run build
`
$3
`bash
npm install -g memreport-insights
memreport-insights
`
---
๐ฎ How to Generate .memreport Files
$3
1. Launch your game or Play in Editor
2. Open the console (usually ^ or @ key)
3. Execute the command:
`
memreport -full
`
4. Find the generated file at:
`
YourProject/Saved/Profiling/MemReports/
`
$3
Generated files follow this pattern:
`
[ProjectName]-[Platform]-[Timestamp].memreport
`
Example: MyGame-WindowsEditor-09.16-17.17.22.memreport
$3
`
Basic memory report (less detailed)
memreport
`
---
๐ง Advanced Usage
$3
`bash
npx memreport-insights [options]
Options:
-p, --port Server port (default: 8173)
-h, --host Server host (default: localhost)
--no-open Don't auto-open browser
--help Show help message
--version Show version
`
$3
`bash
Custom configuration
MEMREPORT_PORT=8080
MEMREPORT_HOST=0.0.0.0
MEMREPORT_THEME=dark
`
---
๐ Supported Unreal Engine Versions
| Version | Status | Features | Notes |
|---------|--------|----------|-------|
| UE 4.27 | โ
Full Support | Complete parsing, all sections | Stable and tested |
| UE 5.0 | โ Not Supported | - | Configuration pending |
| UE 5.1 | โ
Full Support | All UE5.1 features | Recommended |
| UE 5.2 | โ
Full Support | Enhanced memory tracking | Recommended |
| UE 5.3 | โ
Full Support | Nanite/Lumen analysis | Latest features |
| UE 5.4 | ๐ก Partial Support | Core functionality | Some features pending |
| UE 5.5 | โ
Full Support | World Partition support | Latest stable |
| UE 5.6 | โ
Full Support | Chaos Physics analysis | Cutting edge |
---
๐ ๏ธ Tech Stack
| Frontend | Build Tools | Quality |
|----------|-------------|---------|
| !React | !Vite | !TypeScript |
| !Tailwind | !Node.js | !ESLint |
---
๐ Project Structure
`
memreport-insights/
โโโ ๐ฑ src/
โ โโโ ๐งฉ components/ # React Components
โ โ โโโ FileUpload.tsx # Drag & drop interface
โ โ โโโ ReportDisplay.tsx # Main report viewer
โ โ โโโ TableDisplay.tsx # Interactive data tables
โ โ โโโ TableOfContents.tsx # Navigation sidebar
โ โโโ ๐ lib/ # Core Libraries
โ โ โโโ memreportParser.ts # .memreport file parser
โ โ โโโ htmlGenerator.ts # HTML export generator
โ โโโ โ๏ธ config/ # Configuration System
โ โ โโโ parse_patterns/ # UE version-specific parsers
โ โ โโโ engine_settings/ # BaseEngine.ini configurations
โ โ โโโ *.ts # Config loaders
โ โโโ ๐ท types/ # TypeScript Definitions
โ โโโ ๐ฏ App.tsx # Main Application Component
โโโ ๐ bin/ # NPX executable
โโโ ๐ฆ dist/ # Built application
โโโ ๐ package.json # Project configuration
`
---
๐ค Contributing
We welcome contributions from the Unreal Engine community!
$3
1. ๐ด Fork the repository
2. ๐ฟ Create a feature branch: git checkout -b amazing-feature
3. ๐ป Commit your changes: git commit -m 'Add amazing feature'
4. ๐ค Push to the branch: git push origin amazing-feature
5. ๐ Submit a Pull Request
$3
- ๐ New UE Versions: Help us support the latest Unreal releases
- ๐ Bug Reports: Found an issue? Let us know!
- ๐ Visualizations: Ideas for better data presentation
- ๐จ UI/UX: Make the interface even more intuitive
- ๐ Documentation: Help others learn to use the tool
- ๐งช Testing: Test with different project types and sizes
$3
- Follow TypeScript best practices
- Write meaningful commit messages
- Update documentation for new features
- Ensure mobile responsiveness
- Test with multiple UE versions when possible
- Add tests for new parsing logic
---
๐ Usage Examples
$3
`
1. Upload your .memreport file
2. Navigate to "Texture Memory" section
3. Sort by "Size" to find largest textures
4. Use search to find specific asset paths
5. Export filtered results for team review
`
$3
`
1. Compare memory reports before/after changes
2. Use the search function to find specific objects
3. Check "RenderTarget Pool" for GPU memory issues
4. Analyze "StaticMesh" section for geometry bloat
`
$3
`
1. Generate HTML export of your analysis
2. Share the standalone HTML file with your team
3. Include findings in code reviews
4. Archive reports for historical comparison
``