5.2. User data

5.2.1. Location

The location of data and settings depends on the operating system. Fanurio does this to integrate smoothly with each platform it runs on. As a rule, it stores them somewhere in the user's home folder. Knowing the location can be helpful if you want to backup the settings and data by hand. Some of these folders can be changed from the application.

By data and settings we mean:

  • log file: This file is used by Fanurio to log messages and errors related to its execution. Fanurio keeps at most two log files, depending on the volume of errors and warnings. The size of a log file is no larger than 2 MB.

  • audit file: This file is used by Fanurio to log database actions so that data can be recovered if something goes wrong with the database or the backup copies. Fanurio keeps at most three audit files. The size of an audit file is no larger than 2 MB.

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

  • user translations folder: The folder where users can add their (unofficial) translations of the application.

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

  • backup folder: This folder contains backups made by Fanurio.

  • templates folder: This folder contains subfolders with user-defined templates. You can open these folders by using commands from File » Show Templates. Fanurio also has some default templates.

Table 5.1. Location of user data on Windows (XP, 2000)

Item Location
Log C:\Documents and Settings\USER_NAME\Application Data\Fanurio\fanurio.log
Audit C:\Documents and Settings\USER_NAME\Application Data\Fanurio\fanurio-audit.log
Settings C:\Documents and Settings\USER_NAME\Application Data\Fanurio\fanurio.properties
Data folder * C:\Documents and Settings\USER_NAME\Application Data\Fanurio\data
Backup folder * C:\Documents and Settings\USER_NAME\Application Data\Fanurio\backup
Templates folder * C:\Documents and Settings\USER_NAME\Application Data\Fanurio\templates
Default templates folder C:\Program Files\Fanurio\share\templates
User translations folder C:\Documents and Settings\USER_NAME\Application Data\Fanurio\i18n

*) Go to Tools » Options » Folders to change these folders.

Table 5.2. Location of user data on Windows (Vista, 7)

Item Location
Log C:\Users\USER_NAME\AppData\Roaming\Fanurio\fanurio.log
Audit C:\Users\USER_NAME\AppData\Roaming\Fanurio\fanurio-audit.log
Settings C:\Users\USER_NAME\AppData\Roaming\Fanurio\fanurio.properties
Data folder * C:\Users\USER_NAME\AppData\Roaming\Fanurio\data
Backup folder * C:\Users\USER_NAME\AppData\Roaming\Fanurio\backup
Templates folder * C:\Users\USER_NAME\AppData\Roaming\Fanurio\templates
Default templates folder C:\Program Files\Fanurio\share\templates
User translations folder C:\Users\USER_NAME\AppData\Roaming\Fanurio\i18n

*) Go to Tools » Options » Folders to change these folders.

Table 5.3. Location of user data on Mac OS X

Item Location
Log ~/Library/Logs/Fanurio/fanurio.log
Audit ~/Library/Logs/Fanurio/fanurio-audit.log
Settings ~/Library/Preferences/Fanurio/fanurio.properties
Data folder * ~/Library/Application Support/Fanurio/data
Backup folder * ~/Library/Application Support/Fanurio/backup
Templates folder * ~/Library/Application Support/Fanurio/templates
Default templates folder /Applications/Fanurio.app/Contents/Resources/Java/share/templates
User translations folder ~/Library/Application Support/Fanurio/i18n

*) Go to Fanurio » Preferences » Folders to change these folders.

Table 5.4. Location of user data on Linux

Item Location
Log ~/.fanurio/fanurio.log
Audit ~/.fanurio/fanurio-audit.log
Settings ~/.fanurio/fanurio.properties
Data folder * ~/.fanurio/data
Backup folder * ~/.fanurio/backup
Templates folder * ~/.fanurio/templates
Default templates folder

./share/templates

/usr/share/fanurio/share/templates

User translations folder ~/.fanurio/i18n

*) Go to Edit » Preferences » Folders to change these folders.

5.2.2. Configuring folders

