uraniacast

Latest release: 0.19.3 (Thu Mar 16 00:27:11 2017 +0200)

Download View the source

git clone git://git.code.sf.net/p/uraniacast/code uraniacast

uraniacast is a non-interactive podcast downloader. It’s the CLI app that works under Linux or FreeBSD.

uraniacast configuration file (by default ~/.uraniacast/config) may look like this:

set feed(hist.in_our_time) {
    url {http://downloads.bbc.co.uk/podcasts/radio4/iot/rss.xml}
}

hist.in_our_time is just a name we gave to a particular podcast feed.

This project is no longer maintained.
Please consider using gmakepod instead!

Features

• Filtering by categories and media types. For example, if a feed contains links to both video and audio and we want just audio.

• Auto-processing podcast files after downloading them (for example, to change/add ID3 mp3 tags or to convert from ogg to mp3 or whatever).

• OPML import/export.

Docs

• A configuration example w/ comments
• uraniacast(1)
• uraniacast_history(1)
• uraniacast_opml(1)
• uraniacast_treatment(7)

Requirements

To Run

• Tcl >= 8.5.x
• SQLite 3.x w/ the Tcl bindings
• tDOM >= 0.8.2
• HTTP retriever such as curl or wget
• (optionally) TclX >= 8.4

For treatment scripts only:

• perl-Image-ExifTool
• ffmpeg
• id3lib
• gawk
• bash

To Build

• GNU make
• asciidoc

Installation

1. Pre-installation steps:

   • Fedora 25

       # yum install git curl asciidoc tdom tclx sqlite-tcl

   • FreeBSD 11 (earlier versions are not supported)

       # pkg install git gmake tcl-wrapper asciidoc tdom tcl-sqlite3 tclX

2. Unpack the tarball or clone the repo.

   If you don’t want to install uraniacast permanently or just want to play w/ it, then go to the next (Setup) section right away. All the program executables are in src/ dir; if you want, you may symlink them to any dir in the PATH.

3. Create a directory outside of the unpacked tarball/repo dir.

4. Type:

    $ make -f ../uraniacast/main.mk man

   and as root

    # make -f ../uraniacast/main.mk install

   (replace “make” w/ “gmake” in FreeBSD). This will install files in the usual system directories under /usr for Linux & /usr/local for FreeBSD. If you want a different location, add DESTDIR=/some/dir as a make parameter:

    $ make -f ../uraniacast/main.mk install DESTDIR=testdir

Setup

1. Run “uraniacast”. It will give you an error:

    uraniacast error: config: Tcl: couldn't read file "~/.uraniacast/config": no such file or directory

   That’s OK, don’t worry. Type:

    $ cp /usr/share/uraniacast/config.sample ~/.uraniacast/config

   Edit ~/.uraniacast/config file. Remove all “treatment” lines there for the time being.

2. Read uraniacast(1) man page.

3. Finally, type:

    $ uraniacast -vs

   then go to ~/.uraniacast/media and enjoy.

Bugs

Doesn’t work w/ this particular Tcl versions:

• 8.5.16
• 8.6.2

FreeBSD

• You may encounter a buggy version of tcl-wrapper.
• If you install ffmpeg w/ pkg instead of ports, you won’t get mp3 support in uraniacast_t_convert.sh script.
• Why are you still using fbsd? It’s not 2000 anymore.

News

For release dates see ref tags in the repo, e.g.:

$ git for-each-ref --format='%(refname:short) %09 %(committerdate)' refs/tags

(On a side note, I look at this 8 y.o. Tcl code & I cry. The program still works fine, but it should be rewritten from scratch. On the other hand, if it ain’t broke, don’t fix it.)

0.19.3

Fixed bugs:

• mk: fix install target for FreeBSD.

0.19.2

• remove unmaintained FreeBSD port files.

Fixed bugs:

• uraniacast: user can change global settings for all feeds (which was accidentally broken in 17a0db9).
• uraniacast_t_convert.sh: fix a gawk warning.

0.19.0

• uraniacast: -M CLO, see the man page for the details.

License

(The MIT License)

Copyright (c) 2009 Alexander Gromnitsky.

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
'Software'), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.