{"id":14036602,"url":"https://github.com/mozilla-mobile/firefox-tv","last_synced_at":"2025-07-27T03:32:29.459Z","repository":{"id":49320835,"uuid":"114038082","full_name":"mozilla-mobile/firefox-tv","owner":"mozilla-mobile","description":"Firefox for Amazon's Fire TV","archived":true,"fork":false,"pushed_at":"2021-04-08T18:40:24.000Z","size":109036,"stargazers_count":257,"open_issues_count":522,"forks_count":111,"subscribers_count":39,"default_branch":"master","last_synced_at":"2024-12-02T15:49:13.734Z","etag":null,"topics":["browser","fire-tv","mozilla"],"latest_commit_sha":null,"homepage":"https://blog.mozilla.org/blog/2017/12/20/firefox-is-now-on-amazon-fire-tv-happy-holiday-watching/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mozilla-mobile.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2017-12-12T20:53:46.000Z","updated_at":"2024-11-10T13:11:30.000Z","dependencies_parsed_at":"2022-08-27T10:12:09.246Z","dependency_job_id":null,"html_url":"https://github.com/mozilla-mobile/firefox-tv","commit_stats":null,"previous_names":[],"tags_count":104,"template":false,"template_full_name":null,"purl":"pkg:github/mozilla-mobile/firefox-tv","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla-mobile%2Ffirefox-tv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla-mobile%2Ffirefox-tv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla-mobile%2Ffirefox-tv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla-mobile%2Ffirefox-tv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mozilla-mobile","download_url":"https://codeload.github.com/mozilla-mobile/firefox-tv/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mozilla-mobile%2Ffirefox-tv/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267294180,"owners_count":24065343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-27T02:00:11.917Z","response_time":82,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser","fire-tv","mozilla"],"created_at":"2024-08-12T03:02:04.689Z","updated_at":"2025-07-27T03:32:24.438Z","avatar_url":"https://github.com/mozilla-mobile.png","language":"Kotlin","funding_links":[],"categories":["Kotlin"],"sub_categories":[],"readme":"\u003e ⚠️ Firefox has ended support for Amazon Fire TV. This app may continue to work, but it won’t receive security or other updates effective April 30, 2021. See also [https://support.mozilla.org/en-US/kb/end-support-firefox-amazon-devices](https://support.mozilla.org/en-US/kb/end-support-firefox-amazon-devices).\n\n# Firefox for Amazon's Fire TV\n\n[![Task Status](https://github.taskcluster.net/v1/repository/mozilla-mobile/firefox-tv/master/badge.svg)](https://github.taskcluster.net/v1/repository/mozilla-mobile/firefox-tv/master/latest)\n[![codecov](https://codecov.io/gh/mozilla-mobile/firefox-tv/branch/master/graph/badge.svg)](https://codecov.io/gh/mozilla-mobile/firefox-tv)\n\n_Fast for good, just right for watching video at home. A browser for\ndiscovering and watching web video on the big screen TV for users to install on\ntheir Amazon Fire TV and Fire TV stick._\n\n[Get it on Amazon Fire TV][amazon link]\n\n## Getting Involved\nOur code is open source and we encourage all positive contributions! We love pull\nrequests, bug reports, ideas, (security) code reviews and other kinds of contributions.\nBefore you contribute, please read the [Community Participation\nGuidelines](https://www.mozilla.org/en-US/about/governance/policies/participation/).\n\n* [Guide to Contributing][contribute] (**new contributors start here!**)\n* Open issues: https://github.com/mozilla-mobile/firefox-tv/issues\n  * [`good first issues`][good first] | [`help wanted`][help]\n  * [File a security issue][sec issue]\n* Project wiki: https://github.com/mozilla-mobile/firefox-tv/wiki\n* Mailing list:\n[firefox-focus-public@](https://mail.mozilla.org/listinfo/firefox-focus-public)\n\n## Build instructions\nDependencies:\n- Java 8, *not the latest version* (for building via the command line)\n\n1. Clone the repository:\n\n  ```shell\n  git clone https://github.com/mozilla-mobile/firefox-tv\n  ```\n\n2. Import the project into Android Studio or build on the command line:\n\n  ```shell\n  ./gradlew clean app:assembleSystemDebug\n  ```\n\n3. Make sure to select the right build variant in Android Studio: **systemDebug**\n\n### Running\nIt is recommended to test directly on a Fire TV: see the [developer guide][dev guide] for more info.\nYou can connect with:\n```shell\nadb connect \u003cIP address\u003e:5555\n```\n\nAnd then install via Android Studio or adb. Only a single development device\ncan be connected to a Fire TV at a time. Note that while you can install on an\nAndroid TV emulator, the behavior (particularly `WebView` behavior) is different \nfrom Fire TV's and should not be relied upon.\n\nIf using an emulator, we recommend the Android TV device image: either 720p or\n1080p is fine. API 22 (Stick) and 25 (4K) are best. You can press `cmd + m` to\nsimulate a menu button press.\n\n### Unit Testing\nTo run a reasonable subset of the unit tests, we recommend:\n```sh\n./gradlew testSystemDebug\n```\n\nTo generate code coverage reports, run:\n```sh\n./gradlew -Pcoverage jacocoDebugTestReport\n```\n\nReports can be found at `app/build/jacoco/jacoco\u003cbuildVariant\u003eTestReport/html/index.html`\n\n### UI Testing\nTo run all UI tests, follow these steps\n\n1. Connect to one device\n  - Either use `adb connect` for a real device, or start an emulator instance using AVD\n  - Prefer a real device (emulators will fail some tests)\n  - The next step will fail if you are connected to more than one device\n2. Run `./gradlew connectedSystemDebugAndroidTest` from the command line\n  - Aliasing this command is recommended\n\n### Pre-push hooks\nTo reduce review turn-around time, we'd like all pushes to run tests locally. We'd\nrecommend you use our provided pre-push hook in `quality/pre-push-recommended.sh`.\nUsing this hook will guarantee your hook gets updated as the repository changes.\nThis hook tries to run as much as possible without taking too much time.\n\nTo add it, run this command from the project root:\n```sh\nln -s ../../quality/pre-push-recommended.sh .git/hooks/pre-push\n```\n\nTo push without running the pre-push hook (e.g. doc updates):\n```sh\ngit push \u003cremote\u003e --no-verify\n```\n\n### Release process\n(See [this doc](https://github.com/mozilla-mobile/firefox-tv/blob/master/.github/ISSUE_TEMPLATE/---relman-checklist.md) \nfor a description of our release process)\n\n### Building release builds\nRelease builds can be built in Android Studio or via the command line:\n```sh\n./gradlew assembleSystemRelease # unsigned build\n```\n\nThese builds will run validation checks that the build is ready for a production release. If you\ndo not want to run these checks (e.g. building release builds for local debugging), you can add this\nargument:\n```sh\n./gradlew assembleSystemRelease -PnoValidate\n```\n\n#### API keys\nCertain services require an API key, so you'll need to build with the key to use them in the apk.\n\n1. To build with the API key (for services such as Sentry), add a `\u003cproject-dir\u003e/.\u003cservice\u003e_debug`\nfile with your key, for example, `\u003cproject-dir\u003e/.sentry_dsn_debug`\n\n    1. To enable Sentry on Debug builds, additionally replace the `isEnabled` value check in\n    `SentryIntegration` value with true (upload is disabled by default in dev builds).\n\n2. Verify the key add was successful. The gradle output is the only way to verify this (although\nit won't indicate if the key is valid). You will see a message in the gradle output\nindicating the key was added:\n\n`Sentry DSN (debug): Added from /Users/mcomella/dev/moz/firefox-tv/.sentry_dsn_debug`\n\nAs opposed to:\n\n`Sentry DSN (debug): X_X`\n\nAPI services currently supported are:\n* sentry_dsn\n* pocket_key\n\n##### Amazon Device Messaging (ADM) API key\nWe suspect **ADM access is only available in local builds for core team members** because testing\nADM requires access to a private API key that is connected to our app on the Amazon store dashboard.\n\nTo use ADM in debug builds, there must be a `\u003cproject-dir\u003e/app/src/main/assets/api_key.txt` file\nthat contains the api key. It is necessary that it is in the project's assets folder.\nAmazon will automatically provide an API key for production builds. See\n[ADM integration doc][adm] for more details. If you're on the core team, we share debug keys: ask\nanother developer for access.\n\n## License\n\n    This Source Code Form is subject to the terms of the Mozilla Public\n    License, v. 2.0. If a copy of the MPL was not distributed with this\n    file, You can obtain one at http://mozilla.org/MPL/2.0/\n\n[amazon link]: https://www.amazon.com/dp/B078B5YMPD/ref=sr_1_1\n[dev guide]: https://github.com/mozilla-mobile/firefox-tv/wiki/Developer-guide-and-differences-from-Android\n[contribute]: https://github.com/mozilla-mobile/shared-docs/blob/master/android/CONTRIBUTING.md\n[good first]: https://github.com/mozilla-mobile/firefox-tv/labels/good%20first%20issue\n[help]: https://github.com/mozilla-mobile/firefox-tv/labels/help%20wanted\n[sec issue]: https://bugzilla.mozilla.org/enter_bug.cgi?assigned_to=nobody%40mozilla.org\u0026bug_file_loc=http%3A%2F%2F\u0026bug_ignored=0\u0026bug_severity=normal\u0026bug_status=NEW\u0026cf_fx_iteration=---\u0026cf_fx_points=---\u0026component=Security%3A%20General\u0026contenttypemethod=autodetect\u0026contenttypeselection=text%2Fplain\u0026defined_groups=1\u0026flag_type-4=X\u0026flag_type-607=X\u0026flag_type-791=X\u0026flag_type-800=X\u0026flag_type-803=X\u0026form_name=enter_bug\u0026groups=firefox-core-security\u0026maketemplate=Remember%20values%20as%20bookmarkable%20template\u0026op_sys=Unspecified\u0026priority=--\u0026product=Firefox%20for%20FireTV\u0026rep_platform=Unspecified\u0026target_milestone=---\u0026version=unspecified\n[adm]: https://developer.amazon.com/docs/adm/integrate-your-app.html#store-your-api-key-as-an-asset\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmozilla-mobile%2Ffirefox-tv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmozilla-mobile%2Ffirefox-tv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmozilla-mobile%2Ffirefox-tv/lists"}