How can I help when I have a performance issue?
If you want to help us to analyse a performance issue, you can do that from a console:
export SKGTRACEPERFO=1 skrooge
Play your scenario except the action causing the issue.
Click on Tools/Restart Profiling.
Play the last action causing the issue.
Click on Tools/Open Profiling.
A page has been opened.
Copy and send us the content by email.
How can I initialize tracker value?
Sometimes, you would like to track the refund of a payment done before you started to use Skrooge.
How to do that because it's not possible to set an initial amount on a tracker?
You can create a split operation with:
- amount=0 to avoid impact on reports
- a split with the expected amount associated to the tracker
- the other split with the opposite amount not associated to a tracker
How to have Skrooge in my language ?
First, check if Skrooge is well translated for your language: https://l10n.kde.org/stats/gui/trunk-kf5/po/skrooge.po/
Second, don't forget to install packages for your language. Example for french (fr):
How to add a source of download for units?
Since Skrooge 1.1.0, you can add your own source of download for units.
For that, you just have to add a file in
This file must be a text file (extension
.txt) like this:
#The URL of the source. %1 will be replaced by the internet code of the unit url=https://stooq.com/q/l/?s=%1&f=sd2t2ohlcv&h&e=csv #The mode (HTML or CSV). In HTML mode, only one value will be extracted from downloaded page. In CSV mode, a value per line will be extracted. mode=CSV #The regular expression for the price (see https://doc.qt.io/qt-6.2/qregexp.html) price=%1,\[^,\]\*,\[^,\]\*,\[^,\]\*,\[^,\]\*,\[^,\]\*,(\[^,\]\*),.\* #The regular expression for the date (see https://doc.qt.io/qt-6.2/qregexp.html) date=%1,(\[^,\]\*),.\* #The format of the date (see https://doc.qt.io/qt-6.2/qdate.html#fromString-2) dateformat = yyyy-MM-dd
This is not so easy to define regular expression, so you can active Skrooge's traces by doing
Defaults sources are installed in
How to reduce the size of my document?
The size of your document can be very important. If you delete same old transactions, the size will increase.
This is normal because Skrooge keeps the history of all modifications for the undo/redo mechanism.
So, if you want to reduce the size of your document, you just have to clear the history.
How to set default currency and date format?
Default currency and date format are retrieve from KDE's system settings. Some distributions do not ship it with base KDE packages, that should have been installed along Skrooge. In such case you should install it through your distribution's package manager.
You can then start it in a console
And select your preferred settings in the locale section.
How can I add bank's icons for my country?
The banks are defined in a file named
list_bank.txt containing one line per icon.
Lines in this file are in fact the name of each bank logo file, and the file should be named like this :
xxxxx_xxx_xxis the name of the bank. Underscores (
_) will be replaced by space when displayed in Skrooge.
yyyyyis the code of the bank. Usually, this code appears at the beginning of the account number.
- The size of the file must be 100x100 maximum.
Note 1: there is double underscore (
__) between the bank name and the bank code.
Note 2: the bank code is optional. If this is not applicable in your country, do not put anything, and do not put the double underscore.
As to logo files, it's being debated currently whether we should ship them within Skrooge, because of copyright issues. If you want to add them along with the file, please do so, but be aware that at some point in the future they might be removed...
How to translate Skrooge for my language ?
Skrooge being a KDE application, all translations are held in the KDE repository. The following page shows translation progresses for Skrooge:
In order to contribute to KDE translations, I'd recommend you have a look at this page: https://l10n.kde.org/
It's usually very easy to join a team.
They should give you proper indication on getting involved.
How to avoid Skrooge freeze ?
Sometimes, Skrooge freezes.
Most of the time it's due to settings.
So, you just have to try:
If this doesn't work, then try:
rm ~/.kde/share/apps/skrooge/skrooge_print.rc rm ~/.kde/share/apps/skrooge/skrooge_file.rc rm ~/.kde/share/apps/skrooge/skrooge_importexport.rc rm ~/.kde/share/apps/skrooge/skrooge_undoredo.rc rm ~/.kde/share/apps/skrooge/skrooge_operation.rc rm ~/.kde/share/apps/skrooge/skrooge_scheduled.rc rm ~/.kde/share/config/skrooge-appletsrc rm ~/.kde/share/config/skrooge_filerc rm ~/.kde/share/config/skrooge_operationrc rm ~/.kde/share/config/skrooge_importexportrc rm ~/.kde/share/config/skrooge_searchrc rm ~/.kde/share/config/skrooge_scheduledrc rm ~/.kde/share/config/skrooge_unitrc rm ~/.kde/share/config/skrooge_undoredorc
How do you manage code quality ?
How can I help debug?
You can help us by doing:
- Ask help on forum if you are not sure that it's a bug.
- Check in the bug tracker that our problem has not been reported before.
- Open a console.
- Execute following lines in the console.
export SKGTRACE=255 skrooge > traces.txt
- Replay your scenario.
- Open a new incident with:
- A detailed description.
- The result.
- The expected result.
- Attach the file named
traces.txtto the opened incident.
This document could help you to avoid mistakes.