Skip to content

Docs

Installation

This guide covers all methods for installing UltraLog on your system.

Download the latest release for your platform from the Releases page.

Available Downloads

Platform Filename Notes
Windows x64 ultralog-windows.zip Windows 10/11
macOS Intel ultralog-macos-intel.tar.gz macOS 10.15+ (Catalina and later)
macOS Apple Silicon ultralog-macos-arm64.tar.gz M1/M2/M3/M4 Macs
Linux x64 ultralog-linux.tar.gz Most distributions (Ubuntu, Fedora, etc.)

Windows Installation

Steps

  1. Download ultralog-windows.zip from the Releases page
  2. Right-click the zip file and select "Extract All..."
  3. Run ultralog-windows.exe from the extracted folder

SmartScreen Warning

On first run, you may see a Windows SmartScreen warning because the application is not code-signed:

  1. Click "More info"
  2. Click "Run anyway"

This is a one-time warning and won't appear again for this file.

Optional: Add to PATH

To run UltraLog from anywhere in the command line:

  1. Move ultralog-windows.exe to a permanent location (e.g., C:\Program Files\UltraLog\)
  2. Add that folder to your system PATH environment variable

macOS Installation

Steps

  1. Download the appropriate .tar.gz file for your Mac:
    • Intel Mac: ultralog-macos-intel.tar.gz
    • Apple Silicon (M1/M2/M3/M4): ultralog-macos-arm64.tar.gz
  2. Extract the archive (double-click or use Terminal):
    cd ~/Downloads
tar -xzf ultralog-macos-arm64.tar.gz
  3. Run the application: ./ultralog-macos-arm64 (or ultralog-macos-intel)

Gatekeeper Warning

macOS may block the application because it's from an "unidentified developer":

Method 1: Right-click to Open (Recommended)

  1. Right-click (or Control-click) the extracted file
  2. Select "Open" from the context menu
  3. Click "Open" in the dialog

Method 2: System Preferences

  1. Try to open the app (it will be blocked)
  2. Go to System Settings → Privacy & Security
  3. Scroll down and click "Open Anyway" next to the UltraLog message

Method 3: Remove Quarantine Attribute

xattr -d com.apple.quarantine ~/Downloads/ultralog-macos-*

Optional: Move to Applications

For easier access:

mv ~/Downloads/ultralog-macos-arm64 /Applications/UltraLog

Linux Installation

Steps

  1. Download ultralog-linux.tar.gz from the Releases page
  2. Extract the archive:
    tar -xzf ultralog-linux.tar.gz
  3. Run the application:
    ./ultralog-linux

Optional: Install System-wide

sudo mv ultralog-linux /usr/local/bin/ultralog

Now you can run ultralog from anywhere.

Desktop Entry (Optional)

Create a desktop entry for your application menu:

cat > ~/.local/share/applications/ultralog.desktop << 'EOF'
[Desktop Entry]
Name=UltraLog
Comment=ECU Log Viewer
Exec=/usr/local/bin/ultralog
Icon=ultralog
Terminal=false
Type=Application
Categories=Development;Engineering;
EOF

Building from Source

If you prefer to build from source or need to modify the code:

Prerequisites

  • Rust (latest stable version)
  • Git
  • Platform-specific build tools

Install Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

Linux Build Dependencies

Ubuntu/Debian:

sudo apt-get update
sudo apt-get install -y \
    build-essential \
    libxcb-render0-dev \
    libxcb-shape0-dev \
    libxcb-xfixes0-dev \
    libxkbcommon-dev \
    libssl-dev \
    libgtk-3-dev \
    libglib2.0-dev \
    libatk1.0-dev \
    libcairo2-dev \
    libpango1.0-dev \
    libgdk-pixbuf2.0-dev

Fedora:

sudo dnf install -y \
    gcc \
    libxcb-devel \
    libxkbcommon-devel \
    openssl-devel \
    gtk3-devel \
    glib2-devel \
    atk-devel \
    cairo-devel \
    pango-devel \
    gdk-pixbuf2-devel

Arch Linux:

sudo pacman -S --needed \
    base-devel \
    libxcb \
    libxkbcommon \
    openssl \
    gtk3

macOS Build Dependencies

xcode-select --install

Windows Build Dependencies

  1. Install Visual Studio Build Tools
  2. Select "Desktop development with C++" workload during installation

Build Steps

# Clone the repository
git clone https://github.com/SomethingNew71/UltraLog.git
cd UltraLog

# Build release version (optimized)
cargo build --release

# The binary will be at:
# - Windows: target/release/ultralog.exe
# - macOS/Linux: target/release/ultralog

Run Without Building Release

For quick testing during development:

# Debug build (faster compile, slower runtime)
cargo run

# Release build (slower compile, faster runtime)
cargo run --release

Verifying Installation

After installation, verify UltraLog works correctly:

  1. Launch UltraLog
  2. You should see the main window with:
    • Left sidebar (Files section)
    • Center area (empty chart)
    • Right sidebar (Channels section)
  3. Try loading a sample log file to confirm file parsing works

Updating UltraLog

Pre-built Binaries

  1. Download the new version from Releases
  2. Replace the old binary with the new one
  3. On macOS/Linux, you may need to re-apply permissions (chmod +x)

From Source

cd UltraLog
git pull
cargo build --release

Uninstalling

Pre-built Binaries

Simply delete the executable file.

From Source

rm -rf /path/to/UltraLog

Next Steps

From the GitHub wiki. Edit this page