{"id":13670780,"url":"https://github.com/christian-bromann/devtools-backend","last_synced_at":"2025-09-11T12:32:05.542Z","repository":{"id":55667694,"uuid":"90010478","full_name":"christian-bromann/devtools-backend","owner":"christian-bromann","description":"Standalone implementation of the Chrome DevTools backend to debug arbitrary web environments.","archived":false,"fork":false,"pushed_at":"2022-02-01T18:50:59.000Z","size":2054,"stargazers_count":144,"open_issues_count":7,"forks_count":24,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-12-30T21:08:04.392Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/christian-bromann.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}},"created_at":"2017-05-02T08:39:42.000Z","updated_at":"2024-11-12T21:10:22.000Z","dependencies_parsed_at":"2022-08-15T06:00:51.208Z","dependency_job_id":null,"html_url":"https://github.com/christian-bromann/devtools-backend","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/christian-bromann%2Fdevtools-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/christian-bromann%2Fdevtools-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/christian-bromann%2Fdevtools-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/christian-bromann%2Fdevtools-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/christian-bromann","download_url":"https://codeload.github.com/christian-bromann/devtools-backend/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":232646355,"owners_count":18555273,"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":[],"created_at":"2024-08-02T09:00:49.409Z","updated_at":"2025-01-05T21:58:44.257Z","avatar_url":"https://github.com/christian-bromann.png","language":"JavaScript","readme":"DevTools Backend\n================\n\n‼️ __Attention:__ this project is not maintained anymore. Dependencies are out of date and introduce security vulnerabilities. Please not use it in production. ‼️\n\nA Node.JS implementation of the Chrome DevTools backend for debugging arbitrary web platforms (e.g. HbbTV applications on Smart TVs). It is the counterpart of the [devtools-frontend](https://github.com/ChromeDevTools/devtools-frontend) and is like [weinre](https://people.apache.org/~pmuellr/weinre/docs/latest/Home.html) just in \"new\".\n\n# Requirements\n\n- [Node.js](https://nodejs.org/en/) (v8.2.1)\n- [NPM](https://www.npmjs.com/) (v5.3.0 or higher)\n\n# Installation\n\nTo run the server you need to first clone the repo and install all its dependencies:\n\n```sh\n# clone repository\n$ git clone git@gitlab.fokus.fraunhofer.de:christian.bromann/devtools-backend.git\n$ cd devtools-backend\n# install dependencies\n$ npm install\n# build project\n$ npm run build\n```\n\nThen start the server by executing:\n\n```sh\n$ npm run start\n```\n\nYou now have started the server on `localhost:9222`. You can see a list of inspectable pages on http://localhost:9222 (also available as [json](http://localhost:9222/json)).\n\n# Instrument Your Web Application\n\nThe DevTools Backend allows you to instrument your app in two different ways. You can either inject a script manually into your app or use the proxy to automate the injection.\n\n## Manual Script Injection\n\nTo manually inject a script put the following script tag at the top of your page:\n\n```html\n\u003cscript src=\"http://localhost:9222/scripts/launcher.js\" data-origin=\"debugger\"\u003e\u003c/script\u003e\n```\n\nOnce you open a page with a web client (like a browser) it should register your page and it should then be inspectable.\n\n## Proxy Script Injection\n\nIf your web client supports proxy settings you can also use the DevTools backend as HTTP proxy (note that this only works for pages served via http on port 80). Per default the server starts with the hostname of the machine it runs on. For example if you run the project on localhost and setup Firefox to proxy request to `localhost:9222` it would allow to debug the Firefox browser with the DevTools application.\n\n![Firefox Demo](/docs/assets/demo.gif)\n\n## Logging\n\nFor debugging purposes you can set a logging path as environment variable and the DevTools Proxy will dump all log messages to multiple files within this directory. To set a logging directory just export `LOGGING_PATH`:\n\n```sh\nexport LOGGING_PATH=/home/user/logs\n# or start the server with that environment variable set\nLOGGING_PATH=/home/user/logs npm run start\n```\n\n## Development\n\nTo recompile files automatically run:\n\n```sh\n$ npm run dev\n```\n\nAfter files are recompiled you need to restart the server. This can be triggered automatically when running it in \"dev\" mode:\n\n```sh\n$ npm run start:dev\n```\n\n***\n\nThis project was created as part of a master thesis by [Christian Bromann](https://github.com/christian-bromann) on _\"Design and implementation of a Development and Test Automation Platform for HbbTV\"_. The dissertation originated in cooperation with the [Fraunhofer Institute for Open Communication Systems (FOKUS)](https://www.fokus.fraunhofer.de/en) and [Louay Bassbouss](https://github.com/louaybassbouss).\n","funding_links":[],"categories":["JavaScript","Alumni"],"sub_categories":["Automation"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchristian-bromann%2Fdevtools-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchristian-bromann%2Fdevtools-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchristian-bromann%2Fdevtools-backend/lists"}