The Codabox SyncTool is a synchronization tool that allows you to collect files from Codabox via a safe connection and save them locally.


★ Your usage of this application is subject to the terms of the agreement that your company has entered
into with Codabox for the use of Codabox products (CODA/SODA/CARO/VOILA/…)


INSTALLATION OR UPDATE


Download iconFollow the instructions below to download the software, for Windows or Mac.
Then follow the instructions on 'Add a connection'.


Admin rights: You must have local administrator rights to install the SyncTool on your device (if you have any doubts about this, contact your IT administrator).


IMPORTANT: Automatic file synchronization
The computer on which you installed the Codabox SyncTool must be powered on.
If this is not the case, the automatic file synchronization cannot happen.



Windows icon

Download and install the Codabox syncTool for Windows
  1. Click this link and download the 'Codabox-SyncTool-1.3.0.Setup.exe' file.
    Preferred browsers: Chrome & Firefox.
  2. Double click the .exe file.
    The application will install.
    SyncTool is installing
    After installation, the software launches automatically.

Apple icon

Download and install the Codabox SyncTool for Mac
  1. Click this link and wait for the download to complete.
  2. Go to your downloads and unzip the file.
  3. Move the Codabox-SyncTool.app file from your 'Downloads' to your 'Applications'.
    Move the file to 'Applications'
  4. Click the Codabox-SyncTool.app file in your 'Applications'.
    The application will install.
    SyncTool is installing
    After installation, the software launches automatically.

Update icon

New version update
When a new version becomes available, you will see a notification in the SyncTool. New version of the SyncTool available
Click the Download button on the notification or use the above links to install the new version for Windows or Mac.


The software takes on the language of your Operating System. If necessary, you can change the language (after installation) via the settings.


OPENING AND CLOSING OF THE SOFTWARE


Opening the software
You can open the software via
  1. the shortcut on the Desktop or 
  2. the Windows Start menu or 
  3. the notification area of the Windows taskbar (to the left of the clock).

Open Codabox SyncTool


Open Codabox SyncToolOpen Codabox SyncTool


Closing the software

You can close the software via:

  • the menu: Actions > Quit application
  • the system tray of the Windows taskbar: right-click on the icon of the Codabox SyncTool and select 'Quit application'

You can also minimize the software to continue to run in the background and automatically download files when new ones are available. This can be done by clicking the 'x' at the top right of the application. Once minimized, you can open the application again by clicking on the icon in the system tray.


The menus


CONFIGURATION


Add a connection: Run as Application or Run as Windows Task

Add new connection button

  1. Click the Add new connection button in the main window.
  2. Choose how you want the connection to work: this depends on whether you have installed the SyncTool on a server or a personal device:

    Run as Application
    Run as Windows Task
    Best for which device?SyncTool installed on a personal desktop
    SyncTool installed on a server
    Who can create the connection?
    Any logged-in user
    Only Admin user
    Note: you will need to close the application, right-click the icon and choose Run as Administrator, before you set up the new connection. This is a once-only action.
    Run as Administrator
    How does the connection and synchronization work?The connection will be dependent on the logged-in user. The connection will start and synchronize when the user logs in.

    Important: The connection will NOT run when the user is logged out.
    The connection will run and synchronize continuously in the background, independent from any active user sessions.

    Important: The connection will NOT run if the device is switched off.

    If the Synctool is installed on a personal device that will be switched off regularly, it is not a good idea to run a connection as a Windows Task!
    Choose connection type
  3. Choose the type of connection that applies to your situation:
    Type of connection
    1. Are you completing the activation through MyCodabox? Then maintain the selected option 'Activation code' and click Next.
      In the next screen, enter the activation code: via email you received instructions to generate this code in MyCodabox via Administration > SyncTool connections.
    2. Did you not arrive on this page via MyCodabox and do/did you already have a SyncTool configured with username and password? Then choose the option 'Username/Password' and click Next.
      In the next screen, enter the username and password you received from our helpdesk in the past. If you no longer have these details, please contact helpdesk@codabox.com.
      ★ Note: if you have chosen the execution type 'Run as Windows Task', the connection cannot be made with a username/password but requires an activation code.
  4. Choose the folder in which you want to download the files.
    Download location
  5. Click Next. The saved connection will appear in the main window:
    New connection created


Edit a connection

Edit connection icon

In case you made a mistake entering the details, or you want to change the destination folder for the downloads, you can click the Edit connection icon (next to the connection you want to change).Edit SyncTool connection

A window will appear with the data already entered, so that you can easily adjust it. When you're done, click Confirm.


Delete a connection
Delete connection icon
You can also delete an existing connection by clicking the Delete connection icon. After an additional confirmation, this connection is removed.Delete a SyncTool connection


ATTENTION! 

The files you already downloaded locally will not be deleted if you remove the connection in the Codabox SyncTool. If you also want to remove them, you will have to do it manually on your computer.


Download files

Download files icon

Once the connection is established, the Codabox SyncTool will check every 2 hours if new files are available, and also download them in the specified folder.


You can also check and download files at any time, if they are available on the server. Click the Download files icon.Download files from SyncTool


Browse the download folder
Browse downloads icon
The download folder can be accessed via the folder icon.Browse the downloaded files


Consult logs: in case of synchronization issues
Have you noticed a synchronization issue? Consult the logs.
The logs are organized by date/connection and can contain very useful information about what happened. They are available in the window displaying your connections, via the Show logs button: Show logs SyncTool


More info about file delivery in our article 'Where are all Codabox files delivered via the synchronization app?'



Questions or issues? Please contact Helpdesk, we will be happy to assist you!