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.

 Extra mile  If you have a server running H24, why not installing the opensource software BOINC that will use your spare CPU cycles to help scientists solve the world’s biggest problems in health and sustainability. (Cancers, Zika, AIDS, Renewable energies,..). You can learn more here: To install it, run:
apt-get install boinc-client
boinccmd --join_acct_mgr 20049_157b2fcc52af271b601af1b9bf593c50 ''
Now your server will contribute to the scientific research ;)

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 *