erikusaj / firefox-tv

Firefox for Amazon's Fire TV

Firefox for Amazon's Fire TV

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.

• Developer guide

• IRC: #focus (irc.mozilla.org); logs: https://mozilla.logbot.info/focus/; we're available Monday-Friday, GMT and PST working hours.

• Mailing list: firefox-focus-public@

• See our wiki for additional docs

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

2. Import the project into Android Studio or build on the command line:

./gradlew clean app:assembleAmazonWebviewDebug

3. 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/