Documentation · BIMO 1.0.0 Autodesk® Revit® 2021-2027

BIMO help

Version 1.0.0 for Revit 2021-2027. Press F1 on any BIMO ribbon button to open the matching section of this page. Every BIMO window also has a ? button that explains the buttons on that screen.

Before you start

Open the project that owns the walls and floors to be cut, with your MEP models linked in and loaded. Revit cannot cut elements that live inside a linked file, so BIMO only cuts this project's own walls and floors. The ribbon gains a BIMO tab with three buttons: Openings, Review and About.

Openings - find and create

BIMO > Openings runs the whole workflow: choose what to scan, set your clearances, scan, review the proposed openings, and create the ones you approve. Nothing is created until you press one of the Create buttons.

  1. Click BIMO > Openings. The scan settings window opens.
  2. Choose the hosts, links and service categories, and check the clearances (see Scan settings).
  3. Press Scan. A progress bar appears and can be cancelled at any time.
  4. Check the proposed openings in the review list, then create them.
  5. Check a few openings in section, not only in plan - an opening can sit in exactly the right place and still not cut.

Scan settings

These settings decide what is searched and how each opening is sized. They are grouped on three tabs.

What to scan

Host elements
Walls, floors or both. Only this project's own hosts are searched, because Revit cannot cut inside a linked file.
Linked models
The links searched for services. An unloaded link cannot be read and is skipped.
Services
Categories to look for. Pipes, ducts, cable trays and conduits are on by default. Fittings, accessories and flexible runs genuinely need openings too, but produce more rows to check.

Clearances

Clearance profile
A named set of these settings, saved in your profile folder and reusable across projects. Save profile writes the current values under a name.
Base clearance
Added all round the measured penetration, in millimetres. Used for anything bigger than every size band.
Size bands
Smaller clearances for smaller services, written as size:clearance pairs separated by semicolons. 100:50; 300:75 means services up to 100 mm get 50 mm, and up to 300 mm get 75 mm.

Grouping and sizing

Merge gap
Services whose clearances come within this distance share one opening. Grouping is chained, so a run of pipes joins up through its neighbours.
Maximum grouped opening
A group that would exceed this splits back into separate openings instead of becoming one oversized hole. It never suppresses a single large service.
Round sizes up to
Rounds each finished opening up to a modular increment. Applied after grouping, so it never changes which services are grouped.
Smallest opening
Openings are never created smaller than this, whatever the service size.
Extend the void past each face
How far the cut runs beyond both faces of the host. A void exactly as deep as the wall leaves coincident faces, which Revit cuts unreliably.
Ignore penetrations shallower than
Discards services that only graze a host, such as a pipe clipping a corner.
Ignore services running along the host
Separates a real penetration from a service chased along inside a wall. A service crossing a wall leaves a footprint about as long as the wall is thick; one routed inside it leaves a footprint metres long. Anything longer than its own width plus this many host thicknesses is skipped and listed in the warnings. Leave it at 4 unless you have unusually raked services; set it to 0 to turn the check off.
Opening shape
Whether a lone round service gets a round opening. Grouped openings are always rectangular.

The review list

After a scan, every proposed opening is listed with its status, level, host, services, shape and size. Nothing has been created yet. The window stays open, so you can work through a large list in batches and move around the model while you do.

Single click
Selects that row's opening or host in the model, leaving your current view alone.
Double click
Frames the row in the BWO Preview 3D view with a section box around it. One view is reused however many rows you open.
Ticks
Decide what Create all ticked acts on. New and moved openings are ticked for you; orphans never are, because deleting is the one action that destroys work.
Tick all / none / Only new
Bulk tick actions. Only new leaves updates and orphans unticked. Rows already done are never re-ticked.
Tick / Untick highlighted
Applies the tick to the highlighted rows. Use Ctrl and Shift to highlight many at once.
Select hosts
Selects the walls and floors behind the highlighted rows in the model.
Create highlighted
Creates only the highlighted rows, whatever is ticked, and keeps the window open.
Create all ticked
Creates every ticked row, with a progress bar. Cancelling stops cleanly and keeps whatever was already made.
Status column
New: no opening exists yet. Moved / resized: the services changed. Unchanged: already correct. Orphaned: its services are gone from the link. Once applied, a row reads Created, Updated or Deleted and is excluded from further runs.
Skipped items and warnings
Services deliberately not given an opening, and why - curtain walls, services running along a host, elements owned by another user in a workshared model. Nothing is ever dropped silently.
The review list belongs to the project it was scanned in. If you switch to another open project, BIMO will ask you to switch back before creating or deleting anything.

Review - openings in the model

BIMO > Review lists every opening BIMO has created in this model, read directly from the model - so it stays correct after manual edits or an undo.

