39
User_Manual_RP3001k.doc
Advanced Scripting Information
Folder (directory) Path References in Script Files
Organizing your slideshows and media into folders is convenient and helpful but requires attention in script file
writing. All paths in scripts are relative to the directory that the main script file resides in, i.e. the DF-1710
assumes that the script and media are all in the same folder. If your media files are in the same directory
(folder) as your script file, then no paths need to be specified in the script file. If a script file references media
in other folders, the path to the media file needs to be specified in each script line referencing that media file.
To reference a media file in a directory other than the directory in which the script file resides, you must
specify a path relative to the directory in which the script file resides.
To reference a media file in a subfolder of the folder in which the script file resides, you add a “/” character for
each level of folder nesting. For example if your images are stored in a folder called “pictures”, which is inside
the folder that contains your script file like this
digi-frame root/
myscript.txt
pictures/
picture.jpg
your script file would reference the file picture.jpg inside the directory “pictures” as follows:
pictures/picture.jpg
To reference a media file in a directory entirely outside the one your script file is in, you need to use “../” to go
up as many levels as required, then “/” to go back down levels as required. For example, if your script file is in
a folder called “myshow”, which is at the digiframe root directory level, and you want to access a file called
picture.jpg which is in a folder called “pictures”, also at the digiframe root directory level, like this
digi-frame root/
myshow/
myscript.txt
pictures/
picture.jpg
your script line would look like this:
../pictures/picture.jpg
The “../” takes you out of “myshow” and up to the root directory, then the “pictures/” gets you down into
“pictures”.
The path rules as described above apply to all media types directly referenced by script files.
The rules regarding paths to MP3 files in playlist files are the same as those described above, but only if the
MP3 files are stored locally on the DF-1710 and not fetched from a remote server. If a playlist references
remotely-fetched MP3 files, then the internet URL must be specified for each MP3 file, e.g:
http://www.myserver.com/frame0001/song1.mp3
http://www.myserver.com/frame0001/song2.mp3
etc....
