hellaVCR is a PHP TV show downloader that integrates with hellanzb, sabnzbd+, or downloads raw NZB files. It uses TVRage to scrape TV show information, theTVDB for artwork, and Newzbin to figure out what to download. hellaVCR contains a command line PHP script to be run by the cron at regular intervals. It also contains a front end web interface to maintain your TV shows. Some advantages to hellaVCR over similar solutions already out there are its written in PHP, the front end interface looks awesome, it supports double episodes (i.e. x01-02), the ability to download an entire series from the start, email a summary of each batch, and tweeting each show as its queued.
Current Version: 0.6 (3/17/2009)
NEW
- when searching newzbin, "show" and "show (year)" are checked automatically, recently newzbin has the year on some shows that don't need it
- new option to notify an XBMC client when a NZB is downloaded (xbmc, xbmc_host options in the config) - check xbmc.org for the client
- #65/67 - sample.hellavcr.config.php and sample.tv.xml files added to help avoid overwriting data files. keep in mind you'll have to manually add any new config settings to your hellavcr.config.php file!
- new option to display day headers on index.php when sorted by upcoming (print_day_headers option in the config)
- #44, sabnzbd support (sabnzbd options in the config)
- newzbin search will error out if the username or password is not set in the config
- #80, search only certain groups in newzbin, global to all shows (newzbin_groups option in the config)
FIXED
- #69, auto updating of show name only does so if the tvrage call gets info back
- only increments the last download episode when a nzb is downloaded from newzbin
- #68/74, added set_time_limit(0) to fix max execution time errors
- #81, error suppressed when trying to cache a poster to a non-writable posters directory
- #77, variables defaulted to stop some php notices
- fixed an issue with detecting double episodes (used bsg 4x19 as a test case)
- when a show is downloaded and the next episode hasn't updated yet, the show won't be listed at the top of the upcoming sort anymore
NOTES
- make sure to add any new config values from the sample file into hellavcr.config.php
xbmc, xbmc_host, print_day_headers, sabnzbd, newzbin_groups - special thanks to Nic (tons of things for 0.6 and beyond) and AsForMe (sabnzbd support) for their awesome contributions!
Follow hellavcr on twitter for project updates and release notifications.
The latest and greatest hellaVCR code is now hosted on github. Since regular versions only come out every so often, this is the best place to test out the latest fixes as they are implemented.
http://github.com/rectifyer/hellavcr
Note: The code on github should be considered beta, so please only log bugs on the release versions!
hellaVCR requires
- PHP 5 (cli)
- SimpleXML
- cURL
- a Newzbin account
- a usenet downloader (anything that support nzb files)
Optional components
Notes about upgrading
- backup your tv.xml file
- backup your hellavcr.config.php as a reference for the newer version
Configuration
- if running hellaVCR for the first time, remove sample from sample.hellavcr.config.php and sample.tv.xml
- update hellavcr.config.php with your correct settings (add any new config options)
- make tv.xml world writable (chmod 666 tv.xml)
- make posters/ world writable (chmod 666 posters/)
- php hellavcr.php >> hellavcr.log
- probably best to run it in the cron (make sure to use absolute paths)
Web Interface
- index.php
- add new TV shows and choose poster art
Adding a new TV show
Editing an existing TV show
Download History
