chikl/Lightbeam
1
8
Fork
You've already forked Lightbeam
2
This is an add-on for visualizing HTTP requests between websites in real time. https://lightbeam.chikl.de/
  • JavaScript 79.6%
  • CSS 13.9%
  • HTML 5.7%
  • Python 0.8%
2026年07月10日 15:32:56 +02:00
.husky switched to package manager Yarn; using new flat config file for eslint; using prettier for formatting 2023年04月28日 15:17:22 +02:00
.yarn Chore: Update dependencies 2026年07月10日 15:31:57 +02:00
docs Docs: Move doc about structure to separate file 2026年05月02日 15:30:43 +02:00
scripts clean up + update of libs 2023年11月23日 09:21:53 +01:00
shavar-prod-lists @a7390396c6 Chore: Update shavar-prod-lists 2026年04月19日 15:57:47 +02:00
src Prevent error 2026年07月10日 15:32:56 +02:00
test/unit Refactor: Implement method only once 2026年05月25日 16:34:58 +02:00
.gitattributes Attempt to fix those line endings ( #194 ) 2017年09月01日 10:07:35 -07:00
.gitignore switched to package manager Yarn; using new flat config file for eslint; using prettier for formatting 2023年04月28日 15:17:22 +02:00
.gitmodules Chore: Update shavar-prod-lists 2026年04月19日 15:57:47 +02:00
.mocharc.yml no retries when testing 2023年08月17日 21:08:08 +02:00
.prettierignore switched to package manager Yarn; using new flat config file for eslint; using prettier for formatting 2023年04月28日 15:17:22 +02:00
.prettierrc.json switched to package manager Yarn; using new flat config file for eslint; using prettier for formatting 2023年04月28日 15:17:22 +02:00
.yarnrc.yml Update Yarn 2025年12月22日 11:21:18 +01:00
CHANGELOG.md Replace placeholder for release date 2026年05月01日 15:15:30 +02:00
CONTRIBUTING.md Docs: Add initial version of CONTRIBUTING.md 2026年06月17日 10:00:15 +02:00
eslint.config.js Ease eslint rules for console output 2025年09月28日 12:46:41 +02:00
LICENSE Initial commit 2017年04月20日 12:55:56 +10:00
package.json Chore: Update dependencies 2026年07月10日 15:31:57 +02:00
README.md Update dev dependencies 2025年06月25日 20:03:44 +02:00
yarn.lock Chore: Update dependencies 2026年07月10日 15:31:57 +02:00

Firefox Lightbeam

This is an add-on for visualizing HTTP requests between websites in real time, originally developed by Mozilla.

Mozilla stopped the development in 2019 (https://support.mozilla.org/en-US/kb/lightbeam-extension-firefox-no-longer-supported) and the source code (https://github.com/mozilla/lightbeam-we) of that project was used to create this fork.

lightbeam-screenshot

Quick Start

Clone the repository

Note This repository uses a submodule to allow some third party requests. To ensure the submodule is cloned along with this repository, use a modified clone command: git clone --recursive https://codeberg.org/chikl/Lightbeam.git

Run the web extension

There are a couple ways to try out this web extension:

  1. Open Firefox and load about:debugging in the URL bar.

    • Click the on "This Firefox" on the left side and on the button "Load Temporary Add-on" and select the manifest.json file within the directory of this repository.
    • You should now see the Lightbeam icon on the top right bar of the browser.
    • Click the Lightbeam icon to launch the web extension.

  2. Install the web-ext tool, change into the src directory of this repository, and type web-ext run.

    • This will launch Firefox and install the extension automatically.
    • This tool gives you some additional development features such as automatic reloading.
    • Alternatively, you can run yarn dev to start Firefox with the extension.
    • For Firefox on Android you can run yarn dev:android. Therefore, you have to enable USB-Debugging on your device and plug it into your computer. Also, this works only if you connected only one device with the computer and not with multiple.

Development Guide

Prepare your development environment

This repo is using the package manager yarn. Use the official documentation with installation instructions.

Download dependencies and build the extension

Run yarn to build dependencies.

Run yarn prepare to enable husky (to run linting before commits) and clone the submodule.

Run yarn build.

Update the submodule

To manually update the submodule at any time during development, run git submodule update --remote.

Debugging

Desktop

For most things the web console of the developer tools is sufficient. If you implement something in the background script you won't see logs in the normal web console. In this case run the extension and load about:debugging in the URL bar. Click on "This Firefox" on the left side then you should be able to see Lightbeam in the list. Click "Inspect" and you will see a console where the background script logs are visible.

For more information have a look at the official documentation.

Android

Above you can see how to run the extension on Android. For the debugging part visit the official documentation.

Testing

Run yarn test for functional tests.

Run yarn lint to check if formatting etc. is OK.

Eslint is used for linting. Mocha & Chai are used for unit testing. See the file package.json for the details what the commands above do.

Assets