impulse-blocker - GitLite

KO | EN

gitlite — search

#javascript #ai #typescript #android #rust #deep-learning #docker #nodejs #java #awesome #awesome-list #pytorch #mcp #openai

impulse-blocker

(★ 178)

Block distracting websites when you are browsing the web. Use for procrastination.

파일 탐색기

최종 버전 다운로드 (.zip)

- - tests.yml
- - ic_block_48px.svg
  - icon48-disabled.png
  - icon48.png
  - icon96-disabled.png
  - icon96.png
  - icon980-disabled.png
  - icon980.png
  - LICENSE
  - README.md
  - unblock_48px.svg
- - redirect.css
  - redirect.html
  - redirect.js
- manifest.json
- options.html
- popup.html
- package-source.js
- test-e2e.js
- - ImpulseBlocker.test.js
- - extensionStatus.js
  - messages.js
  - settings.js
- - index.js
  - options.css
- - cogs.svg
  - index.js
  - popup.css
- - StorageHandler.js
  - Website.js
- - functions.js
  - holdDuration.js
  - tabs.js
- background.js
- ImpulseBlocker.js
- PopupIcon.js
.editorconfig
.eslintrc.js
.gitignore
.nvmrc
AGENTS.md
babel.config.json
LICENCE
package-lock.json
package.json
README.md
web-ext-config.mjs
webpack.config.js

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/raicem/impulse-blocker

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd impulse-blocker

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm run release

이 명령어를 터미널에 그대로 입력해 실행하세요.

npm run source

이 명령어를 터미널에 그대로 입력해 실행하세요.

npm test

이 명령어를 터미널에 그대로 입력해 실행하세요.

npm run test:e2e

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Impulse Blocker

Block distracting websites when you are browsing the web. Written using [WebExtensions](https://developer.mozilla.org/en-US/Add-ons/WebExtensions) so it will be compatible with the future releases of Firefox.

## Installation and Usage

**Recommended: install Impulse Blocker from the official Firefox Add-ons listing.**

[Install from Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/impulse-blocker/)

Simple usage guide can be found [here](https://blog.cemunalan.com.tr/2017/05/17/impulse-blocker-guide/).

## Building

If you want to build the extension yourself using the source code, follow these steps.

### Dependencies

Make sure you have Node.js `24.x` installed on your machine. This repository includes an `.nvmrc` file so version managers such as `fnm` and `nvm` can switch to the tested version automatically.

Then clone this repository:

```bash
git clone https://github.com/raicem/impulse-blocker.git
```

Then install the dependencies using `npm`

```bash
npm install
```

If you want to build it to sideload the extension without using the Mozilla's [AMO](https://addons.mozilla.org) use this command.

```
npm run release
```

This will create a zip file in the `web-ext-artifacts` folder. This file contains everything the Firefox needs to run the extension. You can install it following instructions [here](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/Distribution) and [here](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Distribution_options/Sideloading_add-ons).

Again, you can install the extension from the official [Firefox Add-ons page](https://addons.mozilla.org/en-US/firefox/addon/impulse-blocker/). Simple usage instructions are [here](https://blog.cemunalan.com.tr/2017/05/17/impulse-blocker-guide/).

### Mozilla source code submission

This extension uses Webpack, Babel, and CSS loaders to generate the files in `extension/dist`, so Mozilla reviewers need the source code package as well as the built extension package.

Build environment requirements:

- Node.js `24.x`; install it from [nodejs.org](https://nodejs.org/) or use a version manager such as `nvm` or `fnm` with the included `.nvmrc`.
- npm, included with Node.js.

To create the source code package for Mozilla reviewers:

```bash
npm install
npm run source
```

This creates `web-ext-artifacts/impulse-blocker-<version>-source.zip`. Upload that ZIP as the source code package in AMO.

To rebuild the submitted extension package from that source package:

```bash
npm install
npm run release
```

This rebuilds the extension files with Webpack and creates the installable extension ZIP in `web-ext-artifacts`.

## Contributing

The extension is open for any kinds of contribution. Please note that it requires a basic knowledge about [WebExtensions API](https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons) and [React](https://reactjs.org/).

After following the steps explained in the Building section above, all you have to do is run these commands in parallel.

`npm run watch` will start the Webpack watcher. This will immediately build the extension and create files to be loaded into the Firefox.

`npm run browser` will load the built files into the isolated Firefox instance and you will be able to see the changes you make immediately.

To also open Firefox's browser console and extension developer tools, run `npm run browser:debug` instead.

## Testing

Run the unit tests with:

```bash
npm test
```

Run the automated Firefox extension smoke test with:

```bash
npm run test:e2e
```

The end-to-end test builds the extension, launches an isolated headless Firefox
profile, installs the extension temporarily, and checks its options page and
persisted settings, then verifies blocking behavior against a local test
server. Firefox must be installed. On a failure, diagnostics are written under
`test-results/e2e-firefox`. Selenium Manager may download GeckoDriver the first
time the test runs.

`npm run browser` remains the interactive development command; it does not
finish on its own or report a test result.

Make sure you run through these steps to make sure the extension works.

Impulse Blocker testing

### Starting and stopping

- [ ] Start the blocker with no blocked websites. It should not interfere.
- [ ] Start blocking a website. It should be blocked.
- [ ] Add a second website to the block list. It should also be blocked.
- [ ] Stop the blocker. Websites should now be free to access.
- [ ] Start the blocker again. See the websites are blocked again.

### Pausing

- [ ] Pause the blocker. Websites should be free to access.
- [ ]  Cancel the pause. Websites should be blocked.
- [ ] Pause the blocker again and restart the browser. It should still be paused.
- [ ] Close the browser again and wait for pause period to finish. When you open the browser it should not be in pause state and websites must be blocked.
- [ ] Add a website when the blocker is paused. It should still be paused.

### Options page

- [ ] Add website from the options page. It should be blocked.
- [ ] Remove website from the options page. It should be now accessible.
- [ ] Stop extension from the options page. It should stop the blocker.
- [ ] Start the extension from the options page. It should start the blocker.
- [ ] Tick and check options and check they have the desired effect on the popup.

## Contributors

Huge thanks to contributors!

- [Crote](https://github.com/Crotek)
- [pkonneker](https://github.com/pkonneker)
- [Thynix](https://github.com/Thynix)
- [xeBuz](https://github.com/xeBuz)
- [Mattwmaster58](https://github.com/Mattwmaster58)
- [LorenzoAncora](https://github.com/LorenzoAncora)