For security, never use a USB drive or files from untrusted sources. If in doubt, contact your IT department or Beacon Support.
What are magic scripts?
Magic scripts, also referred to as magic files, automate commands that a person typically would have to execute from a terminal. For Universal Robots, a magic script is a Bash shell script denoted by the .sh file extension. The magic script is made available to the robot by saving the magic file to a USB drive then inserting the USB drive into the robot.
What can magic scripts do?
Magic scripts can do many things. They can back up files from the robot, copy files to the robot, collect diagnostics, install software, and much more. A magic script can do just about anything that can be programmed in a Bash shell script.
For example, the Beacon Diagnostics Magic Script collects logs and information that helps Beacon Support troubleshoot robot issues.
Who creates magic scripts?
Generally, the Universal Robots Support team and the Beacon Support team develop magic scripts to help customers administer their robots. Though technically anyone comfortable with programming Bash shell scripts can create them, too.
Where do I get a magic script?
Magic scripts are most often available for download online or shared with customers through official support channels, such as Beacon Support in-app via Intercom.
How do I use a magic script?
To use a magic script:
Download the magic file to your computer or laptop.
Format a USB drive (only has to be done once).
Save the magic file to the USB drive.
Note, do not save the file under a folder. Magic files must be at the top level.
Insert the USB drive into a USB port on the robot's teach pendant, controller, or button box.
Once inserted, any magic scripts saved to the USB drive (and that are not in a folder) will execute automatically, and in sequence. Look for messages to appear in big letters on the teach pendant to let you know that the magic script is running.
To ensure smooth operation and to avoid confusion, we recommend having only one magic script at a time saved to the USB drive.