Manual:Huggle/Configuration

Configuration settings for Huggle are stored in one of four locations depending on their scope:

All configuration files consist of a series of lines of the form option:value, where option is one of the values listed below. Option names are not case-sensitive. Blank lines, lines starting with # and unrecognized options are ignored. Values can break across lines provided these extra lines begin with one or more spaces.

User and local configuration settings may be changed through the Options window within Huggle.

User configuration
Settings on user configuration subpages apply only to that user, and only on that project.


 * enable – true/false. Huggle will not work unless this is present and set to true.
 * anonymous - string. Whether to show the contributions of anonymous users. Available values: "yes", "no", "only". Default: 'yes'.
 * auto-advance – true/false. After reverting a revision, automatically advance to the next diff. Default: false.
 * auto-whitelist - true/false. Whether to automatically whitelist users. Default: true.
 * confirm-multiple – true/false. Ask for confirmation if reverting multiple edits by the same user. (Does not ask for confirmation when explicitly reverting to an older revision in the page history, as it is obvious in such cases that multiple edits are to be reverted). Default: false.
 * confirm-same</tt> - true/false. Ask for confirmation if the revision being reverted to was made by the same user that is being reverted. Default: true.
 * extend-reports</tt> - true/false. Whether to extend vandalism reports in the event of further vandalism. Default: true.
 * irc-port</tt> – integer. Port to use when connecting to IRC. Use any integer from 6664–6669, inclusive. Default: 6667.
 * minor</tt> – comma-separated list. Types of edit to mark as minor. Available values: "reverts", "warnings", "tags", "reports", "notifications" and "other". Use "none" for none. Default: 'reverts'. Note that reverts will always be marked as minor edits.
 * namespaces</tt> – comma-separated list. Namespaces to check for vandalism. Use "article" for main namespace, "all" for all namespaces, "alltalk" for all talk namespaces. Prefix by "-" to exclude. Default: 'all'.
 * new-pages</tt> - true/false. Whether to include new pages in the queue. Default: false.
 * preload</tt> – integer. How many diffs to preload in advance. Preloading reduces wait time for diff loads but slows other requests slightly. Set to 0 to disable preloading. Do not set to more than about 5. Default: 2. Disabling this is recommended if you have a slow connection.
 * report</tt> - string. What to do when asked to warn a user with a final warning. Use "none" to do nothing, "prompt" to prompt for a user report, and "auto" to issue the report automatically. Default: 'auto'.
 * revert-summaries</tt> - comma-separated list. Summaries available in the revert drop-down menu. Use \,</tt> to include a literal comma.
 * rollback</tt> – true/false. Use rollback if available. Default: true.
 * show-new-edits</tt> – true/false. If the page currently being viewed is edited, jump to a diff of that edit. Default: true.
 * show-queue</tt> - true/false. Whether to show the revision queue. Default: true.
 * templates</tt> - comma-separated list. Templates to show in the templates drop-down menu. Each item of the list is a pair of values separated by a semicolon; the first is the text displayed in the menu, and the second is the name of the template to be used. Use \,</tt> to include a literal comma, \;</tt> to include a literal semicolon.
 * <tt>tray-icon</tt> - true/false. Display an icon in the notification area, allows application to be minimized to the tray. Default: false.
 * <tt>update-whitelist</tt> – true/false. Whether to update the shared whitelist on exit. Default: true.
 * <tt>watchlist</tt> – comma-separated list. Types of edit which should add the page to your watchlist. Available values: "reverts", "warnings", "tags", "reports", "notifications" and "other". Use "none" for none. Default: 'none'.

The following options have effect only when used with an administrator account:
 * Administrator options
 * <tt>admin</tt> - true/false. Use administrator functions (block/delete) if available. Default: true.
 * <tt>block-prompt</tt> - true/false. Whether to show the block form if asked to warn a user with a final warning. Default: true.
 * <tt>block-reason</tt> – string. Default block reason on block form. Default: ' Vandalism '.
 * <tt>blocktime</tt> – string. Default block expiry time when blocking logged-in users. Default: 'indefinite'.
 * <tt>blocktime-anon</tt> – string. Default block expiry time when blocking anonymous users. Default: '24 hours'.

Project configuration
Settings on project configuration pages apply to all users of a single project. The user configuration settings listed in the section above also work on project configuration pages, and serve as defaults for those values, but are overridden by the user's configuration settings.


 * Access control


 * <tt>approval</tt>: true/false. If true, user list acts as an approval list, and only users listed there may use Huggle.
 * <tt>enable-all</tt>: true/false. If false, Huggle will not work for any user. For use only in exceptional circumstances.
 * <tt>require-admin</tt>: true/false. If true, Huggle will only work if the user is an administrator.
 * <tt>require-autoconfirmed</tt>: boolean. If true, Huggle will work only if the user is autoconfirmed.
 * <tt>require-config</tt>: true/false. If true, all users must have a configuration page with <tt>enable</tt> set to 'true'. This allows administrators to prevent use of Huggle by a user account by blanking and protecting its configuration page.
 * <tt>require-edits</tt>: integer. Number of edits an account must have made before it is able to use Huggle. (Accounts must be autoconfirmed, regardless of this setting.)
 * <tt>require-rollback</tt>: true/false. If true, Huggle will only work if the user has rollback.
 * <tt>require-time</tt>: integer. Number of days for which a user account must have been registered before it is able to use Huggle. (Accounts must be autoconfirmed, regardless of this setting.)
 * <tt>min-version</tt>: version number. Versions older than this will not work.


 * Other


 * <tt>aiv</tt>: string. Page to which vandalism reports are made.
 * <tt>aivbot</tt>: string. Page to which vandalism reports are made by bot accounts; Huggle checks this before making a report itself.
 * <tt>ignore</tt>: comma-separated list. Pages to which all edits will be ignored regardless of user. Talk pages of these pages will also be ignored. Use <tt>\,</tt> to include a literal comma.
 * <tt>uaa</tt>: string. Page to which username reports are made.
 * <tt>uaabot</tt>: string. Page to which username reports are made by bot accounts; Huggle checks this before making a report itself.
 * <tt>userlist</tt>: string. Location of Huggle's user list.
 * <tt>whitelist</tt>: string. Location of Huggle's user whitelist.
 * <tt>whitelist-edit-count</tt>: integer. Number of edits a user must have before they are added to the user whitelist.

Local configuration
Settings stored locally apply across all projects and apply only to users of that computer. They will be retained if you log in with a different account, and lost if moving between computers, but for the most part can be thought of as applying to a single user account.

The local configuration file is stored in \huggle\config.txt in the user's Application Data folder. The file is updated automatically when Huggle exits.


 * <tt>irc</tt>: boolean. Whether to use the IRC recent changes feed.
 * <tt>log-file</tt>: string. File path to which Huggle activity will be written.
 * <tt>project</tt>: string. Last project used.
 * <tt>proxy-enabled, proxy-port, proxy-server, proxy-userdomain, proxy-username</tt>: proxy settings.
 * <tt>username</tt>: string. Last username used.
 * <tt>window-left, window-top, window-width, window-height</tt>: integers. Location and size of Huggle's main window.
 * <tt>window-maximize</tt>: boolean. Whether the main window is maximized.
 * <tt>shortcuts</tt>: comma-separated list. Keyboard shortcuts.
 * <tt>revert-summaries</tt>: comma-separated list. Summaries that have been entered into the "Revert with summary" dialog.

Global configuration
Settings on the global configuration page at Huggle/Config apply to all users and all projects.


 * <tt>enable-all</tt>: boolean. If false, Huggle will not work on any project.
 * <tt>config</tt>: string. Location of project configuration page on each project.
 * <tt>documentation</tt>: string. URL for documentation page.
 * <tt>feedback</tt>: string. URL for feedback page.
 * <tt>irc-server</tt>: string. Location of IRC recent changes server.
 * <tt>projects</tt>: dictionary. Projects on which Huggle can be used. Each item is the project name, followed by its URL.
 * <tt>sensitive-addresses</tt>: dictionary. IP ranges that are considered "sensitive". Each item is a regex matching the IP range, followed by a description.
 * <tt>version</tt>: version number. The current version of Huggle. Users of older versions will be notified of this, but the older versions will continue to work.
 * <tt>user-agent</tt>: string. User agent string that will be used by Huggle. $1 is replaced by the version number.
 * <tt>user-config</tt>: string. Location of user configuration pages on each project.