ADMIN & AUTOMATION

Script Hub.

Drop a Python file into a folder and it becomes a button on the Revit ribbon — then drag and drop to arrange tabs, panels and groups right in the window, and apply without restarting Revit.

01 · THE PROBLEM

Every team that writes Revit scripts hits the same three problems: getting scripts onto the ribbon where colleagues can click them, rearranging where the buttons sit as the script count grows, and knowing who ran what. The most common platform today ties ribbon layout to the folder structure on disk, so every presentation change becomes a rename or a file move.

đổi tên thư mục

Moving one button to another panel means editing the folder tree

Ribbon layout is locked to folder names, so moving a button means renaming or relocating the whole script folder, then reloading. Whoever maintains the library has to memorise a naming convention instead of seeing the layout.

khởi động lại

After editing the config you often have to close and reopen Revit to see it

Quitting Revit with a large project open just to see a button you added costs ten minutes every time you try something.

toàn quyền

Unfamiliar scripts run straight through, with no warning layer of the tool's own

A Python script running in the Revit process can modify the model, read and write files, and reach the network. If the tool never asks before running unfamiliar code, IT has grounds to block the whole platform.

02 · FEATURES

What it does

Script Hub only provides the platform — running scripts and managing where they sit on the ribbon — so the script library stays yours, wherever you keep it and however you write it.

A

Running scripts

  • IronPython 3.4.2 runs inside the Revit process; scripts reach doc, uidoc and app directly
  • Reads existing pyRevit libraries as-is: .pushbutton folders, bundle.yaml, icon.png
  • Also takes single .py files, with metadata read from the docstring
  • Reports errors as a real Python traceback with the line number in your file
B

Arranging the ribbon

  • Drag and drop to change tab, panel, group and order — the script folders stay untouched
  • Apply changes to the ribbon immediately, with no Revit restart
  • New files dropped into a folder still appear automatically, following the folder structure
  • Icons are generated when a script has none, and follow Revit's light and dark theme
C

Control and traceability

  • Three trust levels: run freely, warn, or only allow scripts inside trusted folders
  • Asks again when a script's contents change since you approved it, compared by hash rather than path
  • A log of every run: which script, launched from the ribbon or the window, how long it took, and the outcome
  • Disable a script from the ribbon without deleting the file; re-enable and it returns to the same button
TOOL INTERFACE · RUNNING IN REVIT

Operational interface and functional overview

The interface is matched to the tool window running in Revit.

MORE IN THIS GROUP