|Warning: You take full responsibility for any action you perform using Huggle. You must understand Wikipedia policies and use this tool within these policies, or risk losing access to the tool or even being blocked from editing.|
Huggle version 3.0.0
|Developer(s)||Adam Shorland, Petr Bena, et al.|
|Written in||C++, Python|
|Operating system||Windows 2000 and later, Linux, macOS|
|Available in||35 languages|
Huggle is a diff browser intended for dealing with vandalism and other unconstructive edits on Wikimedia projects, written in C++ using the Qt framework. It was originally developed in .NET Framework by Gurch, who is no longer active on this project. Anyone can download Huggle, but rollback permission is required to use it on the English Wikipedia.
The principal idea of Huggle as an anti-vandalism tool is to make it possible for Wikipedia to stay as open and free as possible (allowing everyone to edit without any restrictions), while keeping it clean of any vandalism.
While Huggle can load and review edits made to Wikipedia in real time, it also helps users identify unconstructive edits and allows them to be reverted quickly. Various mechanisms are used to draw conclusions as to whether an edit is constructive or not. It uses a semi-distributed model where edits are retrieved using a "provider" (this can be anything that is capable of distributing a stream of edit information, such as the Wikipedia API or IRC recent changes feed), pre-parsed and analyzed. This information is then shared with other anti-vandalism tools, such as ClueBot NG. Huggle also uses a number of self-learning mechanisms, including a global white-list (users that are considered trusted) and user-badness scores that are stored locally on the client's computer.
Before using Huggle, it is recommended that users read the privacy statement, which contains information about how Huggle stores and manages data. Support and development chat is available on #huggle connect
Where to start
Users should read Huggle's manual before using Huggle in order to familiarize themselves with Huggle's controls and features.
Huggle is not intended for new Wikipedia users. All Wikipedians intending to use Huggle must be familiar with how to deal with vandalism before they start. If you wish to get experience in handling vandalism, the counter-vandalism academy is a good place to start. Additionally, having rollback permissions on the English Wikipedia is mandatory. Huggle does not require rollback permissions on other wikis and can be tested on test
Once all the requirements are met, Huggle can be downloaded from meta:Huggle/Download.
The current stable download is version 3.2.0.
Huggle may be used on any wiki that is running MediaWiki. See meta:Project:Huggle/List for a list of Wikimedia projects where Huggle can be used. If you wish to have it enabled on any other project, contact us on the feedback page or on the Wikimedia Phabricator.
Note: Huggle 3 is officially out!! We would like to announce that the development of Huggle 2x (known as legacy huggle) has been stopped for inclusion of new features; support for the tool has been vastly reduced. We occasionally solve bugs which make it unusable. We strongly recommend that Huggle 2 users make the switch to Huggle 3.
Huggle 3 is written in C++ and Python, and includes many new features such as compatibility with Linux and OS X, a scripting interface, better performance and more.
Huggle 2 users
If you used Huggle 2 and would like to switch to Huggle 3, keep in mind that there are some differences in the basic Huggle configuration and layout. Huggle 3 saves your configuration data on another page (huggle3.css) and will not overwrite the legacy Huggle's configuration page in your userspace. This means you can safely change your Huggle 3 preferences and it will not affect your Huggle 2 settings. If you don't like the new interface, you can go into your Huggle 3 preferences and click the Change all Huggle settings to behave more like Huggle 2 button. The layout will still be different, but it can be easily modified to suit your tastes. The widgets can be removed or changed, so you can make it look a bit more like the old Huggle if you prefer.
Nightly builds - you can download pre-release versions of Huggle for Windows and Ubuntu at https://huggle.wmflabs.org/builds/. These versions are built every night, but lack an automatic updater; thus, you will need to update them yourself. The Windows version is just a ZIP file; simply extract the files.
If you would like to become a Huggle beta tester, please add yourself to the list of project members (as a beta tester) and you will be automatically notified by email / message every time a new beta version is released. Don't forget to send all feedback related to beta versions to the issue tracker.
You can help
If you like Huggle and want to help with its development, you can contribute and assist with its development even if you lack any computer programming knowledge. You can:
- Improve the project pages about Huggle
- Write and improve the documentation (https://www.mediawiki.org/wiki/Manual:Huggle)
- Help other users on IRC #huggle connect
- Suggest new features
- Translate Huggle to more languages (Huggle translations are available on meta wiki on this page)
- Star Huggle on github (https://github.com/huggle/huggle3-qt-lx). This will make it more popular and might bring more developers to the project.
- Donate money
If you are interested in this project, you are welcome to join us. Just add your name to the table in WP:Huggle/Members and include how you will participate (example: translation/helping on feedback page or irc). If you want to become a developer, fork our repository on github, make your changes, and submit a pull request. Every little bit of help is greatly appreciated!
Enabling Huggle for another project
If you want to get Huggle enabled for another project, please do the following:
- Fill in a ticket here.
- Optional: Ask a sysop of that wiki who is fluent with English for assistance.
- Optional: Translate Huggle to your language.
- "list of languages". huggle.wmflabs.org.