{"id":19237463,"url":"https://github.com/webrecorder/pywb-remote-browsers","last_synced_at":"2025-10-09T14:02:50.847Z","repository":{"id":75541939,"uuid":"371600653","full_name":"webrecorder/pywb-remote-browsers","owner":"webrecorder","description":"Docker Compose based system for running remote browsers (including Flash and Java support) connected to web archives","archived":false,"fork":false,"pushed_at":"2021-06-10T00:46:14.000Z","size":120,"stargazers_count":15,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-12T19:30:16.624Z","etag":null,"topics":["browsers","emulation","pywb","remote-browsers","webrecorder"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/webrecorder.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},"funding":{"github":"webrecorder"}},"created_at":"2021-05-28T06:20:10.000Z","updated_at":"2025-03-29T13:28:01.000Z","dependencies_parsed_at":"2023-06-06T20:45:10.895Z","dependency_job_id":null,"html_url":"https://github.com/webrecorder/pywb-remote-browsers","commit_stats":{"total_commits":6,"total_committers":2,"mean_commits":3.0,"dds":"0.33333333333333337","last_synced_commit":"4655806d75d7385eebb27965ff301c3dcb2b9fff"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/webrecorder/pywb-remote-browsers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webrecorder%2Fpywb-remote-browsers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webrecorder%2Fpywb-remote-browsers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webrecorder%2Fpywb-remote-browsers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webrecorder%2Fpywb-remote-browsers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/webrecorder","download_url":"https://codeload.github.com/webrecorder/pywb-remote-browsers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/webrecorder%2Fpywb-remote-browsers/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279001524,"owners_count":26083117,"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-10-09T02:00:07.460Z","response_time":59,"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":["browsers","emulation","pywb","remote-browsers","webrecorder"],"created_at":"2024-11-09T16:26:46.551Z","updated_at":"2025-10-09T14:02:50.801Z","avatar_url":"https://github.com/webrecorder.png","language":"Python","funding_links":["https://github.com/sponsors/webrecorder"],"categories":[],"sub_categories":[],"readme":"# pywb Remote Browsers\n\nThis repository provides a simple configuration for deploying any [pywb](https://github.com/webrecorder/pywb)\nwith remote browsers provided by [OWT/Shepherd Remote Browser System](https://github.com/oldweb-today/shepherd)\n\nTo use:\n\n1) Clone this repo\n\n2) Add new or existing collections to the `collections` directory, eg. by running [wb-manager](https://pywb.readthedocs.io/en/latest/manual/apps.html#wb-manager)\n or copy an [existing pywb collections directory](https://pywb.readthedocs.io/en/latest/manual/configuring.html#directory-structure) into the local collections directory.\n\n3) Pull one or more Browser Docker Images from: https://hub.docker.com/r/oldwebtoday/chrome/tags or https://hub.docker.com/r/oldwebtoday/firefox/tags\n\n   **To use a browser with Flash Support, `chrome:84` is recommended., eg. `docker pull oldwebtoday/chrome:84`** \n   (See below for more info).\n\n4) Run `docker-compose up -d` to start.\n\n4) Go to `http://localhost:9020/`\n\n### Browsing UI\n\nThe default UI provides a set of controls for entering URL, timestamp, choosing a browser, and choosing a collection. The system will then start the selected remote browser connected to that pywb collection in an iframe.\n\n\u003cimg height=\"300px\" src=\"assets/screenshot1.png\"\u003e\u003c/img\u003e\n\n\n### Viewer UI\n\nTo load the remote browser directly without the iframe or sidebar controls, you can also visit `http://localhost:9020/\u003cbrowser\u003e/\u003ccoll\u003e/\u003ctimestamp\u003e/\u003curl\u003e`.\n\n\n## Getting Remote Browser Images\n\nThe Browser Images are downloaded manually, to allow users to choose which browsers they want to run.\n\nBrowsers can be obtained from the oldwebtoday browser repos including: https://hub.docker.com/r/oldwebtoday/chrome/tags and https://hub.docker.com/r/oldwebtoday/firefox/tags.\n\nAt least one browser must be downloaded for the system to work, eg. `docker pull oldwebtoday/chrome:84`.\n\n## Flash and Java support\n\nA key benefit of the remote browser system is to run older browsers, such as those supporting Flash and Java.\n\nHere are the latest version of Chrome and Firefox that we have available that support Flash and Java:\n\n- Flash: Chrome 84 (`chrome:84`) or Firefox 68 (`firefox:68`)\n- Java: Firefox 49 (`firefox:49`)\n\nAdditional browsers will (hopefully) be added in the future!\n\n## Adding pywb collections\n\npywb collections can be added while the system is running, and will be recognized on refresh, for example:\n\n```\nwb-manager init new-coll\nwb-manager add new-coll some-warc-files.warc\n```\n\nThe `new-coll` should now appear in the collection dropdown.\n\n\n## Audio\n\nThe system is configured with audio support via WebRTC, using a turn server operating on port 33478.\nThis port must be accessible to if connecting remotely.\n\nTODO Add docs on configuring over SSL via nginx proxying.\n\n## Recording Mode\n\nThe system also supports recording or capturing into new collections, using the [pywb Recording mode](https://pywb.readthedocs.io/en/latest/manual/configuring.html#recording-mode)\n\nTo enable recording mode, set `ALLOW_RECORD=1` in the docker-compose.yaml\n\nWhen enabled, the UI will show an recording checkbox. If checked, a new browser will be started in recording mode.\n\nThis can be used to record existing content, such as Flash or even Java content, using an older browser.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebrecorder%2Fpywb-remote-browsers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwebrecorder%2Fpywb-remote-browsers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwebrecorder%2Fpywb-remote-browsers/lists"}