Installation

This guide will help you install DaRT Reader on your system.

System Requirements

Before installing DaRT Reader, ensure your system meets the following requirements:

• Operating System: Windows 11, macOS 15+, or Linux
• Memory: Minimum 2GB RAM, 4GB recommended
• Disk Space: 500MB for application, additional space for extracts and databases

For detailed system requirements, see System Requirements.

Installation Steps

Windows

1. Download the installer: DaRT-Reader-Setup.msi
2. Run the installer with administrator privileges
3. Follow the installation wizard
4. The application will be installed to C:\Program Files\DaRT Reader by default
5. A desktop shortcut will be created automatically by default

ℹ️ Note: Shortly after a new release, Windows may show a "Microsoft Defender SmartScreen prevented an unrecognized app from starting" message. Click More info and check the publisher shown there: for a genuine installer it reads TaxForge. You can then continue with Run anyway.

The message is not a sign that anything is wrong with the download. SmartScreen shows it for every newly released file until enough installations have taken place worldwide, regardless of the file being signed, and it disappears on its own within a few weeks of a release. If the publisher is missing or shows a different name, do not continue — please contact us instead.

macOS

1. Download the installer: DaRT-Reader.dmg
2. Open the DMG file
3. Drag "DaRT Reader" to your Applications folder
4. Launch from Applications or Spotlight

ℹ️ Note: On the first launch macOS asks whether you really want to open an application downloaded from the internet, and states that it checked it for malicious software. Click Open. This is the normal confirmation for any downloaded application, not a warning about this one.

If instead you are told that the application "cannot be opened because Apple cannot check it for malicious software", stop. That check needs an internet connection the first time you start the application, so try again when you are online. If it persists, the download is not one of ours — please contact us rather than working around the message.

Verifying Installation

GUI Application

Launch DaRT Reader from:

• Windows: Start Menu > DaRT Reader or run beye from the Command Prompt
• macOS: Applications > DaRT Reader
• Linux: Application menu or run beye from terminal

You should see the main window with a drag-and-drop zone.

CLI Tool

Open a terminal and run:

beye --version

You should see the installed version:

1.1

CLI Installation (Optional)

For automation and scripting, you can also install just the CLI tool:

# Add to PATH (example for bash/zsh)
export PATH=$PATH:/path/to/dart-reader/bin

ℹ️ Note: On Windows, beye is added to the PATH as part of the installer and removed upon uninstalling.

Next Steps

• Quick Start Guide - Process your first extract
• GUI Guide - Learn the graphical interface
• CLI Guide - Command-line usage