This project has been archived due to a recent lack of motivation, and an unneccessary error caused as a result of asking for help that only made it worse.

I am not a professional, and I have been trying to do this project by myself for awhile. However after some point I began to ask for help for more advanced stuff, which almost no one could provide. So, I turned to LLMs. The help was decent at first, until they began to contradict themselves and change code in here without permission, or try to rewrite stuff that I explicitly told them not to. Even after I revoked access, cleared memory, or undid the corrupt changes, majority of the code had gotten rewritten before a commit of a previous version was made.

I made a decision that was honestly lame and it resulted in consequences. I had hopes for this browser, only to see them crused by my limited knowledge and the fact that I relied on tools controlled by corporations with no obligation to actually assist me.

It is because of this why this project has now been set aside, despite it being a dream for me to make since I was 15.

If you want to use this, go ahead. It is licensed under the Mozilla Public License Version 2.0 and is open source. Just, please remove the bunny images from your forks.

Electron CodeBrowser

Electron CodeBrowser is a lightweight, multi‑tab browser built using Electron and electron-as-browser. It includes a custom React‑based control panel, tab management, navigation controls, and a clean green UI theme.

Compilation

In the package.json file, there are four commands:

"scripts": {
  "start": "electron .",
  "start:control": "npm run update:control && npm run start",
  "update:control": "npx babel browser/renderer/control.jsx --out-file browser/renderer/control-compiled.js",
  "build": "electron-builder",
  "build:win64": "electron-builder --win --x64",
  "build:win32": "electron-builder --win --ia32",
  "build:winarm": "electron-builder --win --arm64",
  "build:linux": "electron-builder --linux --x64",
  "build:mac": "electron-builder --mac",
  "build:last": "npm run build:win64 && npm run build:win32 && npm run build:winarm && npm run build:linux",
  "docs": "documentation build *.js -f html -o docs"
},

npm run start

This runs an instance of electron as a means to preview it without having it be exported as a binary. This is good for quick testing.

npm run start:control

This does the same thing as npm run start and update:control. This is good for recompiling and testing.

npm run update:control

This command recompiles the control.jsx file in the renderer directory with babel.

npm run build

This command uses electron-builder to a testable local copy of the app into an executable, both a portable one and a not-so-portable one.

npm run build:[architecture]

This builds for the specific architecture you specify. Note: Based on what I know, electron-builder --mac only works properly on macOS.

npm run docs

This is a legacy command that was present in the original electron-as-browser repository. If you do not have documentation installed, it is obsolete.

In package.json, you will need to edit this line.

"build": {
  "appId": "com.electron.codebrowser",
  "productName": "Electron CodeBrowser",
  "directories": {
    "output": "dist"
  },
  "win": {
    "target": "portable",
    "signAndEditExecutable": false
  }
}

---

For more understanding on the electron node module, go to electronjs.org to learn more.

For more understanding on the electron-as-browser node module, go to electron-as-browser's README.md, hulufei's Github pages, and the original repository for more information.

Licensing Info

electron-codebrowser

The library electron-codebrowser by ELedlow The Fox is licensed under the Mozilla Public License Version 2.0 (see LICENSE).

This license applies only to the source code in this repository. Files listed in the LICENSING EXCEPTIONS document are not covered by the MPL‑2.0.

Original artwork (such as the two bunny images)

All custom artwork created by the project author, including the bunny images located in browser/fur/assets/newtab/, are NOT covered by the MPL‑2.0.

These images are © 2024–present ELedlow The Fox (Elijah Ledlow), ALL RIGHTS RESERVED. You may use or modify them for personal or educational purposes only, with proper attribution. Commercial use is strictly prohibited without explicit written permission. These images may not be used for dataset creation, machine learning training, or automated scraping.

Why are they in this repository?

Answer

I am an artist and can't help but include artworks I'm proud of in an open-source engine :3.

After all, I created the first concept for this browser when I was 15... although with electron-forge which I now realize is very inefficient for that purpose.

electron-as-browser

The library electron-as-browser by hui.liu is licensed under the MIT License (see docs/resources/electron-as-browser/LICENSE).

Chromium

Chromium is copyright 2015 The Chromium Authors, and is under a BSD-styled License (see docs/resources/chromium/LICENSE).

EasyList/EasyPrivacy

This browser dynamically uses filter lists provided by the EasyList authors, which uses a dual license. Due to the fact it is being refrenced dynamically, none of the original code is being altered, which prevents any conflicts with MPL-2.

Third‑party assets

Any third‑party assets included in this repository — whether implicitly or explicitly through node_modules/, jspm_packages/, or other bundled dependencies — are covered under the third‑party notice and retain their original licenses.