User Guide

Catfish Tools Tutorial

Revit productivity toolkit integrating automated workflows, standardized component libraries, and intelligent drafting. Reduce repetitive work, improve collaboration efficiency, and ensure drawing quality and design intent consistency.

Catfish Tools Quick Start →

Catfish Family Library Tutorial

Cloud-based family library manager supporting soft furnishing, hard finishing, detail, and custom categories. Drag-and-drop directly into your project with render textures preserved for consistent design outcomes. Visual interface replaces traditional Project Browser for smoother workflows.

Catfish Family Library Quick Start →

Catfish Keel Tutorial

One-click generation of multiple decorative construction node types, precisely matching finishing and keel requirements. Adapts to design changes while ensuring standardization and design intent alignment. Supports clash detection to optimize construction workflow and improve efficiency.

Catfish Keel Quick Start →

Catfish Cloud Tutorial

Catfish Cloud is a cloud-based central file collaboration platform designed for BIM/engineering modeling and team project collaboration.

Catfish Cloud Quick Start →

Installation · Activation · Troubleshooting

1. Special Privileges
   Sponsoring developers can contact via WeChat liuyanhu001 for priority feature development rights.

Bilibili video demos → Catfish Tutorials (opens new window)

Plugin Not Working / Commands Unusable - Troubleshooting Guide

When Revit plugin commands fail or cannot be used normally, follow these steps for systematic troubleshooting.

🔍 Troubleshooting Steps

1. Input Method Compatibility

Problem Description: When opening the plugin, especially tools that need to load default families, if families require version upgrade, Revit may freeze and become unresponsive.

Solution:

• Configure as follows

2. Plugin Conflict Check (Most Common Cause)

Problem Description: Installing too many plugins, especially those with similar functionality or from different developers, may cause resource contention, command override, or direct conflicts.

Solution:

• Navigate to C:\ProgramData\Autodesk\Revit\Addins and clean up the corresponding plugin addin files, temporarily disabling non-essential third-party plugins one by one.
• Test the failed command after each plugin is disabled.
• If a conflict source is found, contact that plugin's developer for a solution, or choose to permanently disable it.

3. Template File Issues

Problem Description: The currently used project template file may be corrupted, have chaotic settings, or contain non-standard content affecting normal plugin operation.

Solution:

• Use Revit's default architectural template.
• Test the same plugin command in the new template.
• If the command returns to normal, the original template file has issues. It's recommended to clean up or rebuild the template.

4. Software Installation Issues

Problem Description: Incomplete Revit installation, corrupted or missing core files.

Solution:

• Repair Installation: Via Control Panel → "Programs and Features" → Find Revit → Select "Repair".
• Reinstall: If repair doesn't work, completely uninstall the current Revit and reinstall a complete, reliable installation package.

5. Plugin Defects (Bugs)

Problem Description: The plugin itself contains programming errors.

Solution:

• Confirm you're using the latest version of the plugin.
• Report the detailed problem description (including steps, Revit version, error screenshots, etc.) to the plugin developer.

📋 Recommended Troubleshooting Flow

Follow this order for the most efficient troubleshooting:

1. Priority Test → Check if it's a family upgrade causing freeze.
2. Priority Test → Test plugin commands in the default template.
3. Core Check → Use elimination method — disable other plugins, check for plugin conflicts.
4. Check Updates → Ensure the plugin is the latest version and contact the developer for feedback.
5. Last Resort → Repair or reinstall Revit.

💡 Notes

• Only make one change at a time to accurately locate the issue.
• Record the troubleshooting process for providing detailed information to the developer.
• Regularly clean up infrequently used plugins to reduce conflict probability.

If none of the above methods resolve the issue, please contact official plugin technical support promptly.

Installation & Uninstallation

Close all running Revit instances before installing or uninstalling.

Installation

Before installing the plugin, confirm that a supported version of Revit (2018-2026) is installed.

Click to download the latest installer

Overwrite Installation

Users who already have an older version installed can directly use the new installer for overwrite installation — no need to uninstall the old version.

From Install to completion, it will be installed to the previous version's installation directory.

Plugin Not Loading

If the plugin fails to load, first check if 0_Catfish.addin exists at the following path:

C:\ProgramData\Autodesk\Revit\Addins\2027

If it exists but still doesn't load, copy it to the following path:

C:\Users\Administrator\AppData\Roaming\Autodesk\Revit\Addins\2027

Replace the path according to your computer's username.

Uninstallation

Open "Programs and Features" in Control Panel, find the plugin to uninstall, right-click and select Uninstall.

Navigate to C:\ProgramData\Autodesk\Revit\Addins and clean up 0_Catfish files in each version's addin folder.

Note: Clean up all 0catfish files across all versions (the name may change later, but the main identifier is "catfish").

Registration & Activation

1. After installing the plugin, a login window will appear when the software is first opened. You can register your own username and password. This login is only for plugin functionality. If you don't need to use the plugin, you can close the login window directly. When you need to use the plugin, reopen the software and log in.

2. After login, no re-login is needed for 24 hours.

Unauthorized icons appear gray; after authorization, they regain color for normal use.

Enter the activation code in the family library panel to activate.

The authorization code displayed in the popup is the code bound to the current computer (display only). You must enter the authorization code in the field below to activate.

How to get an activation code:

Add WeChat liuyanhu001 to purchase.

Lifetime users support computer rebinding.