Source Code & Audit

The Norns is free, open-source software built for EVE Online ratting fleets. Review the architecture, audit log parsing routines, or build the application locally from source.

01 · Why Provide Open Source?

Capsuleers pilot valuable ship doctrines and multi-account fleets. Entrusting a companion tool requires absolute transparency. The full source code of The Norns is public so that players, alliance security officers, and developers can verify that the application operates strictly within CCP Games' policies.

✓
Read-only filesystem access: Reads exclusively from Documents\EVE\logs\Gamelogs and OS window titles (EVE - <Character>).
✓
Zero process or memory inspection: The Norns never hooks, debugs, injects DLLs, or inspects the RAM of exefile.exe.
✓
Zero input injection: No automated clicks, hotkeys, window activation, or broadcasting. 100% passive monitoring.
✓
Zero telemetry & 100% local: No remote servers, user tracking, or analytics. The sole outbound network call is the optional GitHub Release update check.

02 · License & Terms of Use

The Norns is released under the permissive MIT License.

You are free to inspect, modify, fork, and compile the code for personal or community use. Unlike restrictive tools, full rights to study and verify the code are granted without hidden conditions.

Copyright (c) 2026 The Norns Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software...

03 · Codebase Architecture

The application is authored in C# 7.3 targeting .NET Framework 4.8 (Windows native WinForms & GDI+). Key routines are structured for fast, non-blocking log tailing:

Module File Function
Log Parser native/DpsGraph.cs Shared read-only file stream tailing (GameLogTail, GameLogParser)
Hardware Body native/Body.cs Industrial OLED frame, GDI+ double-buffered custom rendering
Mathematical Core native/Formula.cs Vorton bounce math, frigate runner impedance, ECG spring physics
Configuration native/Settings.cs Multi-language layout, profile serialization, update check toggle
Setup Installer native/setup/Setup.cs Self-contained per-user installer with privacy toggles

04 · Reproducible Local Build

Building The Norns requires no complex toolchains or external SDKs. It builds directly with standard Windows tools (Visual Studio Build Tools 2022 or Roslyn csc.exe):

# 1. Clone the repository
git clone https://github.com/MadisonCatfish/the-norns.git
cd the-norns

# 2. Build the application binary (TheNorns.exe)
powershell -ExecutionPolicy Bypass -File native\build.ps1 -Out bin

# 3. Build setup installer and portable zip package
powershell -ExecutionPolicy Bypass -File native\build.ps1 -Out release -Setup

# 4. Execute self-tests to verify visual output and math consistency
.\bin\TheNorns.exe --selftest-dps selftest_output

Every commit pushed to a v* tag is built identically by GitHub Actions runners (.github/workflows/build.yml), generating matching SHA-256 binary checksums.