RvtIO 0.1.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package RvtIO --version 0.1.0
                    
NuGet\Install-Package RvtIO -Version 0.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="RvtIO" Version="0.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="RvtIO" Version="0.1.0" />
                    
Directory.Packages.props
<PackageReference Include="RvtIO" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add RvtIO --version 0.1.0
                    
#r "nuget: RvtIO, 0.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package RvtIO@0.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=RvtIO&version=0.1.0
                    
Install as a Cake Addin
#tool nuget:?package=RvtIO&version=0.1.0
                    
Install as a Cake Tool

<p align="center"> <img src="docs/images/rvtio-banner.png" alt="RvtIO" width="640"> </p>

RvtIO is a .NET library and command line tool that reads Autodesk Revit projects (.rvt) and families (.rfa) directly from disk, without Revit or the Revit API, and exports IFC and JSON.

What it does

  • Reads elements, parameters, geometry, file metadata and project information.
  • Queries elements through FilteredElementCollector.
  • Exports IFC2X3 coordination view, with optional Revit parameters as property sets.
  • Writes compact JSON or a full JSON dump with every parameter and geometry.

Install

Install the command line tool:

dotnet tool install --global RvtIO.Cli

Add the library to a .NET project:

dotnet add package RvtIO

The library targets .NET 8 and .NET 10. It uses managed code without native dependencies or Windows-only APIs and supports Windows, Linux and macOS. Tests currently run on Windows.

Command line

Export a project to IFC:

rvtio project.rvt project.ifc

Export compact JSON:

rvtio project.rvt project.compact.json --compact-json

Export full JSON, including every parameter and geometry:

rvtio project.rvt project.full.json --json-full

Export IFC with Revit parameters as property sets:

rvtio project.rvt project.parameters.ifc --ifc-revit-parameters

A .ifc output path selects IFC. Any other output path selects JSON, which is compact by default. If the output path is omitted, the tool writes output.json. Diagnostics go to standard error.

Use --ifc-revit-parameter-groups for one property set per parameter group. Run rvtio --help for all options. Unknown options exit with code 1; options starting with --dev- are not a stable interface.

Library

Open a project, list wall instances through FilteredElementCollector, and export the document to IFC:

using System;
using RvtIO;
using RvtIO.BuiltIns;
using RvtIO.Ifc;

var doc = RvtDocument.Open("project.rvt");

FilteredElementCollector walls = doc.Collector()
    .OfCategory(BuiltInCategory.OST_Walls)
    .WhereElementIsNotElementType();

foreach (var wall in walls)
{
    Console.WriteLine($"{wall.Id}: {wall.Name}");
}

new IfcExporter().Export(doc.RawData, "project.ifc");

The library is silent by default. Set RvtReaderOptions.DiagnosticOutput for reading or IfcExporter.DiagnosticOutput for export to receive diagnostics through a TextWriter.

See the public API for the supported surface and dependencies for package details.

Examples

IFC exports of sample models opened in an IFC viewer:

Revit 2022 sample project Revit 2025 sample project exported to IFC
Revit 2022 sample project Revit 2025 sample project exported to IFC

Supported files

Reads .rvt projects and .rfa families. Testing covers sample projects saved by Revit 2020, 2021, 2022, 2023, 2024, 2025 and 2026. Revit 2027 files open with partial support.

The tested projects include basic and advanced architecture, structure and MEP samples, plus several larger multi-discipline models.

Limitations

  • Version 0.1.0 is a preview. The API can change before 1.0.
  • Geometry coverage is partial for some element kinds.
  • Revit 2027 support is partial.
  • There is no support for writing or modifying Revit files.
  • IFC output is limited to IFC2X3 coordination view.
  • Output was compared with an independent reference exporter on the tested samples. Byte equality with Revit's own IFC export is not claimed.

Build from source and tests

Use the .NET SDK selected by global.json, which specifies 10.0.100 with latestFeature roll-forward.

From the repository root:

dotnet build RvtIO.slnx -c Release
dotnet test

Tests requiring real Revit files are skipped with a message unless RVTIO_TEST_FILES points to a folder containing the private fixtures. The repository includes no Revit models.

Optional test variables are RVTIO_REVIT_RESOURCES, for a copy of Revit resource DLLs used to re-verify the built-in name tables, and RVTIO_NATIVE_TABLE_DIR.

Contributing

See CONTRIBUTING.md and the Code of Conduct. Release changes are recorded in CHANGELOG.md.

Security

Report vulnerabilities through GitHub private vulnerability reporting in the repository's Security tab. Do not open public issues for security vulnerabilities. See SECURITY.md.

License and trademarks

RvtIO is licensed under the MIT License. Copyright holder: mahach666.

RvtIO is not affiliated with, endorsed by or sponsored by Autodesk. Autodesk and Revit are trademarks of Autodesk, Inc.

The file format is read by analysing files for interoperability. No Autodesk code or binaries are included.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on RvtIO:

Package Downloads
RvtIO.Scene

Turns a Revit project read by RvtIO into an IOScene scene document.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.6.3 74 11/20/2026
0.6.2 82 11/19/2026
0.6.1 75 11/19/2026
0.6.0 76 11/19/2026
0.5.1 109 11/19/2026
0.5.0 90 11/18/2026
0.4.0 391 11/13/2026
0.3.0 104 11/8/2026
0.2.0 99 11/4/2026
0.1.0 114 10/31/2026