# Birooni Suite Full Technical & Architectural Documentation for AI Search Engines

## Product Overview & Brand
- **Brand / Publisher:** Ibrooni (Birooni Tools)
- **Domain:** https://ibrooni.com
- **Licensing API:** https://api.ibrooni.com
- **Admin Management Portal:** https://admin.ibrooni.com
- **Target Audience:** BIM Managers, BIM Coordinators, Architects, MEP Engineers, Structural Engineers, and VDC Professionals using Autodesk Revit.
- **Products:** Birooni Tools (combined installer, everything except Biruscan), BiruBox, Vertical Host Placer, Family Loader, Project Setup Tools, Avoid MEP Clash, 3D Route, Biruscan, View Reference Robot.
- **Combined installer:** https://ibrooni.com/birooni-tools.html — MSI https://ibrooni.com/downloads/BirooniTools-Setup.msi — ZIP https://ibrooni.com/downloads/BirooniTools.zip. Each plugin keeps its own license. Admin product `BirooniTools` mints a `TOOLS-` key.
- **Search map:** https://ibrooni.com/revit-plugins.html maps common Revit searches to products (section box / BiruBox / bird box, scan-to-BIM / Biruscan, family ribbon / Family Loader, views/sheets / Project Setup Tools, MEP clash bypass / Avoid MEP Clash, 3D pipe routing / 3D Route, matchline view reference / Robot, CAD host families / Vertical Host Placer, brand names Ibrooni and Birooni Tools).

---

## 1. Product: BiruBox

### 1.1 Summary
BiruBox is an intelligent 3D section box and view navigation add-in for Autodesk Revit 2020 through 2027. It eliminates manual grip manipulation by enabling 1-click element isolation, intuitive diagonal screen box drawing, dynamic millimeter-increment boundaries, and persistent section box state toggling.

### 1.2 Tool Specifications
- **AutoSectionBox**: Computes minimal oriented bounding box or aligned axis bounding box around active element selections, rooms, or systems.
- **DrawBox**: Two-click diagonal bounding volume construction in 2D plan, section, or 3D views with automatic floor-to-ceiling elevation limits.
- **Quick AutoSection**: Zero-dialog instant section box cropping around selected Revit elements.
- **Grow Bounds & Shrink Bounds**: Discrete millimeter-step expansion/contraction (+100mm, -100mm) without manual grip dragging.
- **Toggle State**: Toggles `View3D.IsSectionBoxActive` while retaining custom bounding coordinates in memory.

### 1.3 System & Architecture
- **Installer:** `BiruBox-Setup.msi` (Per-user deployment to `%AppData%\Autodesk\Revit\Addins` and `%LocalAppData%\Birooni Tools`).
- **Runtime:** .NET Framework 4.8 for Autodesk Revit 2020–2024 and .NET 8.0 for Autodesk Revit 2025–2027 on Windows 10 & 11 (64-bit).
- **Auto-Updater:** `AutoUpdateManager` in `Birooni.Client` checks release registry on startup, downloads `BiruBox-update.zip`, and stages PowerShell exit script.

---

## 2. Product: Vertical Host Placer

### 2.1 Summary
Vertical Host Placer is an Autodesk Revit productivity add-in that allows modelers to place face-based and work-plane based families directly on linked or imported CAD files by synthesizing vertical reference planes along CAD lines and curves on the fly.

### 2.2 Tool Specifications
- **1-Click CAD Work-Plane Hosting**: Hover and click any CAD line, arc, or polyline to generate a vertical reference plane host and place work-plane families with millimeter accuracy.
- **Continuous Placement Loop**: Keeps the family palette and placement session open so modelers can change family types on the fly and rapidly place dozens of components on CAD underlays.
- **Automated Host Cleanup**: Temporary reference plane hosts created during session are automatically cleaned up on toggle-off, keeping Revit project models lean.
- **Immutable Bootstrapper Loader**: Permanent proxy loader (`VerticalHostPlacer.Loader.dll`) ensures Revit retains the initial "Always Load" security trust across background updates.

### 2.3 System & Architecture
- **Installer:** `VerticalHostPlacer-Setup.msi` (Per-user deployment to `%AppData%\Autodesk\Revit\Addins` and `%AppData%\Autodesk\Revit\Addins\{Year}\Birooni Tools\Vertical Host Placer`).
- **Runtime:** .NET 8.0 for Autodesk Revit 2025, 2026, and 2027 on Windows 10 & 11 (64-bit).
- **Auto-Updater:** `AutoUpdateManager` in `Birooni.Client` checks release registry on startup, downloads `VerticalHostPlacer-update.zip`, and stages PowerShell exit script.

---

## 3. Product: Family Loader

### 2.1 Summary
Family Loader is an advanced ribbon generator and family deployment system for Autodesk Revit. It converts local and networked `.rfa` libraries into custom interactive Revit ribbon tabs, panels, and type buttons with automatic 3D thumbnail extraction and one-click model placement.