Some of the folders (database, backups and templates) can be configured from the application just in case you need to keep them somewhere else.

  • Go to Tools » Options » Folders on Windows

  • Go to Fanurio » Preferences » Folders on Mac

  • Go to Edit » Preferences » Folders on Linux

One situation when you may want to do this is if you want to keep your data synchronized with your Dropbox account. If you run Fanurio on two computers that are not in the same network, you can share a folder using file synchronization software like Dropbox. Here's how to do this:

  1. Make sure you have Dropbox installed on all computers where you want to use Fanurio.

  2. In your Dropbox folder, create a folder called Fanurio with three subfolders: database, backup and templates.

  3. Start Fanurio on your first computer and change the location of the database, backup and templates folders to point to the new Dropbox folders. Make sure you check the "Copy files to the new folders" box to copy existing files to the new locations.

    • Go to Tools » Options » Folders on Windows

    • Go to Fanurio » Preferences » Folders on Mac

    • Go to Edit » Preferences » Folders on Linux

  4. Close Fanurio on your first computer.

    • 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

  5. Start Fanurio on your second computer and repeat step 3 without checking the "Copy files to the new folders" box. There are already some files in there so you don't need to copy them again from the second computer.

  6. Now both computers will keep their data in the Dropbox folder.

Dropbox will make sure that whenever you work on one computer, data will be synchronized on the second computer. Just remember not to run Fanurio on both computers at the same time as it cannot merge changes made at the same time.

5.2.3. About backups

We know data is a very important asset. That's why Fanurio creates backup copies every six hours (1:00, 7:00, 13:00, 19:00) when it is running and another copy when it is started. A backup copy is also created when a new version is installed. Fanurio keeps at most 25 backup copies.

An additional security measure is the audit file that contains the latest database operations. The audit file can be at most 6MB in size and that should be enough to record the data entered during the last week. The audit file can be used to recover data just in case there is no backup copy and the database is corrupted. We don't imagine how both these things could happen and that's why this is an additional measure.

5.2.4. Creating and restoring backups

You can manage backups using the following commands:

  • Go to File » Backup to create a backup.

  • Go to File » Restore to restore an existing backup.

  • Go to File » Show Backups to open the folder with backups. You can then delete or copy older backups.

Besides being useful in case something wrong happens with your data, backup copies can also be used to transfer data between two computers. Whether you want to replace your desktop PC with a laptop or you decide to switch from Windows to Mac OS X or Linux, you can transfer your data from the old computer to the new computer using backup copies. Here's what you need to do:

Old Computer

  1. Start Fanurio on your old computer

  2. Go to File » Backup and name the backup migration

  3. Go to File » Show Backups to open the backups folder

  4. Copy the file called migration.fro to your new computer

New Computer

  1. Start Fanurio on your new computer

  2. Go to File » Show Backups to open the backups folder on the new computer

  3. Copy the migration.fro file to the backups folder on the new computer

  4. Go to File » Restore and choose migration from the list of backups

Once you complete these steps, the data from the old computer will be available on the new computer.

5.2.5. Syncing data between multiple computers

If you install Fanurio on two different computers (desktop and laptop) or two different platforms (Windows and Mac OS X), it's very likely you will want to keep your data synchronized. Here are some common situations:

  • If you do consulting work and you need to travel a lot, you may have a laptop and a desktop PC in your office. When you get back to the office, you may want to sync the desktop with the laptop.

  • You're a big Mac fan but unfortunately you have to do some of your work on Windows. You want to use Fanurio to track time while on Windows and then sync this information with the Mac.

This section explains how to synchronize your data between two computers. There are multiple ways to do it, each with its advantages and disadvantages.

A. USB stick

The first solution is also the easiest. Instead of installing Fanurio on two or more computers, install it on a USB stick. This will save you the trouble of synchronizing the data because it will always be kept on the stick.

Download the cross-platform version and follow these instructions to install it. The nice thing about the cross-platform version is that you can install it on a USB stick and then run it from there on any computer, whether it uses Windows, Linux or Mac OS X.

