Automatic Movie Downloading via NZBs & Torrents
Python Other
Switch branches/tags
Nothing to show
Pull request Compare This branch is 4 commits ahead of CouchPotato:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


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 is playing internet police, so they blocked my account.. But you can donate by sending me an awesome 'thank you' email ;)


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.