Contributing code to Adblock Plus

Finding something to work on

• If you know JavaScript, you can work on the Adblock Plus core code, Adblock Plus for Firefox, Adblock Plus for Chrome, Opera and Safari or our websites.
• If you know Python, you can work on our build and release tools or our backend.
• If you know C++, you can work on libadblockplus or Adblock Plus for Internet Explorer.
• If you know Java, you can work on Adblock Browser for Android or Adblock Plus for Samsung Browser.
• If you know Objective-C, you can work on Adblock Plus for iOS
• If you know Puppet, you can work on our infrastructure.

Note that most of our projects are also on GitHub, if you prefer that.

We're keeping track of all the things we want to fix and improve on our issue tracker.

If you already know what you want to do, feel free to create an issue there. If not, have a look at the issues marked as goodfirstbug. If you don't find anything interesting, feel free to pick any unassigned issue, ideally P4.

In any case, please write a comment saying that you'd like to work on something before you get started. That way we can assign the issue to you, to ensure no one else starts to work on the same thing.

Getting in touch

Feel free to join our IRC channel if you need help or want to chat: #adblockplus on irc.mozilla.org. There's also a web-based client.

Submitting a patch

Once you've made and tested your changes, first make sure they're in line with our coding style.

Now you can send us your patch, ideally by uploading it to codereview.adblockplus.org. But you can also attach a patch file to the issue, or create a pull request on GitHub.

Finally, before we can accept your patch, you need to sign the contributor agreement. Please print it out, sign it, scan that or take a picture of it and send it to one of your reviewers.

Becoming a committer

If you intend to contribute to a project on a regular basis, you might want to become a committer.