Download and install:

• Latest release: check popcorntime.app or the repo's releases page
• Or latest dev build (for testers): check the latest successful build on ci.popcorntime.app

Easily install Popcorn Time via Homebrew (Cask):

• Latest release:
  brew cask install https://raw.githubusercontent.com/popcorn-official/popcorn-desktop/development/casks/popcorn-time.rb
• Or latest dev build (for testers):
  brew cask install https://raw.githubusercontent.com/popcorn-official/popcorn-desktop/development/casks/popcorn-time-beta.rb

Also, if you keep a Brewfile, you can add something like this:

repo = 'popcorn-official/popcorn-desktop'
tap repo, "https://github.com/#{repo}.git"
cask 'popcorn-time'

Via .deb package:

Firstly, be aware in some cases, missings dependencies packages (libatomic1, libgconf-2-4, libcanberra-gtk-module) were reported to be required for the app to works.
If the app don't start for you too, in this case, try sudo apt update && sudo apt install libatomic1 libgconf-2-4 libcanberra-gtk-module to be sure your system have the required dependencies.

Download and install:

• Latest release: check popcorntime.app or the repo's releases page
• Or latest dev build (for testers): check the latest successful build on ci.popcorntime.app

Via archive and command line (tested on ubuntu 18.04 and 20.04):

1. Download Popcorn Time archive:
   • For the latest release:
     wget -c https://get.popcorntime.app/repo/build/Popcorn-Time-0.4.4-linux64.zip
     if eventually you get issue with popcorntime.app website you can try to download from the github repo
     wget -c https://github.com/popcorn-official/popcorn-desktop/releases/download/v0.4.4/Popcorn-Time-0.4.4-linux64.zip
   • Or for the latest dev build (for testers):
     wget -c https://ci.popcorntime.app/job/Popcorn-Time-Desktop/lastSuccessfulBuild/artifact/build/Popcorn-Time-0.4.4_linux64.zip -O Popcorn-Time-0.4.4-linux64.zip
2. Create popcorn-time folder in /opt/:
   sudo mkdir /opt/popcorn-time
3. Install unzip && dependencies (they should not be always required but some users needed them to make Popcorn Time working):
   sudo apt update && sudo apt install unzip libcanberra-gtk-module libgconf-2-4 libatomic1
4. Extract the zip in /opt/popcorn-time:
   sudo unzip Popcorn-Time-0.4.4-linux64.zip -d /opt/popcorn-time
5. Create symlink of Popcorn-Time in /usr/bin:
   sudo ln -sf /opt/popcorn-time/Popcorn-Time /usr/bin/popcorn-time
6. Create .desktop file (so the launcher):
   sudo nano /usr/share/applications/popcorntime.desktop
7. and copy paste the following text in the editor and save

[Desktop Entry]
Version = 1.0
Type = Application
Terminal = false
Name = Popcorn Time
Exec = /usr/bin/popcorn-time
Icon = /opt/popcorn-time/src/app/images/icon.png
Categories = Application;

If you're comfortable getting up and running from a git clone, this method is for you.

The development branch contains the latest changes.
The master branch contains the latest release.

1. yarn start

If you encounter trouble with the above method, you can try:

1. yarn config set yarn-offline-mirror ./node_modules/
2. yarn install --ignore-engines
3. yarn build
4. yarn start

Optionally, you may simply run ./make_popcorn.sh if you are on a linux or mac based operating system.

Full instructions & troubleshooting tips can be found in the Contributing Guide.

1. yarn config set yarn-offline-mirror ./node_modules/
2. yarn install --ignore-engines
3. yarn dist --platforms=<platform>

<platform> can be one or more of the folowing values (separated by a comma ,):

• win64, win32, linux64, linux32, osx64, all

Redistribuable packages are saved into build/ subfolder.

Want to report a bug, request a feature, contribute to or translate Popcorn Time?
Check out our in-depth guide to Contributing to Popcorn Time. We need all the help we can get!
You can also join our community to keep up-to-date and meet other developers.

Keep track of Popcorn Time development and community activity.

• Follow Popcorn Time on Twitter.
• Read and subscribe to The Official Popcorn Time Blog.
• Join in discussions on the Popcorn Time Forum and r/PopCornTimeApp.

For transparency and insight into our release cycle, and for striving to maintain backward compatibility, Popcorn Time will be maintained according to the Semantic Versioning guidelines as much as possible.

Releases will be numbered with the following format:

<major>.<minor>.<patch>-<build>

Constructed with the following guidelines:

• A new major release indicates a large change where backward compatibility is broken.
• A new minor release indicates a normal change that maintains backward compatibility.
• A new patch release indicates a bugfix or small change which does not affect compatibility.
• A new build release indicates this is a pre-release of the version.

If you distribute a copy or make a fork of the project, you have to credit this project as the source.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Copyright © 2020 Popcorn Time Project - Released under the GPL v3 license.