DJB Radio Spider 3 User's Guide
×
Menu
Index

Edit\Add Item

 
 
Each item is edited via this dialog, by selecting an item in the main screen grid, and either double-clicking on it, using the right mouse button and selecting ‘Edit Item’, or clicking on the ‘Edit Item’ button below the grid.
 
You can review the field and get on screen help information (right side, ‘Instructions and Hints’). You can toggle between the Field Descriptions and Macro information by clicking the View Macro Help button (which then becomes ‘View Edit Help’).
 
Here are some key points in using the editor:
 
·     Description: Each item requires a description to separate it from the others.
 
·     Additional Notes/Comments is an area where you can make notes, store text to copy/paste and generally use for your information.
 
·     The Protocol Settings section of the dialog displays different entries for different protocols. For example, Email and SFTP will require a port number, and File Copy will display a Browse button to search for the directory from which to copy. Some fields can be left empty (like username and password for the HTTP selection). When you save the entry, the program will check the entry and warn you about errors in the entry.
 
Each location has a unique prefix, which should be used for the transfer (except email and local files, which is a full directory path):
 
HTTP: http://    HTTPS: https://    FTP: ftp://    SFTP: sftp://    FTPS: ftps://
 
For each of the protocol settings, here are the options:
·     HTTP and HTTPS can copy individual files from a known URL.
You cannot copy directories or use wildcards UNLESS it is a directory that provides a directory list (called a server directory listing) – in that case, with a listing of the current directory, 
the program can use wildcards to gather files.
·     HTTP and HTTPS can use a username and password to log into a protected site to get a file.
Whether you can download a single file or multiple files again depends on whether the server provides directory listings.
·     FILE COPY is a straightforward copy from one file (or directory) to another.
The program uses a file path for copying, which means if you are copying over a network,
it is best to map the drive onto a local drive letter, and use that for your copy source directory.
·     Download Changed File(s) Only: If checked, only files that have changed since the last run
(different file timestamp or size) are downloaded or copied.
·     Clear Changed Files Cache: When the changed files checkbox is set, a cache is used to track changes.
Clearing the cache resets this, allowing all files to be downloaded/copied the next time the item runs.
 
·     FTP is a directory-based protocol, so you can download individual or multiple files. 
The settings Non-basic authentication, Passive Mode, and Anonymous depend on the destination server. 
Passive Mode is a way of connecting to a server through a firewall. 
It is rare for a computer today to be connected directly to the Internet, so you will likely always select Passive Mode
Non-basic Authentication is a setting on your computer, and varies from system to system.
The easiest solution is to leave it unchecked, and if FTP doesn't work, turn it on. 
Anonymous should only be checked if the provider specifies the FTP allows anonymous connection. 
Then you generally use "anonymous" for the username and your email address for the password.
 
·     SFTP  is a secure file transfer protocol using SSH.
Generally, it is run over port 22, but you can change it depending on your server via the Port field.
 
·     FTPS   is a secure file transfer protocol using SSL.  It is usually run on port 990. 
It offers a choice of SSL, AuthTLS, or AuthSSL security.
 If the provider doesn't specify you can try SSL first and try the others if it does not work.
·     EMAIL is a protocol to check your email for attachments, and download specific ones, creating a list of files to transfer.  Unlike the other protocols, there is no  URL; instead, you include a POP server name, an email address, and  a password. 
You will also need to specify a port.
 
For example, Gmail accounts will use pop.gmail.com for the server name, and port 995. 
It will also need the Use Secured POP3 Login box checked, as it is a secured protocol.
 
Optionally, you can also check the box to Delete emails after reading (which only deletes the ones actually read and unpacked).  Gmail does not support this feature.
 
Another feature is to download links or attachments, via the “Download via msg links...” checkbox. 
If left unchecked, attachments are downloaded and converted as files;  if checked, links within the email are checked instead and http:// downloads are performed on each.
 
