Hiding the Balance Window of the User Client Tool

The PaperCut user client tool will, by default, pop up a dialog with the user's balance when it starts.

The exception to this case is when the user cannot charge to their personal account. For example, if the user's Account Selection setting has been set to Show the standard account selection popup, and the option Allow user to charge to their personal account has been disabled. In this case the user's personal balance has no relevance, so the user client tool does not display the balance window.

Hiding the balance window on startup

The user client tool can be configured to "start minimized". That is, the balance window will not be displayed when the client tool starts, but the user can still bring it up by clicking on the icon in the system tray/dock.

To configure a client tool to start minimized, use the minimized option. See the user manual section User Client Options (PaperCut NG / PaperCut ChargeBack) for more details.

Some examples of how to use the option include:

  • If workstations run the client tool from a network share, set the minimized option to Y in the config file on the share to affect all clients.
  • If client tools are started via a login script, pass the --minimized command line option to affect all clients.
  • To affect a single user client when installed locally, enable the minimized=Y option in the local config file.

Hiding the balance window permanently

To ensure that the balance window will never be displayed for any user, perform the following:

  1. Log into the PaperCut administration interface.
  2. Navigate to Options -> Config editor (advanced).
  3. Search for the key client.config.show-balance.
  4. Change the Value to N.
  5. Press Update.

Next time a user client tool is started, the balance window will not be shown (regardless of the minimized option described above).

Note for Mac users

In order to support older Mac OS X versions (i.e. 10.3) is is not possible for PaperCut to completely hide the balance window. Once support for 10.3 is dropped, we will provide a way to hide the balance window on Macs.


Categories: User Client Tool


Keywords: disable balance display, don't show balance, remove balance window, balance window not showing, balance dialog

Page last modified on April 06, 2009, at 08:50 PM