Add README.md
This commit is contained in:
parent
50b299964e
commit
c390750b24
|
@ -0,0 +1,77 @@
|
||||||
|
# Revit UI Reset Tool
|
||||||
|
|
||||||
|
This repository provides a PowerShell script (`ResetRevitUI.ps1`) to reset the user interface settings for Autodesk Revit. It allows you to automatically close Revit, rename the `UIState.dat` file (which stores the UI settings), and relaunch Revit with default UI settings.
|
||||||
|
|
||||||
|
## Repository
|
||||||
|
|
||||||
|
- Git URL: [https://git.nixc.us/colin/revit-ui-reset/](https://git.nixc.us/colin/revit-ui-reset/)
|
||||||
|
- Raw script file: [ResetRevitUI.ps1](https://git.nixc.us/colin/revit-ui-reset/raw/branch/main/ResetRevitUI.ps1)
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- **Automatically closes Revit** if it is running.
|
||||||
|
- **Renames the ****`UIState.dat`**** file** to reset Revit UI settings.
|
||||||
|
- **Relaunches Revit** with default settings, making it easier to troubleshoot UI issues.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
|
||||||
|
- Windows operating system.
|
||||||
|
- Autodesk Revit 2024 (or other recent versions).
|
||||||
|
- Administrator privileges to run the script.
|
||||||
|
|
||||||
|
### How to Use
|
||||||
|
|
||||||
|
1. **Download the Script**
|
||||||
|
|
||||||
|
- Visit the following link to download the script directly: [ResetRevitUI.ps1](https://git.nixc.us/colin/revit-ui-reset/raw/branch/main/ResetRevitUI.ps1)
|
||||||
|
- Save the script to a known location on your computer (e.g., Downloads folder).
|
||||||
|
|
||||||
|
2. **Run the PowerShell Script**
|
||||||
|
|
||||||
|
- Open PowerShell with Administrator privileges:
|
||||||
|
- Press `Windows + S`, type "PowerShell", right-click on **Windows PowerShell**, and select **Run as Administrator**.
|
||||||
|
- Navigate to the directory where you saved the script. For example:
|
||||||
|
```powershell
|
||||||
|
cd "$env:USERPROFILE\Downloads"
|
||||||
|
```
|
||||||
|
- Execute the script:
|
||||||
|
```powershell
|
||||||
|
.\ResetRevitUI.ps1
|
||||||
|
```
|
||||||
|
|
||||||
|
The script will:
|
||||||
|
|
||||||
|
- Close any running instance of Revit.
|
||||||
|
- Rename the `UIState.dat` file to `UIState.dat.bak`.
|
||||||
|
- Relaunch Revit.
|
||||||
|
|
||||||
|
### Undoing the Changes
|
||||||
|
|
||||||
|
If you want to undo the changes made by the script:
|
||||||
|
|
||||||
|
1. **Close Revit** if it is running.
|
||||||
|
2. **Rename the ****`UIState.dat.bak`**** file** back to `UIState.dat`:
|
||||||
|
- Navigate to the folder `%APPDATA%\Autodesk\Revit\Revit 2024` (or the relevant version).
|
||||||
|
- Find the `UIState.dat.bak` file.
|
||||||
|
- Rename it back to `UIState.dat`.
|
||||||
|
3. **Relaunch Revit**.
|
||||||
|
|
||||||
|
### Notes
|
||||||
|
|
||||||
|
- Make sure Revit is not running important unsaved projects before running the script, as it will forcibly close Revit.
|
||||||
|
- The script will attempt to find the latest version of Revit installed by looking in the `%APPDATA%` folder.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
|
||||||
|
|
||||||
|
## Contributions
|
||||||
|
|
||||||
|
Contributions are welcome! Feel free to submit a pull request or open an issue to suggest improvements or report bugs.
|
||||||
|
|
||||||
|
## Contact
|
||||||
|
|
||||||
|
For any questions or suggestions, please contact [Colin](mailto\:colin@example.com).
|
||||||
|
|
Loading…
Reference in New Issue