dir2cast 1.4

Turn a directory of MP3 files into Podcasts.
dir2cast is designed to turn a directory of MP3 files into Podcasts. Perfect for, say, radio shows - upload the MP3s to a folder, and use dir2cast.php as your PodCast URL.

INSTALLATION

Please note: the config file will make more sense if you read all of this README

before trying the installation instructions.

Step 1. Edit dir2cast.ini to your taste.

Step 2. Upload dir2cast.php and dir2cast.ini to the web server.

Step 3. Upload getID3 to a folder called 'getID3'. (You can download getID3 from

the same place as dir2cast.)

CASTING SEVERAL FOLDERS FROM ONE DIR2CAST.PHP

If you have more than one folder of MP3s that you are casting, you can serve

them all from a single install of dir2cast.php, and customise dir2cast.ini for

each individual folder.

Assuming the following:

* your web root folder is called htdocs/ and this maps to http://www.mysite.com/

* you installed dir2cast to the folder htdocs/dir2cast

* you have two podcasts, and the MP3s live in htdocs/dir2cast/cast1 and

htdocs/dir2cast/cast2

Step 1: Make 2 extra copies of dir2cast.ini (one for each cast), and then edit


to taste.(Any settings not specified will be taken from the main

dir2cast.ini - the one that is in the same folder as dir2cast.php).

Step 2: Upload these additional dir2cast.ini files to the htdocs/dir2cast/cast1/

and htdocs/dir2cast/cast2/ folders, respectively.

The podcast URLs will now be:

http://www.mysite.com/dir2cast/dir2cast.php?dir=cast1 and

http://www.mysite.com/dir2cast/dir2cast.php?dir=cast2 .

"PRETTY" URLS FOR YOUR PODCASTS

This hint requires your web server to be Apache with 'mod_rewrite' enabled.

From the example above, your podcast URL will be

http://www.mysite.com/dir2cast/dir2cast.php?dir=cast1

...but much nicer would be something along the lines of

http://www.mysite.com/dir2cast/cast1/rss

To achieve this, you must configure apache with a rewrite rule such as:

RewriteEngine on

RewriteRule (.+)/rss$ dir2cast.php?dir=$1 [L]

Put this in your VHOST configuration (inside a block) or in a

.htaccess file alongside dir2cast.php .

PLEASE NOTE: just to check that you understand this section...

* If you use the RewriteRule supplied, dir2cast.php must be in the folder above

the MP3 folders. (If this is not the case, you will have to set MP3_BASE in

the ini file, and change the rule for your circumstance.)

Main features:

  • For 99% of things, NO CONFIGURATION IS NECESSARY.
  • dir2cast will automatically use the ID3 fields from your MP3s for the Author, Title, etc. ID3v2 is supported. (Uses bundled getID3 lib).
  • The generated feed is cached (in the supplied 'temp' folder, or anywhere else that you want) and only updated if something in the directory changes.
  • Almost-full support for iTunes podcast tags. (Not supported: block, explicit, new-feed-url, per-item keywords).
  • iTunes 'image' supported: just drop a file called itunes_image.jpg in the same folder as your MP3s.
  • RSS Description, iTunes Subtitle and iTunes Summary can be set by dropping files named description.txt, itunes_subtitle.txt and itunes_summary.txt in the same folder as dir2cast.php - but they are not required. (You can also set these in the script).
  • You can set a per-file iTunes Summary by creating a text file with the same name as the MP3 (e.g. for file.mp3, create file.txt).
  • Works from the command line, if you want.

last updated on:
March 11th, 2010, 12:04 GMT
price:
FREE!
developed by:
Ben XO
homepage:
www.ben-xo.com
license type:
GPL (GNU General Public License) 
category:
ROOT \ Internet \ HTTP (WWW)

FREE!

In a hurry? Add it to your Download Basket!

user rating 14

3.0/5
 

0/5

Rate it!
What's New in version 1.3
  • Fixed nasty regeneration bug where no items in the feed would get any metadata after adding a file to the feed. The workaround was to clear the cache, but this update fixes it. Also, make the feed more robust against getID3's handling of broken MP3s.
read full changelog

Add your review!

SUBMIT