Optionally configure Firefox location using FIREFOX_BIN env var

CHANGES.rst

@@ -5,6 +5,8 @@ grafanimate changelog
 
 in progress
 ===========
+- Optionally configure Firefox location using ``FIREFOX_BIN``
+  environment variable. Thanks, @gogglespisano and @intermittentnrg.
 
 2024-12-03 0.8.0
 ================

README.rst

@@ -148,6 +148,16 @@ line options, please invoke:
 
     grafanimate --help
 
+Configuration
+=============
+
+Firefox Location
+----------------
+grafanimate will discover a Firefox installation on your system path.
+If you need to configure a specific installation location, use the
+environment variable ``FIREFOX_BIN`` to point to the Firefox executable
+on your system.
+
 Examples
 ========
 

grafanimate/marionette.py

@@ -3,6 +3,7 @@
 import atexit
 import json
 import logging
+import os
 from collections import OrderedDict
 
 import where
@@ -109,10 +110,10 @@ def configure_marionette(self):
 
     @classmethod
     def find_firefox(cls):
-        candidates = []
-        candidates += where.where("firefox-bin")
-        candidates += where.where("firefox-esr")
-        candidates += [
+        candidates = [
+            os.environ.get("FIREFOX_BIN"),
+            where.where("firefox-bin"),
+            where.where("firefox-esr"),
             "/Applications/Firefox.app/Contents/MacOS/firefox-bin",
         ]
         firefox = find_program_candidate(candidates)