Skip to content

CatBlock - An ad-blocking extension for Chrome, Opera, Safari, Firefox and Edge!

License

Notifications You must be signed in to change notification settings

KoenPasman/catblock

 
 

Repository files navigation

CatBlock

Build Status Codacy Badge GPL v3

CatBlock (previously known as "AdBlock with CatBlock") is like an ad blocking extension, but instead of blocking ads it shows you pictures of cats by default (configurable).

You can also disable replacing ads by cats, so CatBlock can work as a standard ad blocking extension (useful for when you're doing presentations anywhere!)

This project aims at maintaining and improving the original CatBlock project by Michael Gundlach, the creator of AdBlock and CatBlock.

If you want to keep an eye on (or even contribute to) the behind-the-scenes stuff, check out our Trello Board.

Installation:

Available in Chrome Web Store, Opera Extensions Store and Firefox Addons Store. Right now, CatBlock is not available in the Safari Extensions Store, or in the Windows Store (for Edge insiders). Instead, you must sideload the extension: Edge instructions.

Tools used for testing:

We use many different services to help keep CatBlock working! We use Travis to build new versions automatically for us. We're looking into a way of making a "nightly" version of CatBlock, with bleeding-edge (probably broken) code for testing.

We also have Travis connected to BrowserStack, to run a few automated tests for us. If "builds:passing" shows at the top of this README, then it's probably working fine, otherwise the current version of the code might not work so well.

Compatibility:

Chrome: 49+ Opera: 35+ Safari: 6+ Firefox: 48+ Edge: 38.14342+

Live chat:

Slack

We use Slack a lot - make an account at http://catblock-slackin.herokuapp.com and log in at https://catblock.slack.com. You can ask questions there (the main contributors are all in Europe, so anyone in Australia should expect a bit of a wait).

If you want to contribute any improvements, please go ahead and send us a pull request from a fork of this repo!

Developers

  1. Fork this repository.
  2. Switch to your working directory.
  3. Clone the development repository.

In Chrome

  1. Go to the Chrome menu > Tools > Extensions.
  2. Check Developer mode then press Load unpacked extension... .
  3. Find your working directory & select it.
  4. To test after you make a change, be sure to click on Reload button on chrome://extensions page.
  5. Push your changes.
  6. Send us pull request!

In Safari

  1. First, you need to obtain a Safari Developer Certificate from Apple
  2. Go to Develop > Show Extension Builder.
  3. Click + then select Add Extension... .
  4. Find your working directory & select it.
  5. Click Install.
  6. To test after you make a change, be sure to click on Reload button in Extension Builder.
  7. Push your changes.
  8. Send us pull request!

In Opera

  1. Go to about://extensions.
  2. Press Developer Mode then press Load Unpacked Extension... .
  3. Find your working directory & select it.
  4. To test after you make a change, be sure to click on Reload button on about://extensions page.
  5. Push your changes.
  6. Send us pull request!

If we see that you are a dedicated contributor, we may provide you with contributor permissions. The people to contact for this project are @kpeckett and @tomasko126

About

CatBlock - An ad-blocking extension for Chrome, Opera, Safari, Firefox and Edge!

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 86.5%
  • HTML 9.1%
  • CSS 4.4%