Skip to content

Latest commit

 

History

History
179 lines (127 loc) · 9.69 KB

README.md

File metadata and controls

179 lines (127 loc) · 9.69 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 popcorn-time.site

Install

Windows:

Download and install:

macOS:

Download and install:

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

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 }

Apple Silicon:

If you have Apple Silicon (M-series chips), you need to use the arm64 release. Apple Silicon apps are required to be signed and notarised with an Apple developer account. So it is necessary to manually remove the quarantine flag:

xattr -c "/Applications/Popcorn-Time.app/"

Linux - Debian/Ubuntu based distros:

Download and install:

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 from the github repo for the latest release : wget -c https://github.com/popcorn-official/popcorn-desktop/releases/download/v0.5.1/Popcorn-Time-0.5.1-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.5.1-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 redistributable 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

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