; Configuration for dir2cast by Ben XO. http://www.ben-xo.com/dir2cast ; This is an 'ini' file. Lines beginning with ';' are comments. ; All of the settings are commented-out by default. To set them, remove ; the ';' at the beginning of the line. ; dir2cast will look in 2 places for this file. 1st, it will look in ; the same folder as dir2cast.php. 2nd, it will look in the same folder ; as your MP3s. ; If you only have 1 podcast, or your settings apply to every dir2cast ; podcast on your website, then this file should be placed in ; the same folder as dir2cast.php. ; If you have several podcasts being served from one copy of dir2cast, ; then you can make copies of this file with different settings and put ; them in the folders where your MP3s are. Then they will override ; the settings from the site-wide dir2cast.ini. ; N.B. Although most settings do not need double-quotes (" ") around them, ; it is safer to use them anyway. In particular, any setting with an ; ampersand (&) character will probably fail unless you use double-quotes. ; (e.g. a URL with parameters, or the iTunes Society & Culture category.) ; ***** GLOBAL SETTINGS *** usually OK to leave unspecified ****************** ; The following 3 settings are not mandatory because dir2cast should be ; able to figure them out for itself. Also, you can only specify them in ; the dir2cast.ini that is in the same folder as dir2cast.php. ; The full filesystem path to the MP3 folder ; Set this if you *do not* want the folder to be passed in the URL. ; (This defaults to the same folder as the script) ;MP3_DIR = "/home/ben_xo/public_html/my_mp3_folder" MP3_DIR = "/volume1/Podcasts/mp3" ; The base to look for folders if they are specified in the URL ; Set this if you *do* want the folder passed in the URL, but the passed ; folders are not subfolders of where you installed dir2cast.php. ; (This defaults to the same folder as the script) ;MP3_BASE = "/home/ben_xo/public_html/" MP3_BASE = "/volume1/Podcasts/" ; The URL of the MP3 folder ; This defaults to the directory of the script. ; dir2cast can usually work this out for you, but under some circumstances ; it will fail. If your MP3 URLs are all wrong, try putting this in manually. ;MP3_URL = "http://www.example.foo/my_mp3_folder/" MP3_URL = "https://24.44.179.204:8443/mp3/" ; Uncomment this if you want to check in every sub-folder for new files as well. ;RECURSIVE_DIRECTORY_ITERATOR = true ; *** INFORMATION ABOUT YOUR PODCAST - you SHOULD set this how you like it *** ; The copyright notice of the feed ; This defaults to this year (e.g. '2008') ; The string %YEAR% will be replaced with the current year. ;COPYRIGHT = "Ben XO (%YEAR%)" ; Webmaster of the feed. This must be an email address, ; and it should be in the format 'my@email.address (My Name)' ; This defaults to ITUNES_OWNER_EMAIL (ITUNES_OWNER_NAME) ;WEBMASTER = "me-dir2cast@ben-xo.com (Ben XO)" ; Name of the Owner of the podcast for iTunes ; This defaults to empty ;ITUNES_OWNER_NAME = "Ben XO" ; Email of the Author of the podcast for iTunes ; This defaults to empty ;ITUNES_OWNER_EMAIL = "me-dir2cast@ben-xo.com" ; URL of the feed's home page (this is NOT where the MP3s are! It is ; just the link to your "about" page). ; This defaults to the URL of the script or http://www.example.com/ ;LINK = "http://www.ben-xo.com/" ; The title of the feed. ; This defaults to the name of the directory you're casting ;TITLE = "My First dir2cast Podcast" ; The Author of the podcast for iTunes ; This defaults to whatever WEBMASTER is set to ;ITUNES_AUTHOR = "Ben XO" ; Categories for iTunes ; ; You may add as many as you like from the category list at ; https://help.apple.com/itc/podcasts_connect/#/itc9267a2f12 ; ; Here is an example which means "Both the 'Music' category and ; the 'Gadgets' subcategory of 'Technology' ; ; Please note that the entire setting must have double quotes ("") ; like in the example, otherwise categories with '&' in the name won't work ;ITUNES_CATEGORIES = "Music, Technology > Gadgets" ; Whether or not the feed contains explicit content. ; See https://github.com/simplepie/simplepie-ng/wiki/Spec:-iTunes-Podcast-RSS ; Valid values are "yes", "explicit", "true" or "no", "clean", "false" ; ; If you don't set this, it will not appear in the feed at all, and Apple ; Podcasts may reject your feed! ;ITUNES_EXPLICIT = "no" ; *** INFORMATION ABOUT YOUR PODCAST - the following can be set using text files *** ; Description of the feed ; ; This defaults to empty, or if the file 'description.txt' exists ; in the MP3 dir, or in the same dir as the script, that will be read ; and the contents used ; ; It's usually better to set this in 'description.txt' because you can ; write a whole lot more that way. ;DESCRIPTION = "My First Podcast" ; Subtitle of the feed for iTunes ; ; This defaults to DESCRIPTION, or if the file 'itunes_subtitle.txt' exists ; in the MP3 dir, or in the same dir as the script, that will be read ; and the contents used ;ITUNES_SUBTITLE = "Check it out! It's brilliant." ; Summary of the feed for iTunes ; ; This defaults to DESCRIPTION, or if the file 'itunes_summary.txt' exists ; in the MP3 dir, or in the same dir as the script, that will be read ; and the contents used ;ITUNES_SUMMARY = "i could go on for hours about how amazing this podcast is [...] etc" ; Image for the podcast ; ; This defaults to no image, or if the file 'image.jpg' exists in the MP3 ; dir, or in the same dir as the script, then the URL for that will be used. ; ; The image must be no larger than 144 x 400. ;IMAGE = "http://www.somewhere.com/podcast.jpg" ; Image for the podcast for iTunes ; ; This defaults to no image, or if the file 'itunes_image.jpg' exists ; in the MP3 dir, or in the same dir as the script, then the URL for that ; will be used. ; ; The image should be large enough to appear high quality in iTunes. ;ITUNES_IMAGE = "http://www.somewhere.com/podcast.jpg" ; Extra text for the 'iTunes Subtitle', which appears next to each episode ; ; Defaults to empty. The text will appear in the iTunes subtitle for each ; item of the podcast. For example, if you put an entire tracklist into the MP3 ; comment field, you could set this to ". Click here for tracklist -->", and ; the the subtitle will read ". Click here for tracklist -->" ; ;ITUNES_SUBTITLE_SUFFIX = "" ; Whether to output the and tags ; ; Set the tag. If you set this to "serial", it will ; use the content of the ID3 "TRCK" and "TPOS" fields (also known as ; "track number", and "part of a set" (or sometimes "disc number"), ; respectively, as content of the and tags. ; ; The TRCK and TPOS values should be non-zero positive integers (1, 2, 3, etc) ; ; NOTE: these are NOT used for ordering within the RSS feed. This is ; still done by file date so it's up to you to make the episode order ; and the file date order match by uploading them in season/episode order. ; ; The default value is "episodic", and no or ; tags will be output in the feed. ; ; If you don't want to appear in the feed at all, set this to "" ; ; Any value that is not "" or "serial" will be treated as "episodic" ;ITUNES_TYPE = "episodic" ; *** CHECK THESE ARE OK. *** ; Language of the feed ; This defaults to en-us (US English). This must be something recognised by ; the RSS standard. Apple Podcasts only supports values from the ISO 639 list ; (two-letter language codes, with some possible modifiers, such as "en-us"). ; See https://www.loc.gov/standards/iso639-2/php/code_list.php ;LANGUAGE = "en-us" ; Where to cache RSS feeds (this must be writable by the web server) ; This defaults to a folder called 'temp' alongside the script ;TMP_DIR = "/tmp" ; Number of items to show in the feed ; This defaults to 10 ;ITEM_COUNT = 10 ; Format of the tag for each item. If this is set to 'false', ; then <title> will be set to the 'title' field in your ID3 tag. ; If this is set to 'true', then <title> will be set to ; 'album - artist - title' from your ID3 tag. ;LONG_TITLES = false ; Automatically extract cover images from the files in the feed so they ; can become the episode image. This will never overwrite a file that ; you uploaded manually, but if dir2cast doesn't have write permissions ; in your podcast folder then it will fail. So, then perhaps turn it off. ;AUTO_SAVE_COVER_ART = true ; *** THESE SHOULD BE LEFT AS THEY ARE - unless you have a good reason. *** ; Files must be at least this old to be included in the feed. If they are ; younger than this it might indicate that they are still being uploaded. ; ; Defaults to 30 seconds ;MIN_FILE_AGE = 30 ; Number of seconds for which the cache files are guaranteed valid; that is ; to say, if you generate a new feed, and then hit refresh a lot, it will ; not regenerate the feed again for at least this length of time. ; ; You can only specify this in the dir2cast.ini that is in the same folder as ; dir2cast.php. ; ; Defaults to 5 seconds ;MIN_CACHE_TIME = 5 ; Time-to-live (Expiry time) of the feed. This appears in the <ttl> tag, and ; is used by Podcast clients to determine if it is worth refetching the feed. ; Defaults to 1 hour (60 minutes) ;TTL = 60 ; The password to use on the 'force=<password>' part of the URL in order to ; force the RSS feed to be regenerated (bypassing and replacing the cached ; copy). If this is empty then this feature is disabled. ;FORCE_PASSWORD = ; If you want the script to write the RSS to a file instead of to stdout ; you can set OUTPUT_FILE. This is useful if your RSS takes a long time ; to generate and you would not ever want a podcast client to trigger a ; cache refresh. You probably would want to setup dir2cast.php so only ; You run it after adding new files to the directory. ;OUTPUT_FILE = OUTPUT_FILE = "/volume1/Podcasts/xml/feed.xml" ; If you want to change the type attribute on the atom:link element ; to something other than 'application/rss+xml' you can set it here. ;ATOM_TYPE = ; If you want the <description> tag for an item to come from the summary (auto- ; generated, or from a file with the same name with .txt extension) then ; set this parameter to 'summary'. Otherwise it will get its description from ; comment tag embedded in the file. ;DESCRIPTION_SOURCE = "comment" ; If you want to have HTML in your <description> tag set this parameter. ; Otherwise the content of the description will be escaped with htmlspecialchars() ;DESCRIPTION_HTML =