Troubleshooting

Get source from launchpad

Please visit LaunchPad help page related to this.

Compiling for GNU/Linux distribution

The compiling instruction will differ depending on the distribution you uses.

Requisites

  • gcc
  • automake tools
  • libgtk3.0 development files
  • libofx
  • libofx development files
  • libsoup
  • libsoup development files
  • intltool (if you have problems with .po file compilation)

Debian/Ubuntu distribution

Here are the instructions for compiling on debian/ubuntu:

  • open a terminal
  • type: sudo apt-get install build-essential libgtk-3-dev libofx7 libofx-dev libsoup2.4 libsoup2.4-dev intltool
  • uncompress the archive file: tar -zxpf homebank-x.x.tar.gz
  • move to HomeBank folder: cd homebank-x.x
  • type: ./configure --prefix=/usr
  • type: make
  • type: sudo make install

DEBUG: Report or complete a bug with gdb.exe

If you are facing a program crash, it can be difficult for the developer to understand what is going on. The procedure below is oriented for Windows users, I assume that GNU / Linux users will be able to transpose these instructions :)

Preparation

  • download a zipped version of gdb.exe
  • option: sometimes I will need to provide an executable file with debug symbol
  • uncompress the zip to C:\Program Files (x86)\HomeBank (with admin rights)
  • launch a cmd.exe from the location (replace C:\Program Files (x86)\HomeBank by cmd and press ENTER)
  • or launch a cmd.exe and change the folder to C:\Program Files (x86)\HomeBank

The debug session

  • type: gdb.exe HomeBank.exe
  • on prompt (gdb), type: run, then ENTER
  • reproduce the step into HomeBank until it crash
  • HomeBank will freeze, don't close it
  • go back to the cmd console, you should have focus
  • type: bt + ENTER
  • this will log the debug log and hopefully the crash location/dll area
  • copy all this into the clipboard
  • past this to a new text file with notepad or similar
  • add this text file to your bug report or comment to a bug report

Install on Mac OS X

First, this is a third party port, so if you encounter problems installing HomeBank, in despite of the instuctions below that were provided by a mac user, please try to get some help on macports, or brew or on a mac dedicated forum.

Using Homebrew package

using command in terminal

  • 1. proceed homebrew package manager:
    $ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"
  • 2. proceed Homebank:
    $brew install homebank

Using MacPort (on Mac OSX 10.6 (Snow Leopard)

  • 0. Check X11 is installed, if not, you have to use your Mac OS X Installation DVD to install it
  • 1. Install MacPort: http://www.macports.org/install.php
  • 2.Start a Terminal
  • 3. Type: sudo port install homebank
    • This gives error "install-sh: Permission denied" as reported here: https://svn.macports.org/ticket/24431
    • The cause of error is that "install-sh" has no execute rights
    • To fix that problem, do three more steps:
    • 3a. Type: cd /opt/local/var/macports/build/_opt_local_var_macports_sources_rsync.macports.org_release_ports_x11_homebank/work/destroot/opt/local/bin
    • 3b. Type: sudo chmod 755 install-sh
    • 3c. Type: sudo port install homebank
  • 4. Start Applications/Utilities/X11
  • 5. Type: homebank

When icons are missing (e.g. at the toolbar), do three more steps

  • Exit the HomeBank application
  • At Termnial, type: sudo port install hicolor-icon-theme
  • At X11, type: homebank

WEB: Malicious warning from your browser (chrome)

This occurs only for Google Chrome web browser users:

The installer file HomeBank-x.y.z-setup.exe is sometimes reported as malicious for some obvious reason but it is not, it's a false positive.

Be reassured, you can double check by yourself. As a first step, you can check with an online security solution, like virustotal or f-secure.

Second step, if you need to be more reassured you can do a deep scan of the installer file with your antivirus after download.

If someone were to find a true positive result, then he can contact me