Many of Vuo’s
Fetch nodes take a URL as input. These nodes can either load a file from the local system, or download a file from an Internet server.
To download a file from the Internet, copy the file’s URL from your browser. Example:
To load a file on the computer running the composition, create a URL from the file’s path. Examples:
DefaultDesktop.jpg(for a file called “DefaultDesktop.jpg” in the same folder as the composition)
images/DefaultDesktop.jpg(for a file called “DefaultDesktop.jpg” in a folder called “images” in the same folder as the composition)
If the file’s location doesn’t start with
/, then it’s treated as a relative path. This is the option you’d typically want when sharing the composition with others. If running the composition on a different computer than it was created on, the file needs to exist in the same location relative to the composition (
.vuo) file. If running an application exported from the composition, the file needs to exist in the
Contents/Resources folder inside the application package; see the Vuo Manual for details.
If the composition hasn’t been saved yet, paths are interpreted relative to the Desktop.
If you drag a file from Finder onto a URL port, Vuo will use a relative path to the file.
If the file’s location starts with
/, then it’s treated as an absolute path. If running the composition on a different computer than it was created on, the file needs to exist in the same location on that computer. To get the file’s path in the correct format, open the TextEdit application, go to Format > Make Plain Text, drag the file onto the TextEdit window, and copy the path that appears in the TextEdit window.
If you drag a file from Finder onto a URL port while holding Option, Vuo will use the file’s absolute path.
You can embed images and other data directly into a Vuo composition (without requiring any external files or web servers) by using the
data: URI scheme. For example, if you paste this into the
Fetch Image node’s URL port:
…it will output a red dot.
To convert a file into a Data URI, you can either use a web-based conversion tool such as dataurl.net, or launch Terminal.app and enter this command:
echo -n 'data:;base64,' ; base64 <path to image file> then paste the output into one of Vuo’s URL ports.