Category Archives: How-To

Save & Editing GFX Beta 2 Database

If you are lucky enough to be using the latest version of GFX beta 2 then you know one of the limitation is only one event can be created. Beta 2.2 should support any number of events. But in the mean time, like you, I don’t want to delete the results of my last event. One user wants to transfer over the results from their event to another computer. The computer they used for their event was a loaner. This is pretty easy to do.

But before we get that far I would like to suggest downloading another AIR application called Lita. Lita is a SQLite database administrator. If you want to crack open the database then Lita will let you do just that. If you are not familiar with database tools then it might be too much for you and you should avoid it. I can’t support or answer any questions about Lita so you are on your own if you decide to use it. You can download Lita at http://www.dehats.com/drupal/?q=node/58. You can find instructions on the dehats website.

WARNING: If you edit the database structure Goldsprints FX will probably have problems. Don’t do it. Editing the data is not a problem.

If you want to back up your database or move it to another computer on OS X you can find the GFX.db file at the following location.

Users/YouruserName/Library/preferences/GoldsprinsFX/Local Store

On Ubuntu it will be something like this below. The part that says ‘SomeReallyLongAlphaNumericString’ will be unique to your machine.

/home/YourUserName/.appdata/GoldsprintsFX.SomeReallyLongAlphaNumericString/Local Store/GFX.db

I don’t have a Windows machine to tell you where it is but use the Search and you should be able to find it easy enough.

On a Windows machine you can find it here.

C:\Users\spencer.read\AppData\Roaming\GoldsprintsFX.150CD2418696DCCD52376108DD815BE3EE017F77.1\Local Store

If you are moving the database, first install GFX on your new computer. After you run the app for the first time go a head and exit out. GFX will have created you a GFX.db file. Find the GFX.db file on your new computer and delete it. Copy over your old GFX.db file and your old data will be moved to the new computer.

If you have any questions or something is not clear post a question or comment. If someone can tell me where the Windows GFX.db is stored I will update this post.

How To Swap Out Background Images

This video shows where the backgroud images are stored on OS X. For Ubuntu and Window you can skip the part of right clicking and opening the package file. Just look in the file structure for the same directories and swap out the images. You MUST keep the names the same. They are…

background1.png – opening screen
background2.png – race screen
background3.png – settings screen
ClockSkin.png – image that shows on the clock face

The cheering crowd image will always show on top of your background on the startup page. This is by design to keep a little branding in place. Enjoy and happy skinning. Please share a screen shot of you own custom skins. I would love to see how you have customized your version of GFX.

Setting up Goldsprints FX – Part 2 of 2

If you do not have Serproxy up and running stop and read the first part of this tutorial before continuing.

Great, you have Serproxy running. Now let’s get Goldsprints FX installed. Installation of GFX is pretty straight forward. First a quick note that I am sure people will ask about when they see the installatoin screens. GFX is developed with FLEX and delivered via Adobe AIR. The Adobe AIR is simply a runtime that lets developers use proven web technologies to build rich Internet applications that run outside the browser on multiple operating systems. The one thing I don’t like about delivering an AIR application is that your application is unsigned unless you pay a company like VeriSign to authenticate your application. If you pay them $200 – $500 you get a nice message in the installer that says your application has been verified safe. You have to pay again every year if you want to keep releasing new versions of your application. I may or may not pay to have Goldsprints FX verified but I don’t have the money now so GFX remains unsigned. If that doesn’t sit well with you then do not install GFX or you can donate some money and help me get a certificate. If you want to learn more about the digital certificates read this.

There is no warranty with Goldsprints FX. Goldsprints FX is free and you are installing it at your own risk. DO NOT install GFX if you have download it from any other website other than this one. I do not grant anyone permission to distribute Goldsprints FX. Soon I will have more of an official disclaimer but for now this will have to do.

Remember that you need both the Flash Player 9+ and Adobe AIR installed. Without AIR installed your computer will not know what to do with the installation file. The extension is .air. After you get the GFX archive from the downloads page and unpacked you will have a file like what you seen below. Launch the GoldsprintsFX.air file to start the install.

After a quick progress screen you will see the screen below. Without a certificate Publisher and Publisher Name remain “UNKNOWN”.

The image above shows a warning since I have not had the application verified. The second and final screen let’s you select the installation directory and a check box if you want to launch GFX right away. In my case I am installing on OS X but you can expect the see the same thing on Windows and Ubuntu.

When the installation is complete you should be on your way. If Serproxy is running and GFX is running the first thing you want to do is go to the Settings screen and update all the options. Without updating the Settings page first the Race page will not be formatte correctly. The first time you see the Settings screen it will look like the screen shot below.

Update all the options making sure that you have entered something in each filed and radio button. Now close GFX and launch it again. Verify that all your settings were saved and show up on the options screen. I will be updating the default settings as the beta continues to make the first time launch a little more user friendly.

If everything is okay then you are ready to race. If you have any questions or problems check the FAQ first. If the FAQ did not help then post trouble tickets on the SUPPORT page.

Setting up Goldsprints FX – Part 1 of 2

This is part one of the installation tutorial on getting Goldsprints FX installed and running on your OS of choice.

First we need to get Serproxy running. Serproxy is a Serial to Socket Server and is required to get GFX up and running. There are a few serial to proxy servers out there but Serproxy is the one I recommend. Serproxy sits on the other side of the USB port and gives us a way to communicate with the OpenSprints hardware. In the case of GFX we are giving Flash a way to get and send data to the OpenSprints hardware.

There is no installation process for Serproxy, simply download the Serproxy archive, and then unpack it somewhere readily accessible on your computer. The location doesn’t matter as long as you remember where it is. You’ll find an executable as well as a configuration file called “serproxy.cfg”.

Open the “serproxy.cfg” file using a text editor. Take a look at the different parameters. This is what my cfg file looks like on my OS X machine.

Start editing the file to match my settings you see in the screen shot above. Everything should be the same except maybe the “serial_device1” at the bottom. Serproxy needs to know where to find your USB port on the machine that is connected to the OpenSprints hardware.

To find what USB port you have the OpenSprints hardware connected to make sure your OpenSprints hardware is connection to your computer. Then depending on what OS you are running do one of the following:

OS X: Open Terminal and enter “ls /dev/cu.usb*”. You’ll probably only find one entry listed, and this is the label that your machine gives the USB port to which the OpenSprints hardware is connected.

Windows: [coming soon] – I don’t have a Windows machine so I am not sure how to get the label. Look for an update soon.

Ubuntu: You might have to do this as root. Open Terminal and enter “ls /dev/ttyUSB*”. You’ll probably only find one entry listed, and this is the label that your machine gives the USB port to which the OpenSprints hardware is connected. Most likely it will be ‘/dev/ttyUSB0’.

Enter the lable into the “serial_device1” line in your cfg filie. That should do it. Save and close the cfg file. Now launch the serproxy executable. You should see something like this. Again, this is on OS X and about the same as Ubuntu.

Anytime you run GFX you need to have Serproxy running. Otherwise GFX cannot communicate with the OpenSprints hardware.

Check out the second part of this tutorial to get GFX installed.