1.4. Known Issues

This section contains a list of known issues that may prevent Fanurio from running as expected. Usually, they are quirks of the underlying operating system. Each issue documents the problem and shows a possible solution if there is one.

1.4.1. Idle Detection on Mac

Idle detection is available for both Intel and Power-PC Macs that run Tiger (Mac OS X 10.4) or Leopard (Mac OS X 10.5). This feature is not available on previous versions of Mac OS X as they don't have a reliable method to detect idle time.

1.4.2. Running on Mac

Fanurio has been tested on Panther, Tiger and Leopard with Java 1.4.2, Java 1.5 and Java 6. It runs on both Intel-based and PowerPC-based Mac computers.

There was only one reported case when it didn't run on an Intel-based Mac (running Tiger) with Java 6. The problem was fixed by replacing the JavaApplicationStub file used by Fanurio with the one found on that computer.

In case Fanurio is not running on your Mac, it may be caused by an invalid JavaApplicationStub file. To replace it, please follow the instructions listed below:

  1. Make sure you have installed Fanurio in the Applications folder

  2. Start Finder and go to Macintosh HD -> System -> Library -> Frameworks -> JavaVM.framework -> Versions -> Current -> Resources -> MacOS

  3. Copy the JavaApplicationStub file (this is the good file)

  4. Go to the Applications folder, right-click on Fanurio and select Show Package Contents to show its contents

  5. Then go to Contents -> MacOS and delete the JavaApplicationStub file (this is the bad file)

  6. Paste the file copied at step 3 into the folder open at step 5

1.4.3. Sending Emails

The send email feature is enabled for the Mac OS X version and for all the other versions if they run using Java 6. To see what version of Java you are using, go to the About dialog. These restrictions are meant to protect your privacy.

Fanurio needs Java 6 to encrypt passwords using your computer's id so that they cannot be decrypted anywhere else. In other words, if someone (our support team, for instance) has access to the configuration file where your email password is saved, they will not be able to decrypt it on other computers unless they know your computer's id.

Fanurio uses the MAC address to determine your computer's id.

1.4.4. Direct Printing vs PDF Printing

If you want to print an invoice from Fanurio, you have two choices:

  1. Directly: View the invoice then use the Print button.

  2. Indirectly: Export the invoice to PDF then print it.

Indirect printing (PDF) gives slightly better results but if you are not interested in having perfect alignement for all pixels this shouldn't matter.

It's also recommended to use PDF printing if your invoices have a background layer as explained here. Background layers can only be used when exporting invoices to PDF.

1.4.5. Fonts and PDF Invoices

Note: This section is about fonts for PDF invoices exported by Fanurio. It is not about fonts for HTML invoices. If you are using specific fonts and you export your invoices to HTML, it's the browser's job to render them correctly.

When using specific fonts for PDF invoices, Fanurio will not search you computer's fonts folder for them. Instead, you have to put the font files in a folder that Fanurio searches. Fanurio can only work with TrueType (*.ttf) and OpenType (*.otf) fonts. If you have other types of fonts, you need to convert them to one of these types.

Here's what you need to do:

  1. Go to File » Show Templates to open the templates folder (Fanurio searches this folder for fonts)

  2. Copy the font files (*.tff or *.otf) to this folder

  3. Make sure the CSS code of the template specifies the font

    body {
        font-family: "AG Buch Condensed BQ"; /* replace this with your font */
    }

Once you do this, all PDF invoices with use the specified font.

1.4.6. Character Encoding

You may want to use a specific font for your invoices to make them prettier or to substitute the default font when it doesn't render correctly characters in your language (non-latin, eastern-european, etc). In order to render all characters correctly, Fanurio needs to know what character encoding should be used with the font.

By default, Fanurio assumes it is UTF-8 (Unicode) but this will not work every time. When using a specific font, if characters are not rendered correctly or if there is an error exporting an invoice to PDF, you will have to specify a different character encoding. There's nothing to worry about if you export to HTML.

To specify a different encoding, add the following line to the settings file:

pdf.encoding=Cp1252

Cp1252 refers to the West European Latin character encoding. Other encodings are:

  • Cp1250 - East European Latin

  • Cp1251 - Cyrillic

  • Cp1252 - West European Latin

  • Cp1253 - Greek

  • Cp1254 - Turkish

  • Cp1255 - Hebrew

  • Cp1256 - Arabic

  • Cp1257 - Baltic

  • Cp1258 - Vietnamese

This section shows how to add, change or delete a setting directly from the settings file.

1.4.7. Tray Icon Support

Fanurio's tray icon is available only on computers running Java 6 or higher. You can download the latest Java version from java.com.

Linux Notes

The tray icon is not enabled by default on Linux since the tray implementation is not that good as the Windows one. We believe it's good enough to be part of Fanurio and we provide it because the advantages outweigh the disadvantages.

  • If you do not see the tray icon, the notification area is probably disabled. You can enable it by right-clicking the GNOME panel and selecting Add to Panel > Utility > Notification Area.

  • Make sure the panel size is >= 26 pixels for the tray icon to align nicely. To change the panel size, right-click on the GNOME panel and select Properties.

  • The tray icon background is gray due to a Java bug. To fix this problem, you can change the panel color to match the tray icon background color. Right-click on the GNOME panel, select Properties and change the color to "Solid Color" with approximately 90% opacity.

1.4.8. Ubuntu Time Zone

Fanurio (Java) may not read time correctly on certain Ubuntu installations. You can notice this problem if you are trying to add time to a project item using Business » Add Time. The "Started at" time is different than what you computer says. In these situations, Fanurio (Java) will use the GMT time instead of your time.

If you notice this problem, please use this solution to fix it.

1.4.9. Database Error Message

If Fanurio isn't closed correctly, you may get a database error message when you start it the next time. This happens if you shutdown your computer without closing Fanurio first.

In this case, the operating system closes Fanurio and the database doesn't get the chance to delete a temporary (lock) file. The next time it's started, the database thinks it is already open because the lock file wasn't deleted.