Wikipedia:Huggle/Huggle3 Beta

From Wikipedia, the free encyclopedia
Jump to: navigation, search

This page documents how to set up and install Huggle 3 in case you want to perform beta testing.

Please keep in mind that as Huggle 3 is unfinished, it may contain huge number of vulnerabilities and bugs, so be very careful while testing it on production wikis.


What is it?[edit]

Huggle 3 is complete rewrite of Huggle 2x. Why? Because Huggle 2 was written in VB and that produced binaries which can run only on Windows. Some people managed to run them on Linux as well, but the performance was always bad and not everything worked. Huggle 3 is cross-platform and can be natively compiled on every popular platform, including Linux, OSX and Windows.

Because it is rewritten, it probably still has fewer features than old Huggle at the moment (but may have some new ones too). This is one of many reasons why, unless you want to do beta testing, you should use Huggle 2.

Where has the drop down to select different revert reason gone?[edit]

Huggle uses Qt which renders this kind of button in quite unfortunate way, you need to hold the revert button for a while for the menu to appear, no worries, we didn't remove it.

I see no english wikipedia in project list[edit]

You need to hit Reload button in login form.


Speed and memory usage[edit]

Huggle is now written in C++, running natively, with no need for any interpreter. Therefore it runs faster and also needs far less operating memory. It doesn't use IE but WebKit in order to display HTML, which is much faster and contains no known leaks.


Edits are first downloaded and then they are put into the queue, so that moving to the next edit in the queue is always a matter of (typically) less than a second (depending on your hardware). On the other hand, it takes slightly longer for edit to be placed into the queue.


Huggle 3 contains a sophisticated reporting system that can be used on any wiki, not just For each report, you can pick a list of edits that are vandalism, and include them inside of your message to administrators. Unlike Huggle 2 the automatic reporting is not available to prevent false reports.

Good edit[edit]

Every edit can be flagged as a good edit, which is just the opposite of reverting an edit. The user gets a negative score (users with very low score get whitelisted), if they don't have a talk page, it is created with a welcome message and other users of Huggle are notified about this user being a good editor. When you flag an edit as a good edit, it is not reverted, and you are automatically taken to the next edit. The keyboard shortcut is G.


All edits are put into the queue after they are post processed, so that the content of diff is pre-parsed and checked against a list of score words and other patterns. The edits are scored and then sorted in queue by score, instead of type.

HAN system[edit]

Huggle Anti-vandalism Network (HAN) is a new system that allows all users of Huggle (and compatible tools or bots) to cooperate when dealing with vandals. Users share their information about suspicious edits, reverts, deletes etc so that they minimize conflicts and maximize the potential as a team.


There are far less features in latest Huggle, all extra functionalities, especially stuff that works only on certain wikis, will be supported through optional extensions.


Huggle can be started from any device, including flash drives or network drives and by using the --chroot option you can even make it store its configuration there, so that it can be made completely portable, with no need for any installation and used on any operating system. You can even mix multiple binaries, built for different OS and have them share same configuration files. That will let you use same huggle with same config on any platform.


Huggle 3 supports SSL through Open ssl libraries, which makes it safe to use even using unsecured wireless or mobile internet.

How to make Huggle 3 behave more like the old Huggle[edit]

Open preferences and...

  • In tab Reverting, uncheck "Ask if you revert edit in user space"
  • In tab Feed, check "Remove old edits if newer edit to same page is parsed"
  • In tab Performance, check "Display last revision of page in case currently loaded edit is not a last revision"
  • In tab Performance, in frame On change of page, revert etc, check "Retrieve your own edit"

Known issues[edit]

  • Personal config doesn't really work so far, if you start using Huggle 3 your personal config from Huggle 2 will be destroyed
    • the config will be now saved under huggle3.css in your userspace
  • Can not (ctrl+s)delete on zhwiki(4 ERROR: no diff available for 美国麻将 unable to rescore)
  • Page protection requests, page deletion (Yes check.svg Done
  • Tagging interfaces are not implemented
  • Software rollback doesn't work yet, you can't use Huggle if you don't have rollback rights Yes check.svg Done
  • Localization for many items is missing
  • Preferences contains only very few items
  • There is no way to change the queue filters
  • Only 1 queue is available (this will probably be the way the intial version will work, since there is no real need for multiple queues)
  • Some pages don't have cute diff (ERROR: no diff available for PAGE unable to rescore) this have several reasons, most of them are fixable except for that one where slave cache of WMF cluster doesn't contain the data for diff yet (api's are using different slave servers for some stuff). Will be fixed hopefully soon.

How to install[edit]

Prebuilt packages[edit]


Installer: Version beta #1153


  • Use ppa ppa:huggle-devs/ppa
    sudo add-apt-repository ppa:huggle-devs/ppa
    sudo apt-get update
    sudo apt-get install huggle


Use ppa ppa:benapetr/huggle

  • Create /etc/apt/sources.list.d/huggle.list containing
    deb precise main
    deb-src precise main
  • Execute (some warnings regarding trust and keys may be displayed)
    sudo apt-key adv --keyserver --recv-keys 93FB62D1
    sudo apt-get update
    sudo apt-get install huggle

Source code[edit]


See this video tutorial on how to install huggle

  • Download and install Qt SDK from
  • Download the source code from GitHub:
    git clone
  • Open the source code in Qt Creator
  • Create empty version.txt in folder Huggle
  • Build it


  • Download Qt SDK and python-dev
    • For Debian / Ubuntu Qt4
      sudo apt-get install qt4-dev-tools qt4-qmake libqt4-webkit python-dev make g++ gcc
    • For Debian / Ubuntu Qt5
      sudo apt-get install qt5-dev-tools qt5-qmake python-dev make g++ gcc
  • Get source code
    git clone
    cd huggle3-qt-lx/huggle
  • Build it
  • Start Huggle

Mac OS[edit]

  • Install homebrew
  • Install Qt:
    brew install qt
    (and possibly some other things?)
  • Get source code
    git clone
    cd huggle3-qt-lx/huggle
  • Build it
    ./configure --no-breakpad
  • Start Huggle

Why you shouldn't use Huggle 3 if you are on Windows[edit]

  • Huggle 3 may contain less features than older versions
  • Huggle 3 may be buggy and something may not work

Why you should use Huggle 3 if you are not on Windows[edit]

  • It works.
  • It really does.
  • Seriously. Even without Wine, or Mono.