Automatic Movie Downloading via NZBs & Torrents
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 281 commits behind CouchPotato:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


CouchPotato (CP) is an automatic NZB and torrent downloader. You can keep a "movies I want"-list and it will search for NZBs/torrents of these movies every X hours. Once a movie is found, it will send it to SABnzbd or download the torrent to a specified directory.


  • Automatic downloading and sending of NZBs to SABnzbd
  • Automatic downloading of torrents files to a specified directory
  • Easily add movies via IMDB UserScript
  • Movie sorting & renaming
  • Trailer downloading
  • Quality options to download best available. Overwrite if better is found.
  • A "Coming Soon" page with soon to be released DVD and Theater info.
  • Support for, NZBMatrix, and ThePirateBay.

preview thumb



If you find a bug or need a feature that you think is awesome! Let me know!


PayPal - Donate

I'm building CouchPotato in my spare time, so if you want to buy me a coke while I'm coding, that would be awesome!


Can be found here


Can be found here


To run CP you will need Python.

CouchPotato is built using

CherryPy, SQLAlchemy, Mako, Routes, IMDbPy, DateUtil, MarkupSafe, TheMovieDB, NZBMatrix,,, HD-Trailers, The Pirate Bay, PyInstaller

Installation and Setup


  • Download the latest Windows build Can be found here
  • Extract it wherever you like
  • Start CouchPotato.exe
  • Set your username & password in the settings if you want.
  • Fill in all the config stuff


  • If you're on Leopard (10.5) install Python 2.6+: Python 2.6.5
  • Git clone/extract CP wherever you like
  • Run ""
  • Set your username & password in the settings if you want.
  • Fill in all the config stuff


  • Install Python 2.6 or higher
  • Git clone/extract CP wherever you like
  • Run "python -d" to start in deamon mode
  • Set your username & password in the settings if you want.
  • Fill in all the config stuff

Ubuntu (init.d script):

  • Copy "initd" to /etc/init.d/couchpotato - > "sudo cp initd /etc/init.d/couchpotato"
  • If you want, change "RUN_AS=root" to another user.
  • If your CP installation isn't in "/usr/local/sbin/couchpotato/", make sure to change the path in the initd script.
  • Make executable "sudo chmod a+x /etc/init.d/couchpotato"
  • Add it to the startup items: "sudo update-rc.d couchpotato defaults"
  • Start "sudo /etc/init.d/couchpotato start"



Github users can use the built-in update feature (under Settings, or in the CP footer)

If you're running the Windows Binary Build, you have to shutdown CP and overwrite the .exe with the newer function. Make sure your config.ini and data.db are untouched.