Skip to main content

CouchPotato, automatically download upcoming movies

CouchPotato downloads movies automatically in the best quality, once released on your favorite trackers.



“Honey, can you get this movie for tonight?”

“What? It is not even in the theater”

If you have time to time such conversation, CouchPotato is a must!

CouchPotato is with movie, what SickRage is with TV-Shows/Series.

Through a fancy and intuitive interface, it lets you search for movies and put them in your “To download” list. Once those movies will be available on torrent, it will automatically download them using your torrent client (Deluge, Transmission, uTorrent,..)


Their main page will start with some suggestions of movies based on your recent downloads and will also add some display new releases from IMDB or

Once you have found the movie you want to download, you can add it to your wanted list and select a quality (Some presets exist), like in HD (720p), Bluray, 3D, etc…


In the settings, you are able to select a list of trackers (Public or Private), set some rules to rename your movies once downloaded and even push some notifications to XMPP, Twitter, Emby, Slack, … or simply by email.

They have also developed a Firefox, Chrome and Safari extension to add an option to download a movie when you are visiting its page on IMDB, Apple Trailers and few others websites.


Interesting isn’t it!


So now let’s see how to install couchpotato on your own server, using Debian (like me) or Ubuntu (Should be similar)



1) Install Python and LXML

The first requirement is Python (>2.6) and they also recommend LXML for faster web scrapping.

In root or with sudo, run:


2) Make sure you have the latest pyOpenSSL

3) Clone their latest repo

Assuming you already have git installed (apt-get install git, if not), run the following:

This will download their latest version in the folder CouchPotatoServer. (Around 20mb)


4) Start the app
And you should now have access to your CouchPotato instance on http://yourIP:5050

But you probably wants the app to run at the startup of your machine.

If you are using Systemd:

And update it with the path of the Python Script

and change


and finally, add it to the startup:

Now your couchpotato instance will start at every boot of your machine.


5) Configure CouchPotato

When accessing Couchpotato for the first time, you are able to configure your instance with:

  • Your login/password
  • Your torrent client settings (Deluge in my case, where I need to provide the server, user, login,…)
  • Your favorite trackers
  • and few others settings.

And it should all be working now ! Enjoy !


As usual in my case, I will also create a dedicated virtualhost (I don’t want to remember the port number) and enable SSL with Let’s Encrypt.

Here is my virtualhost for info:

You will need the mod proxy html and http enabled, as shared in a rather old tutorial on how to redirect a sub-domain to a port.


Now it is time to be a couchpotato!! See ya


If you have questions on CouchPotato, I strongly recommend you to visit their github page.

2 thoughts on “CouchPotato, automatically download upcoming movies

  1. Hey,
    Good write up, but what user are you running couchpotato under?
    Did you manually create a couchpotato user? Or did just just modify the .service file to an existing user?

Leave a Reply

Your email address will not be published. Required fields are marked *