{"id":13406282,"url":"https://github.com/samuelmaddock/electron-browser-shell","last_synced_at":"2025-05-14T18:04:16.976Z","repository":{"id":37186523,"uuid":"245590688","full_name":"samuelmaddock/electron-browser-shell","owner":"samuelmaddock","description":"A minimal, tabbed web browser with support for Chrome extensions—built on Electron.","archived":false,"fork":false,"pushed_at":"2025-04-24T00:17:52.000Z","size":2830,"stargazers_count":506,"open_issues_count":23,"forks_count":100,"subscribers_count":12,"default_branch":"master","last_synced_at":"2025-05-12T12:44:52.157Z","etag":null,"topics":["browser","chrome-extension","electron"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/samuelmaddock.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["samuelmaddock"]}},"created_at":"2020-03-07T07:52:41.000Z","updated_at":"2025-05-09T04:49:03.000Z","dependencies_parsed_at":"2024-10-23T05:57:53.531Z","dependency_job_id":"5796a63f-f337-4399-bbd8-29bb45f7cfc3","html_url":"https://github.com/samuelmaddock/electron-browser-shell","commit_stats":{"total_commits":359,"total_committers":6,"mean_commits":"59.833333333333336","dds":0.03621169916434541,"last_synced_commit":"3a7845e46ca7cbe53e6645190fd5bf68c32fd638"},"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelmaddock%2Felectron-browser-shell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelmaddock%2Felectron-browser-shell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelmaddock%2Felectron-browser-shell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/samuelmaddock%2Felectron-browser-shell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/samuelmaddock","download_url":"https://codeload.github.com/samuelmaddock/electron-browser-shell/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254198452,"owners_count":22030964,"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":["browser","chrome-extension","electron"],"created_at":"2024-07-30T19:02:26.140Z","updated_at":"2025-05-14T18:04:14.914Z","avatar_url":"https://github.com/samuelmaddock.png","language":"TypeScript","readme":"# electron-browser-shell\n\nA minimal, tabbed web browser with support for Chrome extensions—built on Electron.\n\n![browser preview image showing 3 tabs and a youtube video](./screenshot.png)\n\n## Packages\n\n| Name                                                                    | Description                                                                                  |\n| ----------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |\n| [shell](./packages/shell)                                               | A minimal, tabbed web browser used as a testbed for development of Chrome extension support. |\n| [electron-chrome-extensions](./packages/electron-chrome-extensions)     | Adds additional API support for Chrome extensions to Electron.                               |\n| [electron-chrome-context-menu](./packages/electron-chrome-context-menu) | Chrome context menu for Electron browsers.                                                   |\n| [electron-chrome-web-store](./packages/electron-chrome-web-store)       | Download extensions from the Chrome Web Store in Electron.                                   |\n\n## Usage\n\n```bash\n# Get the code\ngit clone git@github.com:samuelmaddock/electron-browser-shell.git\ncd electron-browser-shell\n\n# Install and launch the browser\nyarn\nyarn start\n```\n\n### Install extensions\n\nNavigate to the [Chrome Web Store](https://chromewebstore.google.com/) and install an extension.\n\nTo test local unpacked extensions, include them in `./extensions` then launch the browser.\n\n## Roadmap\n\n### 🚀 Current\n\n- [x] Browser tabs\n- [x] Unpacked extension loader\n- [x] Initial [`chrome.tabs` extensions API](https://developer.chrome.com/extensions/tabs)\n- [x] Initial [extension popup](https://developer.chrome.com/extensions/browserAction) support\n- [x] .CRX extension loader\n- [x] [Chrome Web Store](https://chromewebstore.google.com) extension installer\n- [x] Automatic extension updates\n- [x] [Manifest V3](https://developer.chrome.com/docs/extensions/mv3/intro/) support—pending [electron/electron#44411](https://github.com/electron/electron/pull/44411)\n- [ ] Support for common [`chrome.*` extension APIs](https://developer.chrome.com/docs/extensions/reference/api)\n- [ ] Robust extension popup support\n- [ ] Respect extension manifest permissions\n\n### 🤞 Eventually\n\n- [ ] Extension management (enable/disable/uninstall)\n- [ ] Installation prompt UX\n- [ ] [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com/addons/Microsoft-Edge-Extensions-Home) extension installer\n- [ ] Full support of [`chrome.*` extension APIs](https://developer.chrome.com/docs/extensions/reference/api)\n\n### 🤔 Considering\n\n- [ ] Opt-in support for custom `webRequest` blocking implementation\n- [ ] Browser tab discarding\n\n### ❌ Not planned\n\n- [Chrome Platform App APIs](https://developer.chrome.com/docs/extensions/reference/#platform_apps_apis)\n\n## License\n\nMost packages in this project use MIT with the exception of electron-chrome-extensions.\n\nFor proprietary use, please [contact me](mailto:sam@samuelmaddock.com?subject=electron-browser-shell%20license) or [sponsor me on GitHub](https://github.com/sponsors/samuelmaddock/) under the appropriate tier to [acquire a proprietary-use license](https://github.com/samuelmaddock/electron-browser-shell/blob/master/LICENSE-PATRON.md). These contributions help make development and maintenance of this project more sustainable and show appreciation for the work thus far.\n\n### Contributor license agreement\n\nBy sending a pull request, you hereby grant to owners and users of the\nelectron-browser-shell project a perpetual, worldwide, non-exclusive,\nno-charge, royalty-free, irrevocable copyright license to reproduce, prepare\nderivative works of, publicly display, publicly perform, sublicense, and\ndistribute your contributions and such derivative works.\n\nThe owners of the electron-browser-shell project will also be granted the right to relicense the\ncontributed source code and its derivative works.\n","funding_links":["https://github.com/sponsors/samuelmaddock","https://github.com/sponsors/samuelmaddock/"],"categories":["TypeScript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamuelmaddock%2Felectron-browser-shell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsamuelmaddock%2Felectron-browser-shell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsamuelmaddock%2Felectron-browser-shell/lists"}