AudioFeedManager
A tool for managing RSS podcast feeds.
Installation
Install the gem from rubygems:
$ gem install audio-feed-manager
Usage
In order to use the app, you will need to perform a couple of steps.
First, you will need to initialize a project (a directory containing the feeds and audio files). Then, you will need to add some feeds and some audio files to the feeds. Once you're ready, you can deploy the feeds to S3.
Initial set up
In order to create a directory for the feeds and audio files, you will need to call:
$ afm init my-project
Where my-project
is a name of the directory you will want to store the files in.
The command will ask you for some additional information, like the S3 credentials to use.
Adding feeds
In order to add a feed execute the following command (while in a project directory):
$ afm feeds add "My Feed Title"
This will create a file feeds/my-feed-title
. This file name is also an identifier of the feed for later use.
You can see the list of created feeds by issuing the following command:
$ afm feeds list
Adding audio files
Once you have created your first feed, you can start adding audio files to it:
$ afm audio add feeds/my-feed-title /path/to/file.mp3
This command will read the title and author from ID3 tags of the MP3 file. If those are not present, it will ask you to provide that information.
Publishing the feeds
You can publish all of the feeds to S3 using the following command:
$ afm publish
This will upload all of the MP3 and .xml files to S3.
Getting an URL for a feed
In order to share a URL to a feed with other people, you can use:
$ afm feeds get-url feeds/my-feed-title
You can see the URL and other feed details by issuing the following command:
$ afm feeds show feeds/my-feed-title
Re-generating RSS file
All of the information about feeds and audio files is stored in plain-text files, so you can use your favorite text editor to change the initially entered details.
For example, to change the order of items in a feed, you can simply edit the items file:
vim items/my-feed-title
Once you are done with the editing, you will need to re-generate the RSS file for the feed you changed:
$ afm feeds update-rss feeds/my-feed-title
Contributing
- Fork it ( https://github.com/[my-github-username]/audio-feed-manager/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request