Giter Club home page Giter Club logo

firefox-tv's Introduction

Firefox for Amazon's Fire TV

Task Status codecov

Fast for good, just right for watching video at home. A browser for discovering and watching web video on the big screen TV for users to install on their Amazon Fire TV and Fire TV stick.

Get it on Amazon Fire TV

Getting Involved

Our code is open source and we encourage all positive contributions! We love Pull Requests, bug reports, ideas, (security) code reviews and other kinds of contributions. Before you contribute, please read the Community Participation Guidelines.

Beginners! Watch out for Issues with the good first issue label. These are easy bugs that have been left for first timers to have a go, get involved and make a positive contribution to the project!

For other contributor-ready issues, see the help wanted label.

Build instructions

  1. Clone the repository:
git clone https://github.com/mozilla-mobile/firefox-tv
  1. Import the project into Android Studio or build on the command line:
./gradlew clean app:assembleAmazonWebviewDebug
  1. Make sure to select the right build variant in Android Studio: amazonWebviewDebug

Running

It is recommended to test directly on a Fire TV: see the developer guide for more info. You can connect with:

adb connect <IP address>

And then install via Android Studio or adb. Only a single development device can be connected to a Fire TV at a time. Note that while you can install on an Android TV emulator, the behavior is different from Fire TV's and should not be relied upon.

When using an emulator, you can press cmd+m to simulate a menu button press.

Building with API keys

Certain services require an API key, so you'll need to build with the key to use them in the apk.

  1. To build with the API key (for services such as Sentry), add a <project-dir>/.<service>_debug file with your key, for example, <project-dir>/.sentry_dsn_debug

    1. To enable Sentry on Debug builds, additionally replace the DataUploadPreference.isEnabled value with true (upload is disabled by default in dev builds).
  2. Verify the key add was successful. The gradle output is the only way to verify this (although it won't indicate if the key is valid). You will see a message in the gradle output indicating the key was added:

Sentry DSN (amazonWebviewDebug): Added from /Users/mcomella/dev/moz/firefox-tv/.sentry_dsn_debug

As opposed to:

Sentry DSN (amazonWebviewDebug): X_X

API services currently supported are:

  • sentry_dsn
  • pocket_key

License

This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/

firefox-tv's People

Contributors

aaronmt avatar ahunt avatar alanorth avatar antlam avatar bbinto avatar benestar avatar bkmunar avatar boek avatar codebu5ter avatar depsteino avatar ekager avatar frozzare avatar johnkal avatar jordanshaak avatar joydeepsaha05 avatar jxsun avatar kaanee avatar kination avatar layely avatar liuche avatar mastizada avatar mcomella avatar mickeymoz avatar mkaply avatar neonpegasu5 avatar nosark avatar pocmo avatar sabbir044 avatar sdaswani avatar snorp avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.