1.3. Frequently Asked Questions

1.3.1. Installing the Registered Version

Q: How do I install the registered version, once I purchase it?

Here's what you need to do to install the registered version that you get after you purchase a license:

  1. First of all make sure the trial version of Fanurio is not running. If it is, close it.

    • Use File » Exit to close the application on Windows

    • Use Fanurio » Quit to close the application on Mac

    • Use File » Quit to close the application on Linux

  2. In the email that confirmed your purchase, there is a link to the installer of the registered version and a license file (a .dat file). Please download them on your computer.

    • The Windows installer is a .exe file

    • The Mac installer is a .dmg file

    • The Linux installer is a .deb file

  3. Run the installer. It will install the registered version over the trial one. Your existing data will not be touched.

  4. Run Fanurio as usually. It will ask you to enter the email address and the path to the license file (downloaded at step 2).

1.3.2. Location of Data and Settings

The location of data and settings depends on the operating system. Fanurio does this to integrate smoothly with the operating system. As a rule, it stores them somewhere in the user's home folder. By data and settings we mean:

  • log file: This file is used by Fanurio to log messages and errors related to its execution.

  • settings file: This file keeps application specific settings like the position and size of the Fanurio window.

  • data folder: This folder contains the user entered data like clients, projects and invoices.

  • backup folder: This folder contains backups made by Fanurio; the location of this folder can be changed from the application. You may want to use a different backup location for safety reasons.

  • templates folder: This folder contains user defined invoice templates that Fanurio uses to export invoices. The location of this folder can be changed from the application. You can open this folder from Fanurio by using the File » Show Templates command.

  • project reports templates folder: This folder contains user defined reports templates.

Note: Knowing the location can be helpful if you want to backup the settings and data by hand.

Fanurio also has some default invoice and project reports templates that are installed in:

  • C:\Program Files\Fanurio\share on Windows

  • /Applications/Fanurio.app/Contents/Resources/Java/share on Mac OS X

  • /usr/share/fanurio/share/ on Linux (Debian-based)

  • ./share/ on other Linux flavors

Q: I'm a Mac OS X user, where does Fanurio keep its data and settings?

On Mac, the data and settings are spread in a few folders to adhere to the Apple requirements as follows:

  • log file: ~/Library/Logs/Fanurio/

  • settings file: ~/Library/Preferences/Fanurio/

  • data folder: ~/Library/Application Support/Fanurio/data

  • backup folder: ~/Library/Application Support/Fanurio/backup or the folder specified in the Backup section from Fanurio » Preferences (see the above introduction)

  • templates folder: ~/Library/Application Support/Fanurio/templates or the folder specified in the General section from Fanurio » Preferences (see the above introduction)

  • project reports templates folder: ~/Library/Application Support/Fanurio/project_reports

where ~ is the user's home folder. If Fanurio is unable to create any of the above folders, it will create a .fanurio folder in the user's home folder. In most such cases (rare, maybe never), the path is:

~/.fanurio/

Q: I'm a Windows user, where does Fanurio keep its data and settings?

On Windows, the data and settings are kept in the Application Data folder from the user's home folder. In most cases, the path is:

C:\Documents and Settings\USER_NAME\Application Data\Fanurio\

where USER_NAME is the name used when logging in. If Fanurio is unable to create a folder in Application Data, it will create a .fanurio folder in the user's home folder. In most such cases (rare, maybe never), the path is:

C:\Documents and Settings\USER_NAME\.fanurio\

If you use Vista, the path to these settings is:

C:\Users\USER_NAME\AppData\Roaming\Fanurio\

Go to Tools » Options to change the location of the backup folder or the location of the templates folder.

Q: I'm a Linux user, where does Fanurio keep its data and settings?

On Linux, the data and settings are kept in the .fanurio directory from the user's home directory. The path is ~/.fanurio.

Go to Edit » Preferences to change the location of the backup folder or the location of the templates folder.

1.3.3. Changing Settings Manually

Warning: Changing settings manually should be done with care and only if it's absolutely necessary. In some situations (very very rare, maybe never), it's the only way Fanurio can be configured.

The settings are different from the actual data (like clients or projects) that users enter in the application. Settings refer to anything Fanurio must remember between successive runs like the position of the application window or the output folder for exported invoices, just to name a few.

Some settings can be changed from the application but others can only be changed by editing the settings file. By doing this, we keep the user interface simple to use and learn with only a few options.

Follow these steps to edit the settings file manually:

  1. Make sure Fanurio is not running

    • Use File » Exit to close the application on Windows

    • Use Fanurio » Quit to close the application on Mac

    • Use File » Quit to close the application on Linux

  2. Find the file fanurio.properties in:

    • C:\Documents and Settings\USER_NAME\Application Data\Fanurio\ on Windows

    • C:\Users\USER_NAME\AppData\Roaming\Fanurio\ on Vista

    • ~/Library/Preferences/Fanurio/ on Mac OS X

    • ~/.fanurio on Linux

  3. Open it with a text editor

  4. Add, edit or remove the lines that contain the settings that you want to edit

  5. Save the file and close the editor

  6. Restart Fanurio

Example 1: If you want to specify a different character encoding for the font used to export invoices to PDF, then you have to add a line like this one:

pdf.encoding=Cp1252

Example 2: Fanurio uses the ui.window.mini.bounds setting to remember the size and location of the iTunes-like mini view. If you want to reset this setting, you have to follow the above steps and delete the line that starts with ui.window.mini.bounds.

1.3.4. Installing and Running from a USB Stick

To install and run Fanurio from a USB stick, please follow these instructions:

  1. Get the cross-platform version (.tar.gz)

  2. Install it on the USB stick by unzipping it

  3. Start Fanurio from the stick by running:

    • fanuriolocal.app on Mac OS X

    • fanuriolocal.exe on Windows

    • fanuriolocal.sh on Linux and other flavors of Unix

Note: It's important to start Fanurio using the local scripts. The other scripts (without local in their name) will start Fanurio but will not keep the data on the stick.