Tip

Use this method if you have to work on your client’s computer and you don’t want to install Fanurio there.

B. Shared folder (Dropbox)

If you can create a folder that is accessible from all computers, you could configure Fanurio to keep its data there instead of the default location. Read this section to learn how to change the location of the database folder, the backup folder and the templates folders.

Important

If you share the database folder between two computers, make sure you don't use it at the same time on both computers. The database doesn't support concurrent access.

Tip

Use this method if you can share a folder between two computers or two platforms (Windows, Mac OS X, Linux).

C. Backup transfer

The last solution and probably the less practical one is to create a backup on one computer and then restore it on the other. The main disadvantage is that you have to do this manually every time you switch computers otherwise they will be out of sync.

Read this section for more details on how to create and restore a backup.

Tip

Use this method only if you need to use a second computer from time to time otherwise there’s too much overhead to create and restore the backup.

5.2.6. Exporting the log file

If you notice something unusual about Fanurio, you can always send us the log file. You can either locate it on disk or use the Export Log button from the About dialog.

When you export the log from the About dialog, Fanurio creates a file called fanurio.log.zip at a location you specify. It's recommended that you export it to Desktop so that you can locate it easier.

5.2.7. 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 5.1. Mini-timer size and coordinates

Fanurio uses the ui.window.mini.bounds setting to remember the size and location of the iTunes-like mini timer. 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.


5.2.8. Translating to other languages

Fanurio keeps all translations in an archive called fanurio-i18n.zip.

You need this even if you create a brand new translation. The file fanurio_i18n.properties is the main file that contains the English translation of the application. The others contain translations of other languages and have a suffix of the form _ll_CC where ll is the language code and CC is the country code.

For instance, fanurio_i18n_fr_CA.properties represents the French translation for Canada while fanurio_i18n_en_CA.properties represents the English translation for Canada.

  1. Download fanurio-i18n.zip

  2. Extract the contents of the .zip archive somewhere on your computer (e.g. Desktop)

  3. Download PRBEditor and start it from your computer

    PRBEditor is an application that can help you translate Fanurio easier. Just in case you are wondering what PRB stands for, it means Property Resource Bundle and is a technical term that Java uses when dealing with *.properties files like the ones found in fanurio-i18n.zip.

    A *.properties file can also be edited using a plain text editor but it's a lot more work.

  4. Once PRBEditor starts, select Open resource file from the Welcome Form

  5. Locate fanurio_i18n.properties in the folder created at step 2

  6. Check the languages that you want to see in the Select Locales to Open dialog.

    If you want to translate to a language that's not displayed there, don't select anything.

  7. Select Locale > New Locale from the menu to add a new language.

    You don't have to do this if the language you want to translate to already exists. When adding a new locale, make sure you select one that includes both the language and the country, Greek (Greece) for instance and not just Greek.

  8. Click on a cell from your language column and type the translation to translate a key.

  9. When you're done, go to File > Save. It will save the language file in the folder created at step 2.

While using PRBEditor, you can press F4 to display the Statistics Form. It shows how many keys are translated.

If you choose to share your translation with other users, please send it to us so that we can make it public.

5.2.9. Installing a custom language file

Follow these steps to install a language file or to test a translation file that you created:

  1. Locate the user translations folder:

    • C:\Users\USER_NAME\AppData\Roaming\Fanurio\i18n on Windows Vista or Windows 7

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

    • ~/.fanurio/i18n on Linux

    • ~/Library/Application Support/Fanurio/i18n on Mac OS X

  2. Copy the language file to the translations folder. It can be the language file created above or any other language file from fanurio-i18n.zip.

  3. Start Fanurio

  4. Go to the Options/Preferences dialog

  5. Go to the Locale section

  6. Change the language and press Done

  7. Restart Fanurio

5.2.10. Password encryption

Fanurio encrypts the email password using your computer's id so that it 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.