Please note: The steps to download screenshots can seem complex if you’re not familiar with some of the applications listed, so we’d love to personally walk you through it. Simply contact us to get started.
Hubstaff screenshots are retained for 6 months on paid plans and 1 month on free plans. In order to save your screenshots, you will need to export them. Fortunately, we have a tool that makes it very easy to quickly export your screenshots to retain for your own records.
If for whatever reason you get stuck somewhere in the process, don’t hesitate to contact us.
Using the Hubstaff Export Tool
To use the Hubstaff Export Tool, you will need to have Ruby installed on your computer. See how to install Ruby on various operating systems. Additional Ruby setup guides can been seen below:
- How to Install Ruby on Windows
- How to Install Ruby on Linux
- How to Install Ruby on OS X (Ruby comes pre-installed on Macs, so you likely already have it)
You can verify that Ruby is installed on your system by typing
into the command line in your terminal (OSX/Linux) or command prompt (Windows).
With Ruby installed on your system, you can run the hubstaff-export.rb file found at the repository.
Unzip the hubstaff-export.rb file to the location of your choice.
Please note down the directory where you saved the file. This location will dictate where the screenshots are saved.
Open a terminal window or command prompt and navigate to the directory where you have downloaded and unzipped the hubstaff-export.rb file.
- How to open a command prompt in Windows
- How to open a terminal window on OS X
- How to open a terminal window on Linux
For example, if you have the hubstaff-export.rb file on your Windows desktop, your file path will be: C:UsersYourUserNameDesktop or on a Mac it would be $HOME/Desktop
You may change the directory by using the ‘cd’ command (without quotes) i.e. cd Desktop or cd Downloads.
You will only need to do this step one time. First, make sure that you have a Hubstaff App Token. You can create a token by signing in, then clicking on the “Create App” button. With your App Token in hand, you can run this command:
ruby hubstaff-export.rb authenticate AppToken firstname.lastname@example.org MyAwesomePass
Replace “AppToken” with your App Token, “email@example.com” with your Hubstaff email login, and “MyAwesomePass” with your Hubstaff password.
ruby hubstaff-export.rb authenticate SpGdasdflkjl-SAs22k1lnRREkals123 firstname.lastname@example.org Abc123!
After running the command, you should see, “User authentication successful.”
The Authentication token and App token are cached into a file named hubstaff-client.cfg in the current directory.
Need help with this step? Contact email@example.com for further assistance.
Now you can run the command that will export your screenshots. An example command would be:
ruby hubstaff-export.rb export-screens 2015-07-01T00:00:00Z 2015-07-01T07:00:00Z -o [your_organization_id] -i both
The command should have the -o argument specified as it’s required (meaning the organization id). In order to obtain the organization id, you can go to the https://app.hubstaff.com/organizations page and click on the organization you want to extract screenshots from. Copy the id from the browser address bar. Example: `https://app.hubstaff.com/organizations/[organization_id]/members
Start and Stop time are required. Start and stop time should be in the following format: YYYY-MM-DDThh:mmZ where Z means that the time is in UTC (or it can be a timezone offset).
Example: 2015-06-01T04:00Z or 2015-06-01T00:00-0400 or 2015-06-01T05:00+0100 all represent the same time.
If you are in a time zone that is +08:00 in order to specify times in UTZ (the Z suffix to the ISO 8601 date time format) you need to subtract 8 hours.
Thus to fetch the 8 hours of screens that the user worked you would specify 2016-04-25T16:00Z -> 2016-04-26T00:00Z
Another way to specify the time is to explicitly specify the time zone in the iSO 8601 format e.g.
2016-04-26T00:00+0800 -> 2016-04-26T08:00+0800
If you want to specify time in eastern you need to use an offset on the time e.g.
2017-04-24T08:30:00-0400 (for DST) or 2017-01-01T08:30:00-0500 (for non DST). Or convert your times to UTC first when using the “Z” suffix.
After the start and stop times, you can add optional parameters. In the example above, -o 84 means Hubstaff organization with the ID 84. The “-i both” option means that both full size and thumbnail images will be downloaded. Other options are “-i full” (to download full size images only, this is the default), “-i thumb” (to download thumbnails only) and “-u 12” which denotes a specific user on the organization.
For a complete list of the available options, run:
After running the command, you should see “Saving screenshots”:
The screenshots will start to be downloaded to your current directory.
Once screenshots are deleted, they cannot be recovered. Please make sure to export your screenshots before they are removed.
See a complete breakdown of Hubstaff’s data retention policies.
If you’re on Windows, you may get SSL errors when you try to authenticate or export the screenshots.
To fix this, you’ll first want to download this file: http://curl.haxx.se/ca/cacert.pem
Next, you’ll need to create an environment variable called SSL_CERT_FILE and set its value to where you downloaded the cacert.pem file.
If you’re not sure how to create an environment variable, please see the instructions below.
Hit a roadblock? Contact firstname.lastname@example.org for further assistance.
Windows 8/Windows 10
First, type “System” into your computer’s search bar and select the “System” option for the control panel.
Next, you’ll want to click on “Advanced system settings” link on the side.
From there, click the button labeled “Environment variables”.
Under system variables, click “New”.
For the variable name, enter: SSL_CERT_FILE
For the variable’s value, enter the file path to where you downloaded the cacert.pem file previously. If you downloaded it to your desktop, for example, it might look like C:UsersYourNameDesktopcacert.pem
Finally, click “OK”.
Once you’ve done that, fully close out of all command prompt windows you might have open and restart the command prompt. You should no longer receive the SSL errors.