Chapter 2. Using Skrooge

User Interface

The Skrooge window is composed of a main area, surrounded by docks, and a status bar. Docks can be closed and reopened, and positioned left or right of the main area.

The main area

This is where Skrooge will display the information you're interested in. It can contain many tabs, each one with the view you assigned to it.

Docks

Docks can be found in many KDE applications. They are a subpart of an application window, and can be relocated, stacked, closed, or even detached from the main window.

Some examples of docks layout:

Skrooge docks are:

Status Bar

The status bar is a small section at the bottom of the Skrooge window, displaying various information as you work. It includes a progress bar and a cancel button, in case you want to interrupt a long task, such as importing a large file.


The Skrooge progress bar

Page Chooser

The context chooser is a dock where you can select the view to be displayed in the current tab or in a new tab. To open in a new tab, hold the Ctrl key while clicking on the selected view.


The context chooser

Each context will be described in a specific chapter in this handbook.

Multiple Tabs


Skrooge showing several tabs

Skrooge can display several tabs. You can add as many tabs as you want, each one containing the information you need. The above screenshot shows 4 tabs (accounts, operations, and two graphs).

Edition Panels

In most Skrooge tabs, the way to edit items is to use the edition panel, located at the bottom of the page. In order to preserve maximum space for visualizing information, especially on small screens, edition panels can be hidden or displayed using buttons.


Buttons for showing or hiding Operations edition panels.

When more than one edition mode is available, several buttons allow choosing amongst them. In the above screenshot, there are four buttons allowing to choose the edition mode for Operations, "Standard", "Split", "Transfer" and "Shares".

Tables

In Skrooge, all tables are customizable. Bring up the contextual menu (usually by right-clicking) on the column header, and you will see a menu appear:


Customizing a table
Columns

Customize the columns appearance.

View Appearance

Use a predefined set of columns. The "default" column usually shows all columns. Other predefined sets may exist on a per table basis.

Resize to Content

Resize all columns to fit to the content.

Auto Resize

When activated, you will not be able to manually resize columns, Skrooge will do it automatically based on the columns content.

List of displayed columns

Shows the list of all columns that can be displayed for this table. The ones currently displayed are ticked. Untick to hide a column, tick to show.

Smooth Scrolling

When enabled, allows you to scroll in the table by left clicking and moving the mouse. Quickly move the mouse in one direction, as if you were "throwing" it, and the table will scroll faster with a dampening effect. Mostly useful on touch devices.

Show Grid

Draw grid lines in the table.

Alternate row colors

Alternate the colors used for each row. The colors used are based on the chosen KDE color scheme.

Export

Export the table as a stand-alone file. Supported formats are pdf, csv or txt.

You may also click on a header to choose the sorting column, or reorder columns by dragging them left or right.

Save Customized Content

As explained in the previous chapter, tables can be totally customized to your liking. But you probably don't want to loose all the customization work you made upon closing a tab. There are two ways to save this work.

Save page state

This option allows you saving the current tab state as the default state that will always be called when opening this context. For example, you may want your Dashboard to contain 4 widgets, organized to your liking. What's even more important is that you always want the Dashboard to look the same, you don't want to repeat the customization work every time you open it.

To do this, you simply need to do customization work once, then to save the tab state as the Default State for the context being displayed. Setting the default state is done either by right clicking on the tab and selecting Save page state.


Contextual menu on tabs

A faster way is to click on the disk icon that appears on the left of the tab title whenever you modified the default state in a tab.

Using Bookmarks

Imagine you need to customize the operations view on a per account basis: each account would be displayed in its own tab, maybe with different columns in each table. The forementioned method does not work, since it applies on all tabs with the same type.

The solution here is to save each individual tab as a Bookmark. Much like in a web browser, bookmarks can be organized in a hierarchy of bookmark folders, that you can visualize in the Bookmark Browser:


The bookmarks browser

To create a bookmark, select a context from the context chooser you want to bookmark, and customize its content to your liking. Once you're done with that, in the Bookmarks dock, bring up the context menu, and select Bookmark current page.

Each bookmark or bookmark folder can be "autostarted", i.e. it will be automatically opened when starting Skrooge. This way, you can fully customize the default Skrooge layout.

Undo / Redo

Skrooge manages undo/redo in a rather classic fashion, except that you can undo or redo any action, even if it was made several days ago. As per default settings, the history is not cleared upon closing Skrooge (you can change this behaviour in the settings), which means you could undo virtually everything up to the document creation.

In order to limit the impact on filesize, Skrooge is configured by default to keep an history of 50 entries. You can change this value in the settings.

Skrooge has a dock that lists all undoable actions.


The history browser

The history browser shows three columns:

  • an icon showing the state of the action. A yellow counter clockwise arrow means the action is undoable. A green clockwise icon means the action is redoable.

  • the description of the action

  • the date when the action was made

  • a disk icon means this action corresponds to a saved state, i.e. the document was saved right after this action.

To undo an undoable operation, or redo a redoable operation, double click on it.

Mass Update

In Skrooge, it is possible to massively update a selection of items. Though mostly useful for operations, it can also be used on accounts, units, scheduled operations...

The way to do this is quite straightforward : select items to be updated, set the attribute value(s) that should be applied on all items, and click on Apply. For all attributes where you didn't set a value, it will be left untouched on items.


Set mode as "Credit Card" and payee as "ACME" on selected operations.



Updated operations.


Note

It is intentionally impossible to set date or quantity with a mass update

Property Editor

One of Skrooge rather uncommon features is the ability to add custom properties to any object. For example, you may want to add the name and phone number of a bank employee to an account, because he / she is your contact. Or maybe attach a file to an operation, like an invoice scan.

This can be achieved using the property editor, which is a dock of its own.


The property editor, with an attachment

When this dock is visible, it will display the custom properties of the selected object, whether it is an account, an operation, category, unit...

Search as you type

In all Skrooge views, you will find a "filter" field allowing you to search as you type in the view:

  • In an operation view, it will filter the operations containing the text entered, whatever the column (date, payee, category, comment...)

  • In an accounts view, it will filter the accounts containing the text entered, whatever the column (bank, account name, number...)

  • In a report view, it will redraw the graph based on this filter

  • In a... well, you get the idea, right?