Skip to content

alexblom/phonocast

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Phonocast

Phonocast is a gem to convert local audio files to a podcast feed, which can then be deployed on your own server or even Dropbox.

Motivation: http://dancarlin.com/product/hardcore-history-compilation-episodes-1-39 with https://overcast.fm's 2x speed.

Installation

gem install phonocast

Usage

Generating an RSS Feed:

phonocast create_feed

Setup Yaml Config

Instead of passing the same arguments to the CLI each time, you can store them ina YAML file. The YAML file also provides configuration options not available by the CLI.

To generate the YAML file: phonocast setup

Feed Config Options.

Options can be set by YAML or CLI arguments. The order of precedence is:

DEFAULTS -> YAML -> CLI Arguments.

So if you have YAML.title = "Title 1" and CLI.title = "Title 2", the title used will be "Title 2". Generally speaking, store your config in YAML and use CLI arguments for one off overrides.

All itunes_ tags correspond to iTunes RSS spec.

Name CLI YAML Desc
base_url Y Y Url where audio files are hosted, e.g. myserver.com/podcasts or mypublicdropbox.com. Defaults to link.
rss_path Y Y Location and name of generated rss file. Default: ./phonocast.rss
file_path Y Y Where are local audio files? Default: ./
image_path N Y Podcast log. base_url/image_path. Channel level.
title Y Y Title of Podcast
link Y Y Channel level link (e.g. mypodcast.com)
yaml_path Y Y Location of YAML file for config. Default: ./phonocast.yaml
copyright N Y Channel level
language N Y Channel level
description N Y Channel level
author N Y Channel level
itunes_block N Y Channel level
itunes_explicit N Y Channel level
itunes_keywords N Y Channel level
itunes_subtitle N Y Defaults to description.
itunes_summary N Y Defaults to description.

Deployment

Private Server:

scp -r . server:/path

Dropbox:

Drag and drop to Dropbox Public folder and set base_url appropriately.

Contributing

Contributions welcome. Please open pull requests and include tests.

Need contribution ideas?

grep -rni todo lib/

Copyright

Copyright (c) 2015 Alex Blom. See LICENSE for further details.

About

Local mp3/audio to podcast feed

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages