butterproject/butter-android

Name: butter-android

Owner: butterproject

Description: All the cool technical bits of what used to be Popcorn Time for Android

Created: 2015-10-24 13:36:10.0

Updated: 2018-05-20 10:14:51.0

Pushed: 2018-05-13 10:34:43.0

Homepage:

Size: 344360

Language: Java

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Butter for Android

Allow any Android user to watch movies easily streaming from torrents, without any particular knowledge.

Visit the project's website at http://butterproject.org.

Community

Keep track of Butter development and community activity.

Roadmap
pre 1.0.0
pos 1.0.0
Getting Involved

Want to report a bug, request a feature, contribute or translate Butter? Check out our in-depth guide to Contributing to Butter.

Build Instructions

CircleCI

The gradle build system will fetch all dependencies and generate files you need to build the project. You first need to generate the local.properties (replace YOUR_SDK_DIR by your actual android sdk dir) file:

$ echo "sdk.dir=YOUR_SDK_DIR" > local.properties

You can now sync, build and install the project:

$ ./gradlew assembleDebug   # assemble the debug .apk
$ ./gradlew assembleRelease # assemble the release .apk (signing keys are required)
$ ./gradlew installDebug    # install the debug .apk if you have an
                            # emulator or an Android device connected

You can use Android Studio by it as existing project.

Directory structure
`|-- base                            # base module (contains all the core functionallity)
`|-- mobile                          # mobile module (smartphone/tablet application)
`|-- tv                              # tv module (Android TV application)
`|-- provider                        # includes provider implementations
      `-- media                      # media provider implementation and SDK
            |-- base                 # Contains models for working with providers
            |-- mock                 # Provider implementation with mock data for testing purposes
            |-- provide              # Media provider SDK
            `-- vodo                 # Vodo provider implementation
      `-- subs                       # subtitle provider implementation and SDK
            |-- mock                 # Subs provider implementation with mock data for testing purposes
            |-- provide              # Subs provider SDK
`|-- connectsdk                      # connectsdk module responsible for streaming on external device such as Chromecas or Apple TV
      |-- core                       # connectsdk module core implementation
      `-- modules
            |-- google_cast          # connectsdk module google cast implementation
            |-- firetv               # connectsdk module fire tv implementation
Versioning

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

Releases will be numbered with the following format:

<major>.<minor>.<patch>

Constructed with the following guidelines:

License

If you distribute a copy or make a fork of the project, you have to credit this project as 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/.

Note: some dependencies are external libraries, which might be covered by a different license compatible with the GPLv3. They are mentioned in NOTICE.md.


Copyright (c) 2015 Butter Project - Released under the GPL v3 license.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.