Email also provides additional security features: A Keycode or From: Email field is provided, which can either be a password or random keycode text string (which must appear somewhere in the ‘Subject:’ field of an email for the attachment to be downloaded and unpacked), or a ‘From:’ email address – in the latter case, only emails from this address are read, and downloaded/unpacked if attachments are found. 
 
Note the From address can be a full email address like me@gmail.com, or only an email domain, like @myhome.com – this allows emails to be filtered to a single address or anyone sending from a specific domain.
 
NOTE:  Since Spider will read every email looking for the Keycode or specific From: email address, it is strongly recommended to create a new email to use with Radio Spider. 
 
 
·     EMAIL (WESTWOOD) adds a box to include the domain name URL to match the links in the email from Westwood One.  This protocol only checks the links and does not check attachments.
All other settings are the same as Email above.
·     CLOUD allows you to download files from a DropBox account or Google Drive.  When you first set it up, you will need to click Add/Edit Account, select either the DropBox or Google tab, give the account a nickname and then click the Authorize button.  Dropbox will have you login to your account and provide a code to copy and paste into Spider.  Google will tell you the page is unsecured and you will have to go there anyway to authorize.  Once an account is authorized it will appear in the second dropdown box.  Then you can browse the directory structure the same way you would for an FTP site. 
 
NOTE: 2 step authentication from Google will make it so you can't use Google Drive or Gmail with Radio Spider - DO NOT agree to 2 step authentication when prompted by Google.
·     RSS feeds (ending in .xml) can include media files, such as podcasts. 
The program uses the RSS Feed URL to load in the whole feed, and then extracts/downloads any audio embedded there. You can limit the number of entries scanned to prevent loading too many files.  Enter the maximum entries to scan in Max RSS Entries Read.
 
 
 
 
 
·     URL can be a directory ending in '\' or '/' (in which case all files will be copied), or a single file name (only that file is copied).
Using wildcards:  M:\Audio\e*.* will copy all files starting with 'e', and with any extension, from directory M:\Audio\
You can also use the '?' character to represent any single character – for example, e?.mp3 would match e0.mp3, e1.mp3, but not e.mp3,
since there is no character between the e and the period.  Asterisk '*' replaces any number of characters.
 
·     Download Days refer to the day(s) that the event is considered active and will be run at the proper time.
For example, checking Daily will make the event run every day; checking Sunday, will run only on Sunday.
 
·     Download Time allows you to schedule when the item will run.  If you check Hourly and put 15 in the minutes box,
it will run at 15 minutes past the hour, every hour; it will run 24 times per day. 
If you don't check the hourly box, then the hour and minute boxes set the time that the event will run once per day.
 
·     Auto Advance Number {XXX} Macro: If you put the {XXX} macro in the filename the {XXX} will be replaced with the initial value,
then incremented by one after a successful download.  For example: file copy: M:\{XXX}.mp3 will copy 1.mp3, then 2.mp3, etc.
 
 
 
 
·     The Download To entry can be a file or a directory (which should have an '\' at the end). 
 
If you download to a directory, any and all files that are found are copied.
 
However, if it is a file name, then only the first entry will be copied, and renamed to that file – all others are ignored.
 
·     If any files copied end in .ZIP, they are unpacked and the files within are copied as well.
 
·     Download Method refers to how files are copied over.
Replace or Rename applies to what happens if a file of the same name is already in the destination folder:
 
Replace,the old file is deleted
 
Rename, the older file is renamed: for example, song.mp3 becomes song(0).mp3
(note that if song(0).mp3 exists, it is renamed to song(1).mp3, and so on for up to 21 files).
 
 Files can be converted using the Audio Conversion settings of the item, or they can be copied without any changes
(note the conversion only affects audio files – all other files are copied without changes).
 
·     MACROS enhance the usefulness of file copy, and can be used in the source path for all file transfers (except email, which does not use a file path). 
Some Macros can be used in the "Download To:" box as well.
 
For more information and some macro examples see MACROS
 
·     The Audio Conversions dialog presents you with a selection of editing options for the audio you download or copy. See AUDIO CONVERSION for more details.
 
The online help was created with Dr.Explain