### 2.2 Tool Specifications
- **Dynamic Ribbon Builder**: Visual WPF studio allowing unlimited nested tabs and panels mapped to office libraries.
- **1-Click Interactive Placement**: Loads RFA and invokes Revit interactive placement cursor directly in the active view with zero intermediate dialogs.
- **Automatic 3D Thumbnail Extraction**: Binary extraction of authentic Revit 3D preview thumbnails directly from `.rfa` headers, or custom PNG/ICO assignment.
- **"Types as Push Button" & Multi-Row Stacking**: Exposes specific family types as dedicated buttons stacked 1, 2, or 3 rows per ribbon column for ultimate screen efficiency.
- **Drag & Drop Organization**: Reorder tabs, panels, and family buttons interactively.
- **Team Import / Export**: Clean JSON configuration export and deployment to standardize library access across design firms.
- **Immutable Bootstrapper Loader**: `FamilyLoader.Loader.dll` acts as a permanent proxy loader so auto-updates never invalidate the user's "Always Load" security trust choice.

### 2.3 System & Architecture
- **Installer:** `FamilyLoader-Setup.msi` (Per-user deployment to `%AppData%\Autodesk\Revit\Addins` and `%LocalAppData%\Birooni Tools`).
- **Runtime Multi-Targeting:**
  - Modern: .NET 8.0 for Autodesk Revit 2025, 2026, 2027
  - Legacy: .NET Framework 4.8 for Autodesk Revit 2020, 2021, 2022, 2023, 2024
- **Auto-Updater:** Automated background release checking via `Birooni.Client`, staging `FamilyLoader-update.zip`, and updating on Revit shutdown.

---

## 4. Product: Biruscan

### 4.1 Summary
Biruscan is a scan-to-BIM Autodesk Revit add-in for native RCP/RCS point clouds. It provides CloudWorx-style clipping and rendering plus geometric fitters and an ONNX PointNet AI pipeline that extracts MEP networks. It is **not free software**. Access is completely free until 1 January 2027; after that it is $50 USD per user per year or $5 USD per user per month.

