====================================================================
 Sirius XD HR Systems 2.4.0 - Windows setup and update guide
====================================================================

This download is a ZIP containing the ready-to-run application.
It is NOT an installer. There is nothing to install - you extract the
folder once and open the app from it.

Please read the two warnings at the bottom. They cause most problems.


--------------------------------------------------------------------
 1. FIRST TIME SETUP
--------------------------------------------------------------------

1. Right-click the downloaded ZIP file and choose "Extract All...".

2. Choose a permanent location you can find again, for example:

      C:\Users\<your name>\Sirius XD HR Systems

   Do not extract it to your Downloads folder if you tend to clear
   that folder out.

3. Click "Extract" and wait for it to finish. It is a large app, so
   this can take a minute.

4. Open the extracted folder and double-click:

      Sirius XD HR Systems.exe

5. The first time you open it, Windows may show a blue box saying
   "Windows protected your PC".

   This is expected. The app is not yet signed with a paid Microsoft
   certificate, so Windows does not recognise the publisher yet.

   Click  "More info"  ->  then  "Run anyway".

6. Sign in with your Sirius XD HR email address and password. If you
   do not have a password yet, ask your manager or HR to set one.


--------------------------------------------------------------------
 2. CREATE A DESKTOP SHORTCUT (recommended)
--------------------------------------------------------------------

So you do not have to hunt for the folder every morning:

1. Right-click "Sirius XD HR Systems.exe".
2. Choose "Show more options" if you are on Windows 11.
3. Choose  Send to  ->  Desktop (create shortcut).

Use that shortcut from then on.

IMPORTANT: if you later replace the folder with a newer version
(see below), keep the folder in the SAME place and with the SAME
name. Your shortcut will then keep working. If you move or rename
the folder, delete the old shortcut and make a new one.


--------------------------------------------------------------------
 3. UPDATING FROM AN OLDER VERSION
--------------------------------------------------------------------

Your login and any time that has not yet uploaded are NOT stored in
the application folder. They are stored separately in your Windows
user profile. That means replacing the application folder does not
sign you out and does not lose tracked time.

FIRST, in every case:

  * Stop your timer if it is running.
  * Fully close Sirius XD HR Systems (close the window, and make sure
    it is not still running in the system tray by the clock).

THEN follow the section that matches what you have now.


  A) You have version 2.3.0 or another ZIP/portable version
  ---------------------------------------------------------
  1. Extract the new ZIP to a NEW empty folder.
  2. Check it works (open it, sign in, confirm the version - see
     section 4).
  3. Delete the old application folder once you are happy.

  Do NOT extract the new version on top of the old folder. Mixing
  files from two versions is the most common cause of a broken app.


  B) You have version 1.0.x (you originally ran a "Setup" file)
  -------------------------------------------------------------
  That older version was installed properly, so remove it first:

  1. Open  Settings  ->  Apps  ->  Installed apps.
  2. Find "Sirius XD HR Systems" and choose Uninstall.
  3. If it asks whether to also remove application data, choose NO.
     Choosing No keeps you signed in and keeps any unsent time.
  4. Now follow "FIRST TIME SETUP" above.


  C) You are not sure which version you have
  -------------------------------------------
  Open the app and look at the version badge (section 4). If you
  cannot open it at all, follow B) - it is safe either way.


--------------------------------------------------------------------
 4. CONFIRM YOU ARE ON VERSION 2.4.0
--------------------------------------------------------------------

Open the app and look at the top-right of the header, next to the
Sirius XD logo. It shows the version, for example:

      v2.4.0

If it still shows an older number, you have opened the old copy.
Check which folder your shortcut points at.


--------------------------------------------------------------------
 WARNING 1 - DO NOT RUN THE APP FROM INSIDE THE ZIP
--------------------------------------------------------------------

If you double-click the ZIP, Windows shows you the contents as if it
were a normal folder. If you run the app from that view, Windows is
actually running it from a temporary read-only copy.

The app will behave strangely, may fail to save your session, and
will appear to "forget" things.

Always use "Extract All..." first, then open the app from the
extracted folder.


--------------------------------------------------------------------
 WARNING 2 - DO NOT KEEP TWO VERSIONS OPEN AT THE SAME TIME
--------------------------------------------------------------------

Two copies of the app share the same saved login and the same
queue of time waiting to upload. Running an old version and a new
version at the same time can cause tracked time to be recorded
incorrectly.

Only ever have ONE copy of Sirius XD HR Systems open. After
updating, delete the old folder so it cannot be opened by mistake.


--------------------------------------------------------------------
 5. IF SOMETHING GOES WRONG
--------------------------------------------------------------------

Please report these rather than working around them - especially
anything involving your tracked hours.

  * You cannot sign in
  * A project or task you expect is missing from the dropdown
  * Your timer stopped on its own, or time you tracked is missing
  * The app will not open, or closes straight after opening

Contact your manager or HR, or email:

      admin@siriusxd.com

When you report a problem, please include:

  * the version shown in the app (for example v2.4.0)
  * what you were doing at the time
  * the date and rough time it happened

Do not delete or reinstall the app before reporting missing time.
Time waiting to upload is stored on your machine and can usually be
recovered - but only if the app is left alone.

====================================================================
