Awesome Open Source
Awesome Open Source


Huggle 3 is an anti-vandalism tool for use on Wikipedia and other MediaWiki sites, written in C++ (QT framework). It is officially supported for Windows (2000 or newer), MacOS and Linux (debian/ubuntu).

Build Status Build status


IMPORTANT: Since 3.1.19 you must download submodules in folder libs using git:

git submodule init
git submodule update

If you did not download this repository using git, there should be a guide on where you can download the libraries from in the respective folders.

Libraries and tools you need to have to build:

  • C++11 compiler
  • CMake 2.8.9 or higher is required
  • QT5 sdk (recommended 5.7 or newer, with WebEngine and QJSEngine)

[NEW] It is now possible to use a VirtualBox VM as a portable development environment for Huggle. » Wiki page


» Wiki page


  • checkout this repository
  • enter the repository folder, then execute:
# The --extension option works only if you cloned this repository using git
# if you downloaded a gzip file, you can only use it after downloading them
# by hand into 'huggle/extension_list' folder
./configure --extension --web-engine
cd release
sudo make install
sudo ldconfig


» Wiki page

WebKit vs Chromium

Qt5.0 - Qt5.4 supports WebKit, which is a default backend for Huggle. Newer Qt support only Chromium backend (code named WebEngine)

If you want to build Huggle with Qt newer than 5.4 you will have to enable it like this:

./configure --web-engine

Or alternatively if you are starting cmake by hand, just pass it -DWEB_ENGINE=true parameter


For developers: source code documentation and the repo's Wiki are available.

For users: on metawiki and mediawiki.

Getting help

We have an IRC-channel irc:// so if you need any kind of help please go there.


Everyone is allowed to send their pull requests to this repository, and all regular contributors get a developer access to directly push if they need it. If you want to join the Huggle developer team, please see and insert yourself.

This repository is running CI using travis, if you want to change anything which doesn't require sanity check, like documentation or comments, please append [ci skip] to your message.

Reporting bugs

Please use Wikimedia's tracking platform, phabricator.

Support us

Your donations are welcome and help us focus on the development even more:

PayPal (preferred), or :

LTC:  LfMDMWKqhiT45q4h1uduiDfjUZfiwGiCes
BTC:  18YTu4mPqzaaRv5QarvMGRuPiH3ntk5ir2


Huggle 3 is licensed under GPL v3+, some contents of this repository may be licensed under different license. See the local README or file headers for more information.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
c-plus-plus (18,781
cmake (409
qt (363
wikipedia (74
mediawiki (29