Installation

System Requirements

Requirement	Minimum
OS	macOS 12 (Monterey) or later
Architecture	Intel (x86_64) or Apple Silicon (arm64)
RAM	8 GB (16 GB recommended for large files)
Disk	500 MB for app + space for temporary SQLite databases

Download

Download the latest .dmg installer from the GitHub Releases page.

IRFlow Timeline is distributed as a Universal Binary that runs natively on both Intel and Apple Silicon Macs.

Install from DMG

1. Open the downloaded .dmg file
2. Drag IRFlow Timeline to the Applications folder
3. Eject the DMG
4. Launch IRFlow Timeline from Applications or Spotlight

First Launch

On first launch, macOS may show a security prompt because the app is not notarized through the App Store. Right-click the app and select Open to bypass Gatekeeper, or go to System Settings > Privacy & Security and click Open Anyway.

Build from Source

If you prefer to build from source:

# Clone the repository
git clone https://github.com/r3nzsec/irflow-timeline.git
cd tle-app

# Install dependencies
npm install

# Rebuild native modules for Electron
npx electron-rebuild -f -w better-sqlite3

# Run in development mode
npm run dev

# Build distributable .app
npm run dist

# Build DMG installer
npm run dist:dmg

Build Script

The project includes an interactive build.sh script with multiple options:

Option	Description
Dev Mode	Vite hot-reload + Electron
Quick Start	Build renderer and launch
.app Bundle	Distributable app with ad-hoc signing
DMG Installer	Full installer package
Universal Binary	Intel + Apple Silicon combined

chmod +x build.sh
./build.sh

File Associations

After installation, IRFlow Timeline registers as a viewer for the following file types. You can double-click these files to open them directly:

• .csv — CSV files
• .tsv — TSV files
• .xlsx — Excel files
• .plaso — Plaso timeline databases
• .evtx — Windows Event Log files