Media Rover:

Announcements »

November 22, 2011
0.8.1 released!
Key fetures of this release: bug fix to notification system...[link]
September 11, 2011
0.8.0 released!
Key fetures of this release: notification system...[link]

Introduction »

Media Rover is an automated TV download scheduler and catalogue maintainer.

It monitors your filesystem for watched TV series, scours various newsgroup indexing sources for missing episodes, and schedules them for download with your binary newsreader. Once on disk, Media Rover renames and sorts the file in the appropriate series directory.

Usage »

Usage instructions:

> python --help

Generate the default configuration and logging files:

> python configuration --write

…you may also specify an alternate location for configuration/logging data:

> python configuration --write --config /path/to/config/dir

Note: before running Media Rover, several required values in the configuration file will need to be set. Consult the wiki for a list of available options and a description of their use.


Once configured, Media Rover can be invoked via the command line:

> python schedule


To manually sort a downloaded episode, run the following via the command line:

> python episode-sort /path/to/download/folder

To setup automatic sorting, SABnzbd must be configured to call Media Rover when it has finished processing a download. Consult the wiki for more detailed instructions.

Dependencies »

Installation »

stable release: v0.8.1


general installation

  1. Download the source code
  2. Unpack
  3. Configure Media Rover (see above)
  4. Run!

Feature Requests / Issues »

Future project goals can be found here

Feel free to email me with any bugs, suggestions, and/or feature requests. Or (if you feel so inclined), fork the project and submit a pull request.

License »

Copyright © 2009 Kieran Elliott

Media Rover is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

Media Rover is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Contact »

Kieran Elliott

kierse [at]