Filters and search
Narrow the list by level, host type or run. Grouped only shows openings serving more than one service. Search matches any column.
Not cutting a host
Shows openings positioned correctly but not actually cutting - they look finished in plan and leave the wall solid. Fix them with Repair cuts.
Single click / double click
Select the opening in Revit / frame it in the BWO Preview 3D view.
Show in view
The same as double-clicking the row.
Select in model
Selects every chosen opening in Revit at once.
Export report
Writes what is currently listed to CSV - element id, level, host, size, services and X/Y/Z position in millimetres - for issuing to the structural team. Filter first to issue a subset.
Repair cuts
Makes openings that are not cutting their host cut it. Positions, sizes and tracking data are untouched. Works on your selection, or on everything listed.
Delete selected
Removes the chosen openings and closes the holes they cut. This is a normal Revit transaction, so Ctrl+Z undoes it.
Refresh
Re-reads the openings from the model.

When the MEP model changes

Reload the link and run BIMO > Openings again. Each opening remembers the services and the wall or floor it was created for, so the list comes back marked New, Moved / resized, Unchanged or Orphaned. Approve what you want changed. Orphans are never selected for you, and openings in hosts or links you did not scan are left alone.

About, licence and support

BIMO > About shows the version, the Revit release it was built for, and contact details. Include the version in any support request.

Licence

BIMO is licensed through the Autodesk App Store to the Autodesk account that bought it. When you first use it in a Revit session it confirms your licence with Autodesk, using the account you are signed in to Revit with.

MessageWhat to do
Sign in to your Autodesk accountSign in to Revit (top right of the Revit window) with the account that bought BIMO, then try again.
This copy is not licensed yetThis account has no licence. If you have just bought BIMO, sign out of Revit and back in so the purchase is picked up.
Your licence could not be confirmedBIMO could not reach Autodesk and has no recent confirmation on this computer. Connect to the internet once; after that it works offline for 14 days.

The check sends only your Autodesk account identifier and BIMO's store id to Autodesk. See the privacy policy.

Support

Email info@xplus-studio.com, Sunday to Thursday, 09:00-17:00 Cairo time (UTC+2). We aim to reply within two business days. Please include:

  • the BIMO version, from BIMO > About;
  • your Revit version and build;
  • what you were doing when it happened;
  • anything listed under Skipped items and warnings;
  • the exact text of any message BIMO showed.

For questions about sizing or grouping, the CSV from BIMO > Review > Export report is the quickest way for us to see what the tool produced. Please do not send project files unless we ask for one.

Installing and uninstalling

Close Revit, then install BIMO from its page on the Autodesk App Store. The store's installer puts BIMO in Autodesk's standard add-in location (%APPDATA%\Autodesk\ApplicationPlugins\BIMO.bundle, or %ProgramData%\Autodesk\ApplicationPlugins when installed for all users, which asks for administrator rights). One package covers Revit 2021-2027; each version of Revit loads its own build. Installing a newer version replaces the older one.

To uninstall, use Windows Settings > Apps (or Control Panel > Programs). All program files are removed. Your clearance profiles and generated opening families in %APPDATA%\BIMO are kept, because they are your settings; delete that folder by hand to remove them. Openings already created belong to your model and are not affected - remove them first with BIMO > Review if you want them gone.

Troubleshooting

No BIMO tab after installing
Restart Revit, and check that your Revit version is 2021-2027. If you installed for your own Windows user only, BIMO appears only when that user runs Revit.
"The publisher of this add-in could not be verified"
Revit shows this the first time it loads an add-in whose publisher certificate it cannot verify. Choose Always Load to stop it appearing again, or Load Once to be asked each session. A version signed with a certificate from a public certificate authority will remove this prompt.
An opening is in the right place but the wall is still solid
Open BIMO > Review, tick Not cutting a host, and press Repair cuts.
"The opening families could not be created"
BIMO builds its families from Revit's Generic Model face based template. Check that Revit's family templates are installed and that the template path in Revit's options is correct.
"This list belongs to another project"
Switch back to the project the list was made for, or close the window and run the command again in the project you want.
A service has no opening
Open Skipped items and warnings in the review list: it says why each service was skipped.

Known issues

  • Curtain walls are not supported. Openings in a curtain system are made by editing panels and mullions, so curtain walls are skipped and reported.
  • A service crossing several hosts gets one opening in each. At a wall junction this can give two adjacent openings a detailer may prefer to combine by hand.
  • Services through curved walls are never grouped with each other; each gets its own opening.
  • On a sloped floor whose type reports no structure thickness, the slab's bounding height is used. Check very steep slabs.
  • The review list after a scan cannot be filtered in this release. Filtering and export are available in BIMO > Review.