Difference between revisions of "Projects/KMyMoney"

Jump to: navigation, search
(Moved line out of Localization and back into Installation)
m (Added new splash screen)
 
(107 intermediate revisions by 11 users not shown)
Line 1: Line 1:
This page is dedicated to discuss issues related to the port to KDE4. The effort is ongoing and it is not considered stable. It is only suitable for early adopters. If you are looking for the stable version, go to the official page of [http://kmymoney2.sourceforge.net KMyMoney] [[Image:Kmm splash 3 95.png]]  
+
This page is dedicated to technical aspects of KMyMoney for KDE Platform 4. If you are looking for other info, or the source tarball, go to the official page of [http://kmymoney.org KMyMoney].
 +
 
 +
[[Image:kmm_5_splash.png]]  
  
 
== Available versions  ==
 
== Available versions  ==
 +
=== Latest release ===
 +
[http://download.kde.org/stable/kmymoney/5.0.0/src/kmymoney-5.0.0.tar.xz.mirrorlist KMyMoney 5.0.0] has been released on 2nd of February 2018.
 +
Alternatively, you can get the source from the [https://projects.kde.org/projects/extragear/office/kmymoney KDE Git]. (see link below)
  
KMyMoney 3.95 has been released on Dec 28th 2009 [https://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/3.95.0/kmymoney-3.95.0.tar.bz2/download tarball].  
+
=== Obsolete releases ===
 +
[http://download.kde.org/stable/kmymoney/4.8.0/src/kmymoney-4.8.0.tar.xz.mirrorlist KMyMoney 4.8.0] has been released on 14th of June 2016.
  
Alternatively, you can get the source from the KDE SVN. (see link below)
+
[http://download.kde.org/stable/kmymoney/4.7.2/src/kmymoney-4.7.2.tar.xz.mirrorlist KMyMoney 4.7.2] has been released on 14st of April 2015.
  
== Installation  ==
+
[http://download.kde.org/stable/kmymoney/4.7.1/src/kmymoney-4.7.1.tar.xz.mirrorlist KMyMoney 4.7.1] has been released on 1st of November 2014.
  
=== Requirements  ===
+
[http://download.kde.org/stable/kmymoney/4.7.0/src/kmymoney-4.7.0.tar.xz.mirrorlist KMyMoney 4.7.0] has been released on 1st of October 2014.
  
KMyMoney depends on KDE SC 4.3. Specifically on kdelibs and kde PIM libs. Additionally, you may want to install other libraries that will provide additional functionality:
+
[http://download.kde.org/stable/kmymoney/4.6.6/src/kmymoney-4.6.6.tar.xz.mirrorlist KMyMoney 4.6.6] has been released
 +
on 24th of June 2014.
  
*libofx
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.6.4/kmymoney-4.6.4.tar.bz2/download KMyMoney 4.6.4] has been released on 6th of October 2013.
*Aqbanking v4 for Qt4 -- IMPORTANT: It is not compatible with AqBanking for Qt3
+
*quote::finance
+
  
Please note that KMyMoney cannot be compiled using KDE SC 4.4 (trunk) right now due to an undefined method in a PIM class. We are currently trying to solve the issue with the PIM guys.  
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.6.3/kmymoney-4.6.3.tar.bz2/download KMyMoney 4.6.3] has been released on September 3rd 2012.
  
=== Installation steps  ===
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.6.2/kmymoney-4.6.2.tar.bz2/download KMyMoney 4.6.2] has been released on February 4th 2012.
  
Get the source from KDE SVN or the latest tarball from https://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/3.95.0/kmymoney-3.95.0.tar.bz2/download  
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.6.1/kmymoney-4.6.1.tar.bz2/download KMyMoney 4.6.1] has been released on November 6th 2011.
  
To install read the README.cmake file in the root folder of the source. The basic steps are the following:
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.6.0/kmymoney-4.6.0.tar.bz2/download KMyMoney 4.6.0] has been released on August 8th 2011.
  
$ mkdir build
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.5.3/kmymoney-4.5.3.tar.bz2/download KMyMoney 4.5.3] has been released on February 13rd 2011.
$ cd build
+
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/
+
$ make
+
$ make install
+
  
'''(this last step should be executed with admin privileges. Either switch to root or use sudo, or the appropriate steps for your installation)'''
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.5.2/kmymoney-4.5.2.tar.bz2/download KMyMoney 4.5.2] has been released on December 23rd 2010.
  
To execute, either look for KMyMoney on the Office menu, or type kmymoney in a console window.  
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.5.1/kmymoney-4.5.1.tar.bz2/download KMyMoney 4.5.1] has been released on November 14th 2010.
  
=== Localization ===
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/4.5/kmymoney-4.5.tar.bz2/download KMyMoney 4.5] has been released on August 16th 2010.
'''If you are installing from SVN source, you need to install your locale files by hand. If you are installing from the tarball provided above, please skip this section.'''
+
  
To localize you will need to download the appropriate kmymoney.po file from http://websvn.kde.org/trunk/l10n-kde4/<country_code>/messages/playground-office/ (replace <country_code> with the correct one for your locale e.g. es would give http://websvn.kde.org/trunk/l10n-kde4/es/messages/playground-office/) and then, either by switching to root or using sudo, do the following:
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/3.98/kmymoney-3.98.1.tar.bz2/download KMyMoney 3.98.1] has been released on May 21st 2010.
  
*Copy the kmymoney.po file into /usr/share/locale/<country_code>/
 
*In that folder run:
 
  
  $ msgfmt kmymoney.po -o LC_MESSAGES/kmymoney.mo
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/3.98.0/kmymoney-3.98.0.tar.bz2/download KMyMoney 3.98.0] has been released on May 15th 2010.
  
  Note: use the msgfmt that comes with your distribution not the one needed for kmymoney2.
+
[http://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/3.97.2/kmymoney-3.97.2.tar.bz2/download KMyMoney 3.97.2] has been released on Apr 6th 2010.
  
== Guidelines  ==
+
[https://sourceforge.net/projects/kmymoney2/files/KMyMoney-KDE4/3.96.1/kmymoney-3.96.1.tar.bz2/download KMyMoney 3.96.1] has been released on Feb 17th 2010.
  
This version is only suitable for early adopters. It will behave fairly well, but the application might crash and you may lose some data. Make backups often.
+
== Installation  ==
  
For 3.95 version and later, we use the Bugzilla tracker at bugs.kde.org. Any bugs you find, please report it and assign to product kmymoney4. Also, if you need help write to kmymoney-devel@kde.org.
+
=== Requirements  ===
  
== Development guidelines ==
+
KMyMoney depends on KDE SC 4.7+. Specifically on kdelibs, kde PIM libs, and kactivities.
  
As a first step, we are leaving Qt3Support, if possible. There are cases when it is best to port to the corresponding Qt4 classes. Examples of these are the QButtonGroups, KActions, KPageWidget, QTabBar
+
*g++
 +
*make
 +
*cmake
 +
*libkdepimlibs-devel
 +
*libgpgme-dev
 +
*libical-dev
 +
*libkactivities-dev
 +
*libgmp-dev
 +
*libalkimia-dev
  
For now, focus on make it work. Assess whether it will be faster using Qt3Support or a newer class.
+
==== Optional ====
 +
Additionally, you may want to install other libraries that will provide additional functionality:
  
The repository to use is the one in KDE SVN. svn://anonsvn.kde.org/home/kde/trunk/playground/office/kmymoney.  
+
*libofx >= 0.9.2
 +
*Aqbanking >= 5.0.0
 +
*quote::finance (also known as libfinance-quote-perl)
  
<br>
+
=== Installation steps  ===
  
== Blocking issues ==
+
If possible, it is always preferred to use a package specifically prepared for your distribution. However, if one is not available, or you want a more recent version, you can use the latest tarball.  If you really need the most recent version, such as to test a new bug fix, get the source from [https://projects.kde.org/projects/extragear/office/kmymoney KDE Git] at
 +
 +
* '''git://anongit.kde.org/kmymoney'''.
  
These are the issues that need to be fixed first before releasing a beta version.  
+
$ git clone git://anongit.kde.org/kmymoney
  
*<s>Entering a transaction and hitting an account limit will get the application in a loop which ends in a crash</s>
+
To install, read the README.cmake file in the root folder of the source. The basic steps are the following:
*<s>Reinvest dividend transaction form never enables the Enter button</s>
+
*<s>Enter does not work for transaction enter, only Return does.(not as important as the other, but it's a nag in a main part of the application)</s>
+
*<s>Port AqBanking plugin</s> ''Note: KBanking compiles against at Qt4 AqBanking. Still need to test if it really works (ipwizard)''
+
*There are a couple of occurrences of '''Uninitialized variables''' warnings during the build. We should fix those.
+
*Several files are rebuilt if '''make''' is executed twice in a row.
+
*<s>After the payee completer depletes al possible completions when typing a payee's name the typed text is selected so if the user continues to type all characters entered so far are lost</s>
+
  
== Areas known to work  ==
+
First, make sure you have uninstalled any old versions of kmymoney through your package manager and/or '''sudo make uninstall''' depending on how it was installed last time. Then:
  
I thought that we can put here a list of features that are known to work (after a developer testing):
+
$ mkdir build
 +
$ cd build
 +
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/
 +
# optional, to adjust build configuration
 +
$ ccmake .
 +
$ make && make
 +
$ sudo make install
  
<br>
+
It is important that the prefix is the same one that is used by your already installed KDE software.  If it does not match, you will run into problems later. The separate build directory is mandatory (out of source build).
 +
The ''install'' step should be executed with admin privileges. Either switch to root or use sudo, or the appropriate steps for your installation.
  
{| border="1"
+
To execute, either look for KMyMoney on the Office menu, or type kmymoney in a console window.
|-
+
! Area
+
! Status
+
! Comments
+
|-
+
| Tips and tricks
+
| Working
+
| <br>
+
|-
+
| Home Page
+
| Working
+
| <br>
+
|-
+
| Institutions
+
| Working
+
| <br>
+
|-
+
| Accounts
+
| Working
+
| <br>
+
|-
+
| Ledgers
+
| Working
+
| <br>
+
|-
+
| Schedules
+
| Working
+
| <br>
+
|-
+
| Categories
+
| Working
+
| <br>
+
|-
+
| Payees
+
| Working
+
| <br>
+
|-
+
| Investments
+
| Working
+
| <br>
+
|-
+
| Reports
+
| Working
+
| <br>
+
|-
+
| Charts
+
| Working
+
| <br>
+
|-
+
| Budgets
+
| Working
+
| <br>
+
|-
+
| Forecast
+
| Working
+
| <br>
+
|-
+
| Splash screen
+
| Working
+
| <br>
+
|-
+
| Settings
+
| Working
+
| <br>
+
|-
+
| Webconnect
+
| Working
+
| <br>
+
|-
+
| Plugins
+
| Working
+
| KBanking plugin needs to be tested: I was able to download statements (2009-12-24)
+
|-
+
| Database
+
| Working
+
| Passes unit tests for MySQL, PostgreSQL and SQLite3. (fvilas)
+
|-
+
| GPG
+
| Working
+
| Needs testing, does not compile with KDE trunk
+
|}
+
  
== Areas to work on  ==
+
=== Localization ===
 +
'''If you are installing from Git source, you need to install your locale files by hand. If you are installing from the tarball provided above, please skip this section.'''
  
*Views
+
To localize you will need to download the appropriate kmymoney.po file from http://websvn.kde.org/trunk/l10n-kf5/&lt;country_code&gt;/messages/extragear-office/ (replace &lt;country_code&gt; with the correct one for your locale e.g. es would give http://websvn.kde.org/trunk/l10n-kf5/es/messages/extragear-office/) and then, either by switching to root or using sudo, do the following:
*Dialogs
+
*Widgets
+
  
Also, here you have the KrazyEBN report, which reports common issues on the code. [http://www.englishbreakfastnetwork.org/krazy/reports/playground/office/kmymoney/index.html Krazy Report]
+
*Copy the kmymoney.po file into /usr/share/locale/&lt;country_code&gt;/  
 +
*In that folder run:
  
Please include the areas you are working on to avoid overlapping with other developers.  
+
  $ msgfmt kmymoney.po -o LC_MESSAGES/kmymoney.mo
  
=== conet  ===
+
  Note: use the msgfmt that comes with your distribution not the one needed for kmymoney2.
  
The following are on my TODO list but that does not mean that I don't need any help on them:
+
=== Debian dependencies ===
  
*<s>Check all the KListView classes that save their layout and make sure that works (restoreLayout was called in polish() in the Institutions view and polish() is not called anymore)</s>(done)
+
build-essential
*<s>Check what's up with the transaction form in the ledger</s>(done)
+
cmake
*<s>Work on the transaction form since I see it as the hardest thing to port and once it is done (with qt3 support) we can go one and work on the following bullet</s>(done)
+
kdelibs5-dev
*<s>Try to fix various small stuff that don't work yet until a usable application is obtained</s>(done)
+
kdepimlibs5-dev
*<s>Check for multiple instances. It was using DCOP, and it has to be migrated to a method suitable with DBus.</s>
+
libaqbanking29-dev
*<s>Port the KBanking plugin to KDE4 and add it the KMyMoney source tree</s>
+
libboost-graph-dev
*Although the code that takes care of the drawing of the highlighter of the drop target in kmymoneyaccounttreebase.cpp was ported the drop target is not highlighted
+
libfinance-quote-perl
 +
libgpgme11-dev
 +
libgwenhywfar47-dev
 +
libical-dev
 +
libjpeg62-dev
 +
libofx-dev
 +
libpng12-dev
 +
libsqlite3-dev
 +
libz-dev
 +
gettext
  
=== asoliverez ===
+
== Guidelines ==
  
<s>I will work on the account selector, probably migrate it to Qt4 widgets, because it does all kinds of weird stuff that can be probably optimized.</s> (fixed by conet) Working on the i18n and documentation issues with KDE-i18n team. Also going through the Krazy report, and fixing issues there.
+
This version is only suitable for early adopters. It will behave fairly well, but the application might crash and you may lose some data. Make backups often.  
 
+
=== ipwizard  ===
+
 
+
I will try to keep the strings together and work on coordination for the integration of/with other KDE applications. On the code front maybe setting up the Qt-Designer plugin for the KMyMoney widgets.
+
 
+
*<s>Getting the GPG encryption to work with either [http://api.kde.org/kdesupport-api/kdesupport-apidocs/qca/html/index.html QCA] or [http://api.kde.org/4.1-api/kdepim-apidocs/libkleo/html/index.html libkleo]</s> Replaced using [http://api.kde.org/4.3-api/kdepim-apidocs/libkleo/html/index.html libkleo]
+
*Replace kMyMoneyDateInput with [http://api.kde.org/4.x-api/kdepim-apidocs/libkdepim/html/classKPIM_1_1KDateEdit.html KPIM::KDateEdit]
+
*Separate the base and constructed widgets into their own libs
+
 
+
=== fvilas  ===
+
 
+
*<s>Convert the dialog allocations on the stack to use QPointer, per EBN point #5.</s>
+
*<s>Port the WebPriceQuote object.</s>
+
*<s>Port the QIF reader</s> and add test cases for it.
+
*Q3Table -&gt; QTableWidget for transaction and register (postponed due to size of task. If anyone wants this, I can send you my patch so far, if not, I'll get back to it at some point.)
+
*<s>Q3ButtonGroup -&gt; QButtonGroup port</s>
+
*General cleanup of deprecation warnings to quiet the build a bit
+
*<s>Q3BoxLayout -&gt; QBoxLayout</s>
+
 
+
== Issues  ==
+
  
Please report here the issues you find.  
+
For 3.95 version and later, we use the Bugzilla tracker at bugs.kde.org (BKO). Any bugs you find, please report it and assign to product kmymoney. Also, if you need help write to kmymoney-devel@kde.org.  
  
*<s>Libkdchart has been commented out until last minute. Charts won't work until then</s>(asoliverez)
+
=== Link to Debian bugs ===
*<s>Check for multiple instances. It was using DCOP, and it has to be migrated to a method suitable with DBus.</s> (conet)
+
The bugs in Debian tracker can be linked back to BKO
*<s>There is a bug in KHTMLPart where you get weird results if you call write() many times. Save it to a QString and call write() once instead.</s> Done (ipwizard)
+
*<s>Q3ButtonGroup objects should be migrated to QButtonGroup. The Q3Support class is severely handicapped and there are no issues in porting to the new class.</s>
+
*Standard icon names have changed. Check the name of the icon being called if you see a default icon is being displayed.
+
*<s>The code that creates the title bar (the one with the blue image) has been commented out since it somehow was not visible and the other widgets got behind in making it impossible to click them with the mouse.</s>(the code has been ported it only needs a good color scheme)
+
*The kmymoney.css seems to use the KDE3 styles. That's a bug in KHTML that will be in KDE SC 4.4.
+
  
== Areas to leave as they are for the moment  ==
+
* Open a bug report in KDE Bug Tracking System (BTS)
 +
* Link it to Debian bug number using "forwarded". See http://www.debian.org/Bugs/server-control#forwarded
 +
* When the bug is fixed in KDE BTS, the status will be synced in Debian BTS too.
  
libkdchart is an extract from koffice. If we find a bug there, it is best to report it to the kdchart maintainers
+
=== Obtain a useful backtrace on Windows  ===
 +
If you would like to create a bug report about an application crash on Windows you need to take care of the following to create a useful report:
  
The mymoney folder contains the engine. It is covered by the unit tests and they run ok. This is a critical area of the application, so check with Thomas or Alvaro before making a change.
+
* make sure that you can reproduce the crash
 +
* download the debug information that matches your version ([http://downloads.sourceforge.net/project/kmymoney2/KMyMoney-Windows/4.6.3/kmymoney-4.6.3-debug-info.7z 4.6.3])
 +
* extract the archive in a folder of your choice (in this example '''c:\temp\kmm-debug-info''') using 7z archiver
 +
* open '''cmd.exe'''
 +
* run '''set _NT_SYMBOL_PATH=c:\temp\kmm-debug-info'''
 +
* run '''"c:\Program Files\KMyMoney\bin\kdeinit4.exe" --terminate'''
 +
* run '''"c:\Program Files\KMyMoney\bin\kmymoney.exe"'''
 +
* try to reproduce the crash and use '''DrKonqi''' the KDE crash handler that appears when the application crashes (only on Windows 7) to report the crash on bugs.kde.org
 +
'''Notes''':
 +
* '''DrKonqi''' will inform you if the crash report is useful or not (it contains the debug information or not)
 +
* if '''DrKonqi''' says that the report is not useful something went wrong in the above steps
 +
* if you can't reproduce the crash immediately you can run KMyMoney for a while in an environment in which '''_NT_SYMBOL_PATH''' is defined as above (you can use a batch file for that)
 +
* when you no longer need the debug information you can safely delete the folder '''c:\temp\kmm-debug-info'''
  
Of course, if you find a critical bug in anywhere on the application, send a mail to the mailing list or report it on bugs.kde.org.
+
=== Windows specific configuration options ===
 +
==== KDE provided file dialogs for example for importer ====
 +
add to share/config/kdeglobals
 +
[KFileDialog Settings]
 +
Native=false
  
== Mailing list ==
+
==== Enable debug log level for online banking plugin ====
 +
Open a command shell in kmymoney 'bin' dir and run
 +
  set AQBANKING_LEVEL=debug
 +
set GWEN_LOGLEVEL=debug
 +
Then start kmymoney with
 +
kmymoney
 +
 +
==== Enable verbose log level for online banking plugin ====
 +
Open a command shell in kmymoney 'bin' dir and run
 +
set AQBANKING_LEVEL=verbous
 +
set GWEN_LOGLEVEL=verbous
 +
Then start kmymoney with
 +
kmymoney
  
https://mail.kde.org/mailman/listinfo/kmymoney-devel. Use it to discuss issues related to the port to KDE4.
+
==== Show aqbanking log file path ====
 +
# Start kmymoney
 +
# Open Settings->configure KMymoney
 +
# In the Main tab select "Support" -> on that page there is a link to the current aqbanking lo path
  
== Coordination  ==
+
== Schedule for future releases ==
 +
Development is active on trunk towards the next version. There is a [https://www.kmymoney.org/todofeatures.php wishlist] of features which might be integrated in future releases.
  
Alvaro Soliverez is coordinating the KDE4 effort. You can reach me at asoliverez at gmail.com or on IRC under Hei_ku in the #kmymoney channel. Alternatively, you can contact Thomas Baumgart on the developers list.  
+
=== Version 4.8.1 ===
 +
* Release in October 2017
 +
* Windows binaries are already available at [https://download.kde.org/stable/kmymoney/4.8.1/ KDE download mirror]
 +
* Source release for Linux is delayed because of incomplete [https://l10n.kde.org/stats/doc/stable-kde4/package/extragear-office/ translation] of the documentation
  
== People involved ==
+
=== Version 4.8.2 ===
 +
* Release date is not specified yet and depends on the number bugs fixed from the list of [https://www.kmymoney.org/openbugs.php open bugs] (at least 10)
 +
* Source snapshots can be fetched from the [https://cgit.kde.org/kmymoney.git/log/?h=4.8 Git repo]
 +
* Snapshot binaries for Windows are available (look for versions named 4.8.xyz which refers to the related git commit)
 +
** Mingw based installer snapshots for [https://software.opensuse.org/search?q=mingw32-kmymoney-installer Win32]  and [https://software.opensuse.org/search?q=mingw64-kmymoney-installer Win64] (use [http://www.7-zip.org/ 7zip] for unpacking the  rpm file)
 +
** Mingw based portable snapshots for [https://software.opensuse.org/search?q=mingw32-kmymoney-portable Win32]  and [https://software.opensuse.org/search?q=mingw64-kmymoney-portable Win64] (use [http://www.7-zip.org/ 7zip] for unpacking the  rpm file)
  
*mlaurent
+
=== Version 4.99.80 (Beta) ===
*conet
+
* Release date not specified yet (need to be specified by the KF5 development team)
*neoclust
+
*asoliverez
+
*tbaumgart aka ipwizard
+
*fvilas
+
*tonyb
+
  
(Contact the coordinator if you are willing to contribute)  
+
=== Version 4.99.90 (Release Candidate) ===
 +
* Release date not specified yet (need to be specified by the KF5 development team)
  
== Timeline  ==
+
=== Version 5.0.0 ===
 +
* Release date not specified yet (need to be specified by the KF5 development team)
  
Have it ready for kdereview before the end of the year. Is it too optimistic?
+
=== Version 5.0.1 ===
 +
* Release date not specified yet (need to be specified by the KF5 development team)

Latest revision as of 21:02, 18 February 2018

This page is dedicated to technical aspects of KMyMoney for KDE Platform 4. If you are looking for other info, or the source tarball, go to the official page of KMyMoney.

Kmm 5 splash.png

Available versions

Latest release

KMyMoney 5.0.0 has been released on 2nd of February 2018. Alternatively, you can get the source from the KDE Git. (see link below)

Obsolete releases

KMyMoney 4.8.0 has been released on 14th of June 2016.

KMyMoney 4.7.2 has been released on 14st of April 2015.

KMyMoney 4.7.1 has been released on 1st of November 2014.

KMyMoney 4.7.0 has been released on 1st of October 2014.

KMyMoney 4.6.6 has been released on 24th of June 2014.

KMyMoney 4.6.4 has been released on 6th of October 2013.

KMyMoney 4.6.3 has been released on September 3rd 2012.

KMyMoney 4.6.2 has been released on February 4th 2012.

KMyMoney 4.6.1 has been released on November 6th 2011.

KMyMoney 4.6.0 has been released on August 8th 2011.

KMyMoney 4.5.3 has been released on February 13rd 2011.

KMyMoney 4.5.2 has been released on December 23rd 2010.

KMyMoney 4.5.1 has been released on November 14th 2010.

KMyMoney 4.5 has been released on August 16th 2010.

KMyMoney 3.98.1 has been released on May 21st 2010.


KMyMoney 3.98.0 has been released on May 15th 2010.

KMyMoney 3.97.2 has been released on Apr 6th 2010.

KMyMoney 3.96.1 has been released on Feb 17th 2010.

Installation

Requirements

KMyMoney depends on KDE SC 4.7+. Specifically on kdelibs, kde PIM libs, and kactivities.

*g++
*make
*cmake
*libkdepimlibs-devel
*libgpgme-dev
*libical-dev
*libkactivities-dev
*libgmp-dev
*libalkimia-dev

Optional

Additionally, you may want to install other libraries that will provide additional functionality:

  • libofx >= 0.9.2
  • Aqbanking >= 5.0.0
  • quote::finance (also known as libfinance-quote-perl)

Installation steps

If possible, it is always preferred to use a package specifically prepared for your distribution. However, if one is not available, or you want a more recent version, you can use the latest tarball. If you really need the most recent version, such as to test a new bug fix, get the source from KDE Git at

$ git clone git://anongit.kde.org/kmymoney

To install, read the README.cmake file in the root folder of the source. The basic steps are the following:

First, make sure you have uninstalled any old versions of kmymoney through your package manager and/or sudo make uninstall depending on how it was installed last time. Then:

$ mkdir build
$ cd build
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/
  1. optional, to adjust build configuration
$ ccmake .
$ make && make
$ sudo make install

It is important that the prefix is the same one that is used by your already installed KDE software. If it does not match, you will run into problems later. The separate build directory is mandatory (out of source build). The install step should be executed with admin privileges. Either switch to root or use sudo, or the appropriate steps for your installation.

To execute, either look for KMyMoney on the Office menu, or type kmymoney in a console window.

Localization

If you are installing from Git source, you need to install your locale files by hand. If you are installing from the tarball provided above, please skip this section.

To localize you will need to download the appropriate kmymoney.po file from http://websvn.kde.org/trunk/l10n-kf5/<country_code>/messages/extragear-office/ (replace <country_code> with the correct one for your locale e.g. es would give http://websvn.kde.org/trunk/l10n-kf5/es/messages/extragear-office/) and then, either by switching to root or using sudo, do the following:

  • Copy the kmymoney.po file into /usr/share/locale/<country_code>/
  • In that folder run:
  $ msgfmt kmymoney.po -o LC_MESSAGES/kmymoney.mo
  Note: use the msgfmt that comes with your distribution not the one needed for kmymoney2.

Debian dependencies

build-essential cmake kdelibs5-dev kdepimlibs5-dev libaqbanking29-dev libboost-graph-dev libfinance-quote-perl libgpgme11-dev libgwenhywfar47-dev libical-dev libjpeg62-dev libofx-dev libpng12-dev libsqlite3-dev libz-dev gettext

Guidelines

This version is only suitable for early adopters. It will behave fairly well, but the application might crash and you may lose some data. Make backups often.

For 3.95 version and later, we use the Bugzilla tracker at bugs.kde.org (BKO). Any bugs you find, please report it and assign to product kmymoney. Also, if you need help write to kmymoney-devel@kde.org.

Link to Debian bugs

The bugs in Debian tracker can be linked back to BKO

Obtain a useful backtrace on Windows

If you would like to create a bug report about an application crash on Windows you need to take care of the following to create a useful report:

  • make sure that you can reproduce the crash
  • download the debug information that matches your version (4.6.3)
  • extract the archive in a folder of your choice (in this example c:\temp\kmm-debug-info) using 7z archiver
  • open cmd.exe
  • run set _NT_SYMBOL_PATH=c:\temp\kmm-debug-info
  • run "c:\Program Files\KMyMoney\bin\kdeinit4.exe" --terminate
  • run "c:\Program Files\KMyMoney\bin\kmymoney.exe"
  • try to reproduce the crash and use DrKonqi the KDE crash handler that appears when the application crashes (only on Windows 7) to report the crash on bugs.kde.org

Notes:

  • DrKonqi will inform you if the crash report is useful or not (it contains the debug information or not)
  • if DrKonqi says that the report is not useful something went wrong in the above steps
  • if you can't reproduce the crash immediately you can run KMyMoney for a while in an environment in which _NT_SYMBOL_PATH is defined as above (you can use a batch file for that)
  • when you no longer need the debug information you can safely delete the folder c:\temp\kmm-debug-info

Windows specific configuration options

KDE provided file dialogs for example for importer

add to share/config/kdeglobals

[KFileDialog Settings]
Native=false

Enable debug log level for online banking plugin

Open a command shell in kmymoney 'bin' dir and run

set AQBANKING_LEVEL=debug
set GWEN_LOGLEVEL=debug

Then start kmymoney with

kmymoney

Enable verbose log level for online banking plugin

Open a command shell in kmymoney 'bin' dir and run

set AQBANKING_LEVEL=verbous
set GWEN_LOGLEVEL=verbous

Then start kmymoney with

kmymoney

Show aqbanking log file path

  1. Start kmymoney
  2. Open Settings->configure KMymoney
  3. In the Main tab select "Support" -> on that page there is a link to the current aqbanking lo path

Schedule for future releases

Development is active on trunk towards the next version. There is a wishlist of features which might be integrated in future releases.

Version 4.8.1

  • Release in October 2017
  • Windows binaries are already available at KDE download mirror
  • Source release for Linux is delayed because of incomplete translation of the documentation

Version 4.8.2

  • Release date is not specified yet and depends on the number bugs fixed from the list of open bugs (at least 10)
  • Source snapshots can be fetched from the Git repo
  • Snapshot binaries for Windows are available (look for versions named 4.8.xyz which refers to the related git commit)
    • Mingw based installer snapshots for Win32 and Win64 (use 7zip for unpacking the rpm file)
    • Mingw based portable snapshots for Win32 and Win64 (use 7zip for unpacking the rpm file)

Version 4.99.80 (Beta)

  • Release date not specified yet (need to be specified by the KF5 development team)

Version 4.99.90 (Release Candidate)

  • Release date not specified yet (need to be specified by the KF5 development team)

Version 5.0.0

  • Release date not specified yet (need to be specified by the KF5 development team)

Version 5.0.1

  • Release date not specified yet (need to be specified by the KF5 development team)

This page was last modified on 18 February 2018, at 21:02. Content is available under Creative Commons License SA 4.0 unless otherwise noted.