Popcorn Time

A multi-platform, free software BitTorrent client that includes an integrated media player.

Visit the project's website at popcorntime.app

---

Install

Windows:

Download and install:

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

MacOS:

Download and install:

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

Easily install Popcorn Time via Homebrew (Cask):

brew tap popcorn-official/popcorn-desktop https://github.com/popcorn-official/popcorn-desktop.git
#export HOMEBREW_POPCORN_TIME_BUILD=false
brew install --cask popcorn-time #--no-quarantine

By default, this will build the app from source using the latest version of NW.js on macOS 12.x (Monterey) or later, else revert to the latest stable build on previous versions of macOS. This behaviour can also be forced by exporting a HOMEBREW_POPCORN_TIME_BUILD=false environment variable, for example in ~/.bashrc or ~/.zshrc.

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

repo = "popcorn-official/popcorn-desktop"
tap repo, "https://github.com/#{repo}.git"
#ENV["HOMEBREW_POPCORN_TIME_BUILD"] = "false"
cask "popcorn-time" #, args: { "no-quarantine": true }

Linux - Debian/Ubuntu based distros:

Download and install:

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

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.

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.9-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.9/Popcorn-Time-0.4.9-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.9-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;

Getting Started

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.

Quickstart:

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.

Building redistribuable packages/installers:

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.

Getting Involved

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.

Community

Keep track of Popcorn Time development and community activity.

• Read and contribute to the official Popcorn Time Wiki.
• Join in discussions on the Popcorn Time Forum and r/PopCornTimeApp.

Screenshots

Versioning

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 © 2022 Popcorn Time Project - Released under the GPL v3 license.