Skip to content
Find file
Fetching contributors…
Cannot retrieve contributors at this time
117 lines (78 sloc) 4.4 KB


Notice to devs: If you want to help with some features, Please do it on CouchPotatoServer.

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.ubuntu" to /etc/init.d/couchpotato - > "sudo cp initd.ubuntu /etc/init.d/couchpotato"
  • Copy "default.ubuntu" to /etc/default/couchpotato - > "sudo cp default.ubuntu /etc/default/couchpotato"
  • Edit the required daemon settings in /etc/default/couchpotato - > editor /etc/default/couchpotato
  • If your CP installation isn't in "/opt/couchpotato/", make sure to change the path there also!
  • Make executable "sudo chmod a+x /etc/init.d/couchpotato"
  • Add it to the startup items: "sudo update-rc.d couchpotato defaults"
  • Start with "sudo service 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.

Jump to Line
Something went wrong with that request. Please try again.