{"id":15108816,"url":"https://github.com/remotedebug/remotedebug-ios-webkit-adapter","last_synced_at":"2025-09-27T10:30:26.635Z","repository":{"id":52240784,"uuid":"74258441","full_name":"RemoteDebug/remotedebug-ios-webkit-adapter","owner":"RemoteDebug","description":"Debug Safari and WebViews on iOS from tools like VS Code and Chrome DevTools","archived":true,"fork":false,"pushed_at":"2021-03-03T05:09:06.000Z","size":923,"stargazers_count":2733,"open_issues_count":0,"forks_count":225,"subscribers_count":59,"default_branch":"master","last_synced_at":"2025-04-15T20:46:37.943Z","etag":null,"topics":["chrome-devtools","debugger","devtools","ios","protocol-adapter","remotedebug","safari"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RemoteDebug.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-20T07:03:32.000Z","updated_at":"2025-04-14T17:48:42.000Z","dependencies_parsed_at":"2022-08-17T16:05:18.549Z","dependency_job_id":null,"html_url":"https://github.com/RemoteDebug/remotedebug-ios-webkit-adapter","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"purl":"pkg:github/RemoteDebug/remotedebug-ios-webkit-adapter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RemoteDebug%2Fremotedebug-ios-webkit-adapter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RemoteDebug%2Fremotedebug-ios-webkit-adapter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RemoteDebug%2Fremotedebug-ios-webkit-adapter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RemoteDebug%2Fremotedebug-ios-webkit-adapter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RemoteDebug","download_url":"https://codeload.github.com/RemoteDebug/remotedebug-ios-webkit-adapter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RemoteDebug%2Fremotedebug-ios-webkit-adapter/sbom","scorecard":{"id":119704,"data":{"date":"2025-08-11","repo":{"name":"github.com/RemoteDebug/remotedebug-ios-webkit-adapter","commit":"efef783cb624361df3b28da095829a5f89ab7d85"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.4,"checks":[{"name":"Code-Review","score":2,"reason":"Found 6/24 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"project is archived","details":["Warn: Repository is archived."],"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/auto_tags.yml:1","Warn: no topLevel permission defined: .github/workflows/build.yml:1","Warn: no topLevel permission defined: .github/workflows/publish.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/auto_tags.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/RemoteDebug/remotedebug-ios-webkit-adapter/auto_tags.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/auto_tags.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/RemoteDebug/remotedebug-ios-webkit-adapter/auto_tags.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/RemoteDebug/remotedebug-ios-webkit-adapter/build.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/RemoteDebug/remotedebug-ios-webkit-adapter/build.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/RemoteDebug/remotedebug-ios-webkit-adapter/publish.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/publish.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/RemoteDebug/remotedebug-ios-webkit-adapter/publish.yml/master?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/publish.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/RemoteDebug/remotedebug-ios-webkit-adapter/publish.yml/master?enable=pin","Warn: npmCommand not pinned by hash: .github/workflows/build.yml:22","Warn: npmCommand not pinned by hash: .github/workflows/publish.yml:22","Info:   0 out of   5 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   2 third-party GitHubAction dependencies pinned","Info:   0 out of   2 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 13 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"47 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-v88g-cgmw-v5xw","Warn: Project is vulnerable to: GHSA-93q8-gq69-wqmw","Warn: Project is vulnerable to: GHSA-qwcr-r2fm-qrc7","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg","Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x","Warn: Project is vulnerable to: GHSA-897m-rjf5-jp39","Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275","Warn: Project is vulnerable to: GHSA-gxpj-cx7g-858c","Warn: Project is vulnerable to: GHSA-w573-4hg7-7wgq","Warn: Project is vulnerable to: GHSA-4gmj-3p3h-gm8h","Warn: Project is vulnerable to: GHSA-rv95-896h-c2vc","Warn: Project is vulnerable to: GHSA-qw6h-vgh9-j6wx","Warn: Project is vulnerable to: GHSA-2j2x-2gpw-g8fm","Warn: Project is vulnerable to: GHSA-fjxv-7rqg-78g4","Warn: Project is vulnerable to: GHSA-8r6j-v8pm-fqw3","Warn: Project is vulnerable to: MAL-2023-462","Warn: Project is vulnerable to: GHSA-43f8-2h32-f4cj","Warn: Project is vulnerable to: GHSA-qqgx-2p2h-9c37","Warn: Project is vulnerable to: GHSA-896r-f27r-55mw","Warn: Project is vulnerable to: GHSA-p6mc-m468-83gw","Warn: Project is vulnerable to: GHSA-29mw-wpgm-hmr9","Warn: Project is vulnerable to: GHSA-35jh-r3h4-6jhm","Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv","Warn: Project is vulnerable to: GHSA-f8q6-p94x-37v3","Warn: Project is vulnerable to: GHSA-vh95-rmgr-6w4m","Warn: Project is vulnerable to: GHSA-xvch-5gv4-984h","Warn: Project is vulnerable to: GHSA-gmwp-3pwc-3j3g","Warn: Project is vulnerable to: GHSA-hj48-42vr-x3v9","Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j","Warn: Project is vulnerable to: GHSA-rhx6-c78j-4q9w","Warn: Project is vulnerable to: GHSA-hrpp-h998-j3pp","Warn: Project is vulnerable to: GHSA-p8p7-x288-28g6","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw","Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg","Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p","Warn: Project is vulnerable to: GHSA-3jfq-g458-7qm9","Warn: Project is vulnerable to: GHSA-r628-mhmh-qjhw","Warn: Project is vulnerable to: GHSA-9r2w-394v-53qc","Warn: Project is vulnerable to: GHSA-5955-9wpr-37jh","Warn: Project is vulnerable to: GHSA-qq89-hq3f-393p","Warn: Project is vulnerable to: GHSA-f5x3-32g6-xq36","Warn: Project is vulnerable to: GHSA-72xf-g2v4-qvf3","Warn: Project is vulnerable to: GHSA-6fc8-4gx4-v693","Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q","Warn: Project is vulnerable to: GHSA-c4w7-xm78-47vh","Warn: Project is vulnerable to: GHSA-p9pc-299p-vxgp"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-16T02:13:11.278Z","repository_id":52240784,"created_at":"2025-08-16T02:13:11.278Z","updated_at":"2025-08-16T02:13:11.278Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":277218688,"owners_count":25781444,"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-09-27T02:00:08.978Z","response_time":73,"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":["chrome-devtools","debugger","devtools","ios","protocol-adapter","remotedebug","safari"],"created_at":"2024-09-25T22:40:53.221Z","updated_at":"2025-09-27T10:30:26.272Z","avatar_url":"https://github.com/RemoteDebug.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Update on RemoteDebug iOS WebKit Adapter\n\nRemoteDebug is now superseeded by https://inspect.dev/ – a new developer tool for macOS and Windows to inspect and debug your web apps and websites in Safari and WebViews on iOS devices 🤯🎉🔥 \n\n\u003cp\u003e\u003cstrong\u003eMaintenance status:\u003c/strong\u003e RemoteDebug iOS WebKit Adapter is not proactively maintained or extended.\n\n\u003cdetails\u003e\u003csummary\u003eOriginal readme\u003c/summary\u003e\n    \n## RemoteDebug iOS WebKit Adapter\n\nRemoteDebug iOS WebKit Adapter is an protocol adapter that Safari and WebViews on iOS to be debugged from tools like VS Code, Chrome DevTools, Mozilla Debugger.html and other tools compatible with the Chrome Debugging Protocol.\n\n![](.readme/overview.png)\n\nRead more in the introduction blog post on Medium: [Hello RemoteDebug iOS WebKit Adapter: iOS web debugging with Chrome DevTools, VS Code \u0026 Mozilla Debugger.html 📡📱](https://medium.com/@auchenberg/hello-remotedebug-ios-webkit-adapter-ios-web-debugging-with-chrome-devtools-vs-code-mozilla-2a8553df7465)\n\n## Getting Started\n\n### 1) Install dependencies\n\nBefore you use this adapter you need to make sure you have the [latest version of iTunes](http://www.apple.com/itunes/download/) installed, as we need a few libraries provided by iTunes to talk to the iOS devices.\n\n#### Linux\n\nFollow the instructions to install [ios-webkit-debug-proxy](https://github.com/google/ios-webkit-debug-proxy#installation)  and [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice)\n\n#### Windows\n\nInstall [ios-webkit-debug-proxy](https://github.com/google/ios-webkit-debug-proxy#installation)  and [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice). On Windows you can use [scoop](http://scoop.sh/):\n\n```\nscoop bucket add extras\nscoop install ios-webkit-debug-proxy\n```\n\n\n\n#### OSX/Mac\nMake sure you have Homebrew installed, and run the following command to install [ios-webkit-debug-proxy](https://github.com/google/ios-webkit-debug-proxy) and [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice)\n\n```\nbrew update\nbrew unlink libimobiledevice ios-webkit-debug-proxy usbmuxd\nbrew uninstall --force libimobiledevice ios-webkit-debug-proxy usbmuxd\nbrew install --HEAD usbmuxd\nbrew install --HEAD libimobiledevice\nbrew install --HEAD ios-webkit-debug-proxy\n```\n\n### 2) Install latest version of the adapter\n\n```\nnpm install remotedebug-ios-webkit-adapter -g\n```\n\n### 3) Enable remote debugging in Safari\nIn order for your iOS targets to show up, you need to enable remote debugging.\n\nOpen iOS Settings =\u003e Safari preferences =\u003e enable \"Web Inspector\"\n\n### 4) Make your computer trust your iOS device.\n\nOn MacOS you can use Safari to inspect an iOS Safari tab. This will ensure the device is trusted.\n\nOn Windows starting iTunes could prompt the \"Trust this computer\" dialog.\n\n### 5) Run the adapter from your favorite command line\n\n```\nremotedebug_ios_webkit_adapter --port=9000\n```\n\nBTW: `ios-webkit-debug-proxy` will be run automatically for you, no need to start it separately.\n\n\n### 6) Open your favorite tool\n\nOpen your favorite tool such as Chrome DevTools or Visual Studio Code and configure the tool to connect to the protocol adapter.\n\n## Configuration\n\n```\nUsage: remotedebug_ios_webkit_adapter --port [num]\n\nOptions:\n  -p, --port  the adapter listening port  [default: 9000]\n  --version   prints current version\n\n```\n\n## Usage\n### Usage with Chrome (Canary) and Chrome DevTools\n\nYou can have your iOS targets show up in Chrome's `chrome://inspect` page by leveraging the new network discoverbility feature where you simple add the IP of computer running the adapter ala `localhost:9000`.\n\n![](.readme/chrome_inspect.png)\n\n### Using with Mozilla debugger.html\n\nYou can have your iOS targets show up in [Mozila debugger.html](https://github.com/devtools-html/debugger.html), by starting `remotedebug_ios_webkit_adapter --port=9222` and selecting the Chrome tab.\n\n![](.readme/debugger_html.png)\n\n### Using with Microsoft VS Code\n\nInstall [VS Code](https:/code.visualstudio.com), and the [VS Code Chrome Debugger](https://marketplace.visualstudio.com/items?itemName=msjsdiag.debugger-for-chrome), then create a `launch.json` configuration where `port` is set to 9000, like below:\n\n```json\n{\n    \"version\": \"0.2.0\",\n    \"configurations\": [\n        {\n            \"name\": \"iOS Web\",\n            \"type\": \"chrome\",\n            \"request\": \"attach\",\n            \"port\": 9000,\n            \"url\": \"http://localhost:8080/*\",\n            \"webRoot\": \"${workspaceRoot}/src\"\n        }\n    ]\n}\n```\n\n## Architecture\nThe protocol adapter is implemented in TypeScript as Node-based CLI tool which starts an instance of [ios-webkit-debug-proxy](https://github.com/google/ios-webkit-debug-proxy), detects the connected iOS devices, and then starts up an instance of the correct protocol adapter depending on the iOS version.\n\n![](.readme/architecture.png)\n\n## How to contribute\n\n```\nnpm install\nnpm start\n```\n\n## Diagnostics logging\n\n```\nDEBUG=remotedebug npm start\n```\n\n### License\nMIT\n\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremotedebug%2Fremotedebug-ios-webkit-adapter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fremotedebug%2Fremotedebug-ios-webkit-adapter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fremotedebug%2Fremotedebug-ios-webkit-adapter/lists"}