Skip to content

Latest commit

 

History

History
177 lines (128 loc) · 9.97 KB

README.md

File metadata and controls

177 lines (128 loc) · 9.97 KB
Raw


Popcorn Time
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:

MacOS:

Easily install Popcorn Time via Homebrew (Cask):

  • Latest release:
    brew tap popcorn-official/popcorn-desktop https://github.com/popcorn-official/popcorn-desktop.git
    brew install --cask popcorn-time
  • Or latest dev build (for testers):
    brew tap popcorn-official/popcorn-desktop https://github.com/popcorn-official/popcorn-desktop.git
    brew install --cask popcorn-time-beta

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'

Update from zip file:

  • Unpack the contents of the zip file. This should leave you with a file named update.tar. Unpacking the .tar file should get you a folder named Content. Navigate to your Application folder, right click on Popcorn Time and press Show Package Content then replace the Content folder there with the Content folder from the update.zip

Linux - Debian/Ubuntu based distros:

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:

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;

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.

Screenshots

Popcorn Time

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