# foxglove
Foxglove is a Firefox wrapper with two purposes:
1. Programatically generate Firefox profiles with preferences that I consider
desirable for the majority of use cases. These disable, where possible,
Firefox's built-in advertising, pop-ups, telemetry, experiments, and similar
features. Generated profiles are stored in `~/.foxglove`.
2. If a remote host is given, ssh to it and use that connection as a SOCKS
proxy. In either case, launch Firefox.
```
usage: foxglove [-h] [--chrome path] [--content path] [-d] [-e] [-a add-on] profile [host]
foxglove - a Firefox profile and proxy manager
positional arguments:
profile the name of the foxglove-managed profile to use or create
host ssh server hostname. If this option is given, foxglove will attempt to use ssh(1) to connect to the host and configure Firefox to use it
as a SOCKS proxy
optional arguments:
-h, --help show this help message and exit
--chrome path path to a userChrome.css file to add to the profile
--content path path to a userContent.css file to add to the profile
-d dry run (don't launch Firefox)
-e ephemeral (delete profile on exit)
-a add-on download and install this add-on. Use the name as it appears in the Mozilla add-ons site URL. May be used multiple times
```
To use the "host" argument, configure a corresponding Host entry in your
`~/.ssh/config` such that you can ssh to it with no additional arguments. The
remote host must allow port forwarding.
Foxglove launches Firefox via a subprocess call to "firefox". On MacOS, the
Firefox binary is not typically in PATH, so foxglove first appends
`/Applications/Firefox.app/Contents/MacOS` to PATH. Prepending another
directory to PATH may be used to select a particular Firefox installation. For
example, you might launch Firefox Nightly on MacOS like this:
```bash
PATH="/Applications/Firefox Nightly.app/Contents/MacOS:$PATH" foxglove example
```
## Preferences
These settings have changed substantially during Firefox's development, so some
may be unsupported or meaningless in current versions.
Preference changes made to a foxglove-managed profile will reset to foxglove's
default values on the next run. To retain changes, you can either use the
generated profile as a normal Firefox profile without foxglove, or modify your
installation of foxglove's prefs.js file with your desired preferences.
Some foxglove defaults to consider changing:
| Key | Default | Foxglove | Comments |
| --------------------------------- | ------- | -------- | -----------------------------------------------|
| dom.event.clipboardevents.enabled | true | false | May break some sites |
| privacy.resistFingerprinting | false | false | May break some sites; can be counterproductive |
| privacy.donottrackheader.enabled | false | true | May be used for fingerprinting |
| network.trr.mode | 0 | 0 | TRRs can interfere with test environments |
## Related projects
- [Firefox Profilemaker](https://github.com/allo-/firefox-profilemaker)
Raw data
{
"_id": null,
"home_page": "https://github.com/adamreiser/foxglove",
"name": "foxglove",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "mozilla",
"author": "Adam Reiser",
"author_email": "reiser@defensivecomputing.io",
"download_url": "https://files.pythonhosted.org/packages/51/37/45c80e5444d49f25a8476eb99c03189ac62ff046aec24be031bfa03de8b1/foxglove-0.1.10.tar.gz",
"platform": null,
"description": "# foxglove\n\nFoxglove is a Firefox wrapper with two purposes:\n\n1. Programatically generate Firefox profiles with preferences that I consider\n desirable for the majority of use cases. These disable, where possible,\n Firefox's built-in advertising, pop-ups, telemetry, experiments, and similar\n features. Generated profiles are stored in `~/.foxglove`.\n\n2. If a remote host is given, ssh to it and use that connection as a SOCKS\n proxy. In either case, launch Firefox.\n\n```\nusage: foxglove [-h] [--chrome path] [--content path] [-d] [-e] [-a add-on] profile [host]\n\nfoxglove - a Firefox profile and proxy manager\n\npositional arguments:\n profile the name of the foxglove-managed profile to use or create\n host ssh server hostname. If this option is given, foxglove will attempt to use ssh(1) to connect to the host and configure Firefox to use it\n as a SOCKS proxy\n\noptional arguments:\n -h, --help show this help message and exit\n --chrome path path to a userChrome.css file to add to the profile\n --content path path to a userContent.css file to add to the profile\n -d dry run (don't launch Firefox)\n -e ephemeral (delete profile on exit)\n -a add-on download and install this add-on. Use the name as it appears in the Mozilla add-ons site URL. May be used multiple times\n```\n\nTo use the \"host\" argument, configure a corresponding Host entry in your\n`~/.ssh/config` such that you can ssh to it with no additional arguments. The\nremote host must allow port forwarding.\n\nFoxglove launches Firefox via a subprocess call to \"firefox\". On MacOS, the\nFirefox binary is not typically in PATH, so foxglove first appends\n`/Applications/Firefox.app/Contents/MacOS` to PATH. Prepending another\ndirectory to PATH may be used to select a particular Firefox installation. For\nexample, you might launch Firefox Nightly on MacOS like this:\n\n```bash\nPATH=\"/Applications/Firefox Nightly.app/Contents/MacOS:$PATH\" foxglove example\n```\n\n## Preferences\nThese settings have changed substantially during Firefox's development, so some\nmay be unsupported or meaningless in current versions.\n\nPreference changes made to a foxglove-managed profile will reset to foxglove's\ndefault values on the next run. To retain changes, you can either use the\ngenerated profile as a normal Firefox profile without foxglove, or modify your\ninstallation of foxglove's prefs.js file with your desired preferences.\n\nSome foxglove defaults to consider changing:\n\n| Key | Default | Foxglove | Comments |\n| --------------------------------- | ------- | -------- | -----------------------------------------------|\n| dom.event.clipboardevents.enabled | true | false | May break some sites |\n| privacy.resistFingerprinting | false | false | May break some sites; can be counterproductive |\n| privacy.donottrackheader.enabled | false | true | May be used for fingerprinting |\n| network.trr.mode | 0 | 0 | TRRs can interfere with test environments |\n\n## Related projects\n- [Firefox Profilemaker](https://github.com/allo-/firefox-profilemaker)\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Firefox proxy profile manager",
"version": "0.1.10",
"project_urls": {
"Homepage": "https://github.com/adamreiser/foxglove"
},
"split_keywords": [
"mozilla"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8b7b82e871b6a2d4019e3c6fc90d4be8a3da745870a704c6a8de74c974e859ff",
"md5": "19aeeb1fed0e4344af268f4d05c2b918",
"sha256": "3fffdeee8c42dc4aa14f59742525216013816d215a9054603c1f5c36bb735a20"
},
"downloads": -1,
"filename": "foxglove-0.1.10-py3-none-any.whl",
"has_sig": false,
"md5_digest": "19aeeb1fed0e4344af268f4d05c2b918",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6973,
"upload_time": "2024-10-03T00:01:29",
"upload_time_iso_8601": "2024-10-03T00:01:29.583883Z",
"url": "https://files.pythonhosted.org/packages/8b/7b/82e871b6a2d4019e3c6fc90d4be8a3da745870a704c6a8de74c974e859ff/foxglove-0.1.10-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "513745c80e5444d49f25a8476eb99c03189ac62ff046aec24be031bfa03de8b1",
"md5": "4c3f4048cedb37077fe1b44651a7a9e2",
"sha256": "6e5b2312e210929501a4bff4b4f1766623009abb1badf61d203b812359794fdd"
},
"downloads": -1,
"filename": "foxglove-0.1.10.tar.gz",
"has_sig": false,
"md5_digest": "4c3f4048cedb37077fe1b44651a7a9e2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7270,
"upload_time": "2024-10-03T00:01:31",
"upload_time_iso_8601": "2024-10-03T00:01:31.067860Z",
"url": "https://files.pythonhosted.org/packages/51/37/45c80e5444d49f25a8476eb99c03189ac62ff046aec24be031bfa03de8b1/foxglove-0.1.10.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-03 00:01:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "adamreiser",
"github_project": "foxglove",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "foxglove"
}
JSON