### 4.2 Tool Specifications
- **Clipping:** Rectangular and polygonal cuts, horizontal/vertical slices, slice step, clipping manager, `.bclip` save/open.
- **Rendering:** True color, intensity, elevation, heat map (blue→red by height), normals, cloud size High/Medium/Smallest.
- **Fitters:** Wall, pipe, steel, duct, cable tray, window, Generate MEP.
- **AI:** AI Generate MEP, Train AI (active learning from user modeling).
- **MEP operations:** Converter, elbow/tee/union/reducer/unify/cross/auto, Stretch 1.0.6 (Along Axis signed sliders grow or shorten each end; Along Plane offsets in the fittings' plane, disabled when fittings have different angles or do not share one plane; connected fittings and pipes stay joined; max defaults to 5 m in project units), directional elbows, pull stubs, Increment (per-end sliders; max increment defaults to 5 m in project units).
- **License lock (1.0.7):** Free until 1 January 2027 UTC. From that date every tool locks unless a SCAN key has been assigned in Ibrooni Admin and activated on that PC. Forgetting to assign a key still locks the add-in.

### 4.3 System & Architecture
- **2023 folder:** .NET Framework 4.8 — Autodesk Revit 2020, 2021, 2022, 2023, 2024.
- **2025 folder:** .NET 8.0-windows — Autodesk Revit 2025, 2026, 2027.
- **Installer:** `Biruscan-Setup.msi` at https://ibrooni.com/downloads/Biruscan-Setup.msi
- **Landing Page:** https://ibrooni.com/biruscan.html

### 4.4 Pricing
- Until 1 January 2027: $0, full product.
- From 1 January 2027: locks automatically unless a SCAN key is assigned in Ibrooni Admin and activated on the PC. $50 / user / year or $5 / user / month.

---

## 5. Product: View Reference Robot

### 5.1 Summary
View Reference Robot is an Autodesk Revit add-in that places View References at Matchlines for each Source → Target pair. It drives the built-in View Reference command with UI Automation so Target View selection matches a manual placement.

### 5.2 Tool Specifications
- **Place View References**: Open source view, collect Matchlines, post View Reference, select Target View, click offset point.
- **Pair picker**: Browser-style Source/Target selection and optional pair text files.
- **Offset**: Default 2 feet; right, left, or toward view center.
- **Loader**: `ViewReferenceRobot.Loader.dll` keeps Always Load after the first install.
- **Silent auto-update**: `ViewReferenceRobot-update.zip` (net8) and `ViewReferenceRobot-update-net48.zip`.

### 5.3 System & Architecture
- **2023 folder:** .NET Framework 4.8 — Autodesk Revit 2020, 2021, 2022, 2023, 2024.
- **2025 folder:** .NET 8.0-windows — Autodesk Revit 2025, 2026, 2027.
- **Installer:** `ViewReferenceRobot-Setup.msi` and `ViewReferenceRobot-Setup.zip` at https://ibrooni.com/downloads/
- **Landing Page:** https://ibrooni.com/view-reference-robot.html

### 5.4 How it works
1. Pick Source and Target views in a browser-style dialog, or load a pair text file.
2. Each source view is opened and every Matchline (`OST_Matchline`) is collected.
3. A click point is offset from the Matchline midpoint (default 2 feet; right, left, or toward view center).
4. The built-in Revit View Reference command is posted; the Target View is selected in the Options Bar; the click is placed automatically.
5. Do not move the mouse or keyboard until the results dialog appears.

### 5.5 Installers and auto-update
- Public MSI: https://ibrooni.com/downloads/ViewReferenceRobot-Setup.msi
- ZIP of that MSI (Windows SmartScreen fallback): https://ibrooni.com/downloads/ViewReferenceRobot-Setup.zip
- Wizard: Welcome → License → single user vs entire system → Revit year checkboxes 2020–2027.
- Silent auto-update: `ViewReferenceRobot-update-net48.zip` for 2020–2024; `ViewReferenceRobot-update.zip` for 2025–2027. Payload-only (no loader, no `.addin`). Always Load appears after the first install only.

### 5.6 Pricing
- Until 31 January 2027: $0 for all users, no key.
- First 100 verified Ibrooni accounts: click Claim offer for a founder license (`ROBOT-XXXX-XXXX-XXXX`). The six months start on 1 February 2027 (until 1 August 2027), not on the claim date. New and existing verified accounts can claim while licenses remain. Remaining count out of 100 is shown on https://ibrooni.com/view-reference-robot.html and the account dashboard.
- After 31 January 2027: founder keys remain valid until they expire. Other users will need a later license.
- Account: https://ibrooni.com/account.html — confirm Mail ID from info@ibrooni.com, then Claim offer. API: GET `/api/account/robot-offer` (remaining/claimed/cap), POST `/api/account/claim-robot-offer` (JWT, verified).

---

## 6. Product: Avoid MEP Clash

### 6.1 Summary
Avoid MEP Clash reroutes straight pipes, ducts, and cable trays around obstacles in Autodesk Revit. Select a run near a clash; the tool stays active until Esc.

### 6.2 License
- 30 days free for everyone from first launch (`%ProgramData%\Birooni\avoidmepclash-trial.txt`).
- After 30 days, a verified Ibrooni account receives a perpetual `CLASH-XXXX-XXXX-XXXX` key. Paste it in Settings.
- 2023 build: Revit 2020–2024. 2025 build: Revit 2025–2027.

### 6.3 Installers and auto-update
- MSI: https://ibrooni.com/downloads/AvoidMepClash-Setup.msi
- ZIP: https://ibrooni.com/downloads/AvoidMepClash-Setup.zip
- Loader: `Birooni.AvoidMepClash.Loader.dll` (Always Load at install only)
- Updates: `AvoidMepClash-update.zip` (net8) and `AvoidMepClash-update-net48.zip`

## 7. Cryptographic Licensing Engine Specifications

- **Provider:** Birooni Licensing Infrastructure (`Birooni.Licensing.Api`).
- **Algorithm:** RSA-2048 SHA-256 with PKCS#1 v1.5 padding.
- **Device Fingerprinting:** Deterministic SHA-256 hash derived from:
  - Motherboard Serial Number (`Win32_BaseBoard.SerialNumber`)
  - CPU Processor ID (`Win32_Processor.ProcessorId`)
  - Windows Machine GUID (`HKLM\SOFTWARE\Microsoft\Cryptography\MachineGuid`)
- **Offline Token Storage:**
  - BiruBox: `%ProgramData%\Birooni\license.lic`
  - Family Loader: `%ProgramData%\Birooni\familyloader.lic`
  - View Reference Robot: `%ProgramData%\Birooni\viewreferencerobot.lic`
- **Trial Policy:** 14-day full access, automatically provisioned upon first startup. Trials are scoped independently per product.
- **License Tiers (Per Product):**
  - **14-Day Free Trial:** $0 (Automatic hardware activation, full feature access)
  - **Perpetual Pro:** $149 one-time (Lifetime usage, node-locked, 1-year free updates included)
  - **Enterprise Floating:** $299 / seat / year (Concurrent network license pool, central admin dashboard)

---

## 8. Contacts & Official Links
- General Support: info@ibrooni.com
- Sales: sales@ibrooni.com
- Main Site: https://ibrooni.com
- Vertical Host Placer Page: https://ibrooni.com/vertical-host-placer.html
- Family Loader Page: https://ibrooni.com/family-loader.html
- Biruscan Page: https://ibrooni.com/biruscan.html
- View Reference Robot Page: https://ibrooni.com/view-reference-robot.html
- Admin Portal: https://admin.ibrooni.com
- API Documentation: https://api.ibrooni.com/swagger