38
User_Manual_RP3001k.doc
9. Script Files and Slideshows
Basic Information About Script Files
The DF-1710 gets its information about the order and timing of media items to be played and any other special
instructions by means of text script files, either created by you and uploaded to the Digi-Frame via ethernet, or
automatically generated by the Digi-Frame when a CD-ROM or memory card is inserted. Using the on-screen
menu system and the remote control or control buttons you can select from among various script files present
on the DF-1710’s internal hard drive.
Script files are standard text files that can be created with Windows Notepad or, on Macintosh, with SimpleText
or other text editor such as BBEdit Lite from Bare Bones Software. In its simplest form, the scriptfile is simply a
list of media items, each one on a separate line, such as:
music.mp3
picture1.jpg
movie1.mpg
picture2.jpg
The DF-1710 processes the script file line-by line, displaying items in the order they are mentioned in the
scriptfile. Any invalid script lines or script lines referencing media items that cannot be found will be ignored.
When Digi-Frame reaches the end of the scriptfile, one of two things will happen:
•
If at least one item in the scriptfile was played successfully, the Digi-Frame will start playing the
scriptfile again from the beginning.
•
If no items in the script file could be played successfully, the Digi-Frame will halt with the message
“Slideshow or Media Error”. You can clear this error condition by selecting another slideshow, or by
correcting the script or loading missing media files and reselecting the script file.
The DF-1710 uses the current default settings for playback options (slide pause time, transition effect, etc.) as
set by the menu system unless they are overridden by specific options in the script file. See the Advanced
Scripting Information section of this manual to learn how to specify your own options that will override the
defaults.
Important Rules Regarding Script Files
•
Filenames as typed in script files must be identical to the actual filenames in all respects, including
upper/lower case - “picture.jpg” is not the same as “picture.JPG”
•
Filenames and directory (folder) names must not contain special characters such as #, &, ;, :, |, <, >, “,
and , .
•
Script files must have an extension of “.txt”.
•
Files referenced in script files are assumed to be located in the same directory as the script file. If you want
to reference media in other directories you must add path specifications to your script lines as described
elsewhere in this manual.
•
MP3 playlist files must use DOS end-of-line characters. Playlist files generated with the Macintosh text
editor SimpleText will not work!
