Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/popcorn-official/popcorn-desktop

Popcorn Time is a multi-platform, free software BitTorrent client that includes an integrated media player ( Windows / Mac / Linux ) A Butter-Project Fork
https://github.com/popcorn-official/popcorn-desktop

bittorrent desktop nwjs popcorn popcorn-time popcorntime streaming

Last synced: 4 days ago
JSON representation

Popcorn Time is a multi-platform, free software BitTorrent client that includes an integrated media player ( Windows / Mac / Linux ) A Butter-Project Fork

Awesome Lists containing this project

README 

        


  


  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:

  * **Latest release**: check [popcorn-time.site](https://popcorn-time.site) or the repo's [releases page](https://github.com/popcorn-official/popcorn-desktop/releases)

  * Or **latest dev build (for testers)**: check the repo's [actions page](https://github.com/popcorn-official/popcorn-desktop/actions)



### macOS:

Download and install:

  * **Latest release**: check [popcorn-time.site](https://popcorn-time.site) or the repo's [releases page](https://github.com/popcorn-official/popcorn-desktop/releases)

  * Or **latest dev build (for testers)**: check the repo's [actions page](https://github.com/popcorn-official/popcorn-desktop/actions)



Easily install Popcorn Time via _[Homebrew](https://brew.sh) ([Cask](https://docs.brew.sh/Cask-Cookbook)):_

  ~~~ rb

  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_](https://github.com/Homebrew/homebrew-bundle#usage), you can add something like this:

  ~~~ rb

  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:

  * **Latest release**: check [popcorn-time.site](https://popcorn-time.site) or the repo's [releases page](https://github.com/popcorn-official/popcorn-desktop/releases)

  * Or **latest dev build (for testers)**: check the repo's [actions page](https://github.com/popcorn-official/popcorn-desktop/actions)



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

  [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](https://github.com/popcorn-official/popcorn-desktop/tree/development) branch contains the latest changes.  

The [master](https://github.com/popcorn-official/popcorn-desktop/tree/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](docs/Contributing.md#contributing-to-popcorn-time).



#### Building redistributable packages/installers:



1. `yarn config set yarn-offline-mirror ./node_modules/`

2. `yarn install --ignore-engines`

3. `yarn dist --platforms=`



`` 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](docs/Contributing.md#contributing-to-popcorn-time). We need all the help we can get!  

You can also join our [community](README.md#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](https://github.com/popcorn-official/popcorn-desktop/wiki/).

  * Join in discussions on [r/PopCornTimeApp](https://www.reddit.com/r/PopcornTimeApp).



## Screenshots

![Popcorn Time](https://cloud.githubusercontent.com/assets/8317250/10714437/b1e1dc8c-7b32-11e5-9c25-d9fbd5b2f3bd.png)



## 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](http://semver.org/) guidelines as much as possible.



Releases will be numbered with the following format:



`..-`



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](LICENSE.txt).