{"id":13602874,"url":"https://github.com/loadenmb/pppFox","last_synced_at":"2025-04-11T13:31:37.395Z","repository":{"id":201373275,"uuid":"197188592","full_name":"loadenmb/pppFox","owner":"loadenmb","description":"Portable firefox \u0026 profile manager shell scripts which create \u0026 load firefox profiles with predefined proxy settings, useragent \u0026 mac address","archived":false,"fork":false,"pushed_at":"2019-09-12T11:26:23.000Z","size":65121,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-08-02T18:43:24.105Z","etag":null,"topics":["bash","firefox-profile","mac-changer","profile-manager","proxy-settings","useragent-switch"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/loadenmb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-07-16T12:20:38.000Z","updated_at":"2024-02-19T18:32:28.000Z","dependencies_parsed_at":null,"dependency_job_id":"8467107d-9b97-4121-86a3-2f9b0858e54f","html_url":"https://github.com/loadenmb/pppFox","commit_stats":null,"previous_names":["loadenmb/pppfox"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loadenmb%2FpppFox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loadenmb%2FpppFox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loadenmb%2FpppFox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loadenmb%2FpppFox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/loadenmb","download_url":"https://codeload.github.com/loadenmb/pppFox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223470300,"owners_count":17150530,"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","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":["bash","firefox-profile","mac-changer","profile-manager","proxy-settings","useragent-switch"],"created_at":"2024-08-01T18:01:41.293Z","updated_at":"2024-11-07T06:30:31.721Z","avatar_url":"https://github.com/loadenmb.png","language":"Shell","readme":"# pppFox: private, portable, proxy firefox\n\nPortable firefox \u0026 profile manager shell scripts which create \u0026 load firefox profiles with predefined proxy settings, useragent \u0026 mac address\n\nFully portable to spoof identity (IP \u0026 MAC \u0026 useragent) where ever you go\n- hide your identity (IP \u0026 MAC \u0026 useragent) from services used \n- hide connection meta data from local network operator\n\n-\u003e evade geo IP restrictions and avoid account suspension if multiple identities not allowed at a service\n\nBuzzwords: Firefox portable, profile manager, spoof identity\n\n[https://github.com/loadenmb/pppFox](https://github.com/loadenmb/pppFox)\n\n## Usage\n\n### Create unique firefox identity / profile\nCreate new unique firefox profile with defined user agent, proxy settings and mac address\n```\n./newIdentity.sh -h\npppFox: private, portable, proxy firefox\nusage:\n./newIdentity.sh --PROXY_IP [IP] --PROXY_PORT [PORT] --USERAGENT \"[AGENT STRING]\" --RANDOM_MAC [0|1]\n./newIdentity.sh -s [IP] -p [PORT] -a \"[AGENT STRING]\" -m [0|1]\nparameter:\n-s | --PROXY_IP                 proxy server ip\n-p | --PROXY_PORT               proxy server port, default: 8080\n-a | --USERAGENT                useragent\n-m | --RANDOM_MAC               generate random mac\n-i | --INTERFACE                overwrite network interface, default: eth0\n-h | --help                     display this\nconfigure default PROXY_IP, PROXY_PORT, USERAGENT, RANDOM_MAC (root required), INTERFACE in newIdentity.sh before launching\nexamples:\n./newIdentity.sh --PROXY_IP 127.0.0.1 --PROXY_PORT 2658 --USERAGENT \"Mozilla/5.0 (inux x86_64;) Gecko/201101\"\n./newIdentity.sh -s 127.0.0.1 -p 2658 -m 0\n./newIdentity.sh -s 127.0.0.1 -p 8080 -a \"Mozilla/5.0 (X11; Linux x86_64;) Gecko/201101 Firefox/60.0\"\n```\nImportant output is the new identity ID. (you need this id to load your profile again)\n```\npppFox: new identity: c4f11767db0bf2ab5b11e2917a7073f1\n```\n\n### Load identity by identity / profile folder name\nLoad private unique firefox profile with predefined proxy settings and mac address\n```\n./loadIdentity.sh -h\npppFox: private, portable, proxy firefox\nusage:\n./loadIdentity.sh --INTERFACE [INTERFACE] --RANDOM_MAC [0|1]\n./loadIdentity.sh -m [0|1] -i [INTERFACE]\nparameter:\n-m | --RANDOM_MAC               overwrite load random mac on / off\n-i | --INTERFACE                overwrite network interface, default: eth0\n-h | --help                     display this\nexamples:\n./loadIdentity.sh c4f11767db0bf2ab5b11e2917a7073f1            # load identity like defined\n./loadIdentity.sh 5                                           # load by line number from searchIdentity.sh\n./loadIdentity.sh                                             # will ask for identity string\n./loadIdentity.sh c4f11... --INTERFACE wlan0 --RANDOM_MAC 1   # change mac on interface\n./loadIdentity.sh -m 0  9b41499a51a31ecbac215a8ce0b1fb63      # without mac change\n```\n\n### Generate and set random mac address\n```shell\n./setRandomMac.sh\n``` \nFor desktop launch choose \"execute in terminal\" option for all scripts. (console input is expected)\n\n## Setup\n```shell\n# clone from git\ngit clone https://github.com/loadenmb/pppFox.git\n\ncd pppFox/\n\n# get a firefox version of your choice: http://releases.mozilla.org/pub/firefox/releases/\nwget http://releases.mozilla.org/pub/firefox/releases/67.0b9/linux-x86_64/en-US/firefox-67.0b9.tar.bz2\n\n# extract it to ./firefox/ subfolder\ntar -xjf firefox-67.0b9.tar.bz2\n\n# chmod +x scripts in base folder\nchmod +x ./*.sh\n```\n\n## Advanced usage\n\n### Search / list for identities / profiles\n```shell\n# search all facebook related firefox profiles\n./searchIdentity.sh *facebook*\n\n# search profile with exact match\n./searchIdentity.sh \"johndoe mail\"\n\n# list / search with assistant ;)\n./searchIdentity.sh \npppFox: search keyword or regular expression (leave empty for list of identities):\n     1  0a7d329f77835f94f01f408756c4ca4e johndoe mail\n     2  cd43d18e9555b2f2a20a04b5f8e65032 facebook marketing\n```\n\n### Delete identities / profiles\n```shell\n# delete single profile\n./deleteIdentity.sh 09ba510ca304850fd659aae4f1f4a8a0\npppFox: continue to delete identity 09ba510ca304850fd659aae4f1f4a8a0? [y/n]:y\n\n# delete all identities / profiles\nrm -r ./identities/*\n```\n\n### Default configuration\n\nConfigure default PROXY_IP, PROXY_PORT, USERAGENT, RANDOM_MAC (root required), INTERFACE in newIdentity.sh.\n```\n##\n## \u003cconfiguration\u003e\n##\nPROXY_IP=\"127.0.0.1\"\nPROXY_PORT=\"8080\"\nUSERAGENT=\"Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Firefox/60.0\"\n\nRANDOM_MAC=1; # 1 = mac change enabled (root required), 0 = mac change disabled\nINTERFACE=\"eth0\" # network interface for mac change: eth0, wlan0\n##\n## \u003c/configuration\u003e\n##\n```\n## Details\n| What                                                       |  Value         | \n| ---------------------------------------------------------- | -------------- |\n| scripts tested on:                                         | Debian Stretch |\n| for configuration options see ## \u003cconfiguration\u003e block at: | ./newIdentity.sh, ./loadIdentity.sh, ./setRandomMac.sh |\n| hardened firefox settings are copied from:                 | ./var/user.js |\n| identities / profiles stored at:                           | ./identities/[0-9a-f]{32}/ |\n| mac address is stored at:                                  | ./identities/[0-9a-f]{32}/mac_address.txt |\n| network interface is stored at:                            | ./identities/[0-9a-f]{32}/interface.txt |\n| firefox proxy and useragent settings are inserted at:      | ./identities/[0-9a-f]{32}/user.js |\n| identity / profile names stored at:                        | ./identities/identity_names.txt |\n\nFirefox options set by script:\n- network.proxy.type\n- network.proxy.share_proxy_settings\n- network.proxy.socks_remote_dns\n- network.proxy.http_port\n- network.proxy.http\n- useragent.override\n\n## Contribute\n\nDiscuss features, report issues, questions -\u003e [here](https://github.com/loadenmb/pppFox/issues).\n\nDeveloper -\u003e fork \u0026 pull ;)\n\n## Related\n- [Proxy list](https://www.google.com/search?q=proxy+list)    \n- [Firefox releases](http://releases.mozilla.org/pub/firefox/releases/)\n- User agent lists:\n    - [myip.ms](https://myip.ms/browse/comp_browseragents/Computer_Browser_Agents.html)\n    - [whatismybrowser.com](https://developers.whatismybrowser.com/useragents/explore/)\n- [Proxychains - force TCP app to use one or more proxy server](https://github.com/haad/proxychains)\n\n","funding_links":[],"categories":["bash"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floadenmb%2FpppFox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Floadenmb%2FpppFox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floadenmb%2FpppFox/lists"}