Support · Data Collection

CC Sync Quick Start

Get up and running with CC Sync - log in, create your first upload task, and let it move measurement files to ChromaChecker automatically.

CC Sync Quick Start

A first-time tour of CC Sync - the desktop app that watches a folder and uploads your measurement files to ChromaChecker automatically.

Overview

CC Sync is a desktop app that watches a folder on your computer (or a network share) and automatically uploads matching measurement files to your ChromaChecker account - no manual upload step. You set up a task once, and it keeps your data flowing in the background.

CC Sync is the successor to CC Uploader. If you used CC Uploader, you can import your old tasks (see Managing your tasks).

1

Install & log in

2

Create a task (watch a folder)

3

Files upload automatically

4

Review results in the Dashboard

Concept · What's a task? A task is one watched folder plus the rules for which files to grab, how to rename them, and where on ChromaChecker they should go.

Before you begin

You need two things to get started:

  • A ChromaChecker account.
  • The CC Sync installer for Windows.
Download CC Sync for Windows (0.2.14)
Windows installer (.exe). Run it and follow the prompts.
Concept · You'll need a ChromaChecker account Don't have one yet? Get a ChromaChecker account first - your CC Sync login is the same account.

Logging in

The first time you launch CC Sync you'll accept the End User License Agreement (EULA), then you'll be asked whether to use secure storage to save your credentials for automatic login.

Tip · Secure storage on first launch We recommend accepting secure storage in the vast majority of cases - it keeps your credentials encrypted by your operating system so CC Sync can remember them between launches. You can opt out, and change the decision anytime later in Preferences → Security.

Next you'll see the Login window with two tabs. Pick a login method, fill in the fields, and click Login. On success, CC Sync briefly shows your subscription details and the window closes itself.

  • Operator Auth (recommended) - enter your Organization, Username, and Password.
  • SOAP Auth (Legacy) - enter your SOAP Username, SOAP Password, and an optional Custom Instance. SOAP credentials come from chromachecker.com/dashboard/en/soap.

If your network uses a proxy, expand + Advanced Settings to enter it.

Operator Auth (recommended)
CC Sync Login window — Operator Auth tab with Organization, Username and Password fields 1 2 3
  1. 1 Choose your login method - Operator Auth (here) or SOAP Auth (Legacy).
  2. 2 Your ChromaChecker account: Organization, Username, Password.
  3. 3 Click Login - the window closes itself on success.
SOAP Auth (Legacy)
CC Sync Login window — SOAP Auth (Legacy) tab with SOAP Username, SOAP Password and Custom Instance fields 1 2
  1. 1 Legacy SOAP credentials from chromachecker.com/dashboard/en/soap.
  2. 2 Custom Instance - optional, only for a custom ChromaChecker instance.
Warning · Use Operator Auth - SOAP is being retired SOAP Auth is legacy and will be removed in a future release. New setups should use Operator Auth with a ChromaChecker account. Only use SOAP if you're on an older configuration that still requires it.
Concept · Your role is assigned for you Your role - and the credentials and permissions that come with it - is assigned in Accountability Inspector by your account's admin. As an operator you don't choose your own role; if your login doesn't work or you need different access, contact your administrator.

The Task Panel

After you log in, the Task Panel is your home window. It lists your tasks and gives you everything you need from the menu bar and the bottom toolbar.

CC Sync Task Panel main window showing the menu bar, task list with status icons, the New Task button, and the bottom toolbar 1 2 3 4 5
  1. 1 Menu bar - App, Tasks, Tools, Help (described below).
  2. 2 Status icon - running, paused, or needs attention.
  3. 3 Task Control - pause/resume, edit, or delete a task.
  4. 4 New Task button - create a task (opens the wizard).
  5. 5 Bottom toolbar - quick access to the Task List, Dashboard, Preferences, and Plugins.
Concept · Task states A green check means the task is running and watching its folder. A paused task is stopped until you resume it (no uploads). A warning state means it needs attention - often a lost folder or connection.

The menu bar

  • App - app-wide settings and your account, like opening Preferences or switching account (Change Account).
  • Tasks - everything for managing tasks, like creating a New Task or importing/exporting your task list.
  • Tools - actions added by plugins (for example, RHT Sensor when that plugin is installed).
  • Help - support and info tools, like running Diagnostics or opening the Troubleshooting Guide.

Creating your first task

Click the New Task button (or Tasks → New Task…) to open the Task Wizard. It walks you through a few steps; each one is checked before you can continue.

Step 1 - Task Name

Task Wizard — Task Name page with Name and Description fields 1 2
  1. 1 A unique name - usually related to the press, device, or project this task is set up for.
  2. 2 An optional description for your own reference.

Step 2 - Input Folder

This is the folder CC Sync watches. Choose Local (a folder on this PC) or Network (a shared folder), and decide what happens to each file once it's been uploaded.

Local folder
Task Wizard — Input Folder page, Local tab 1 2 3 4
  1. 1 Local / Network tabs.
  2. 2 Pick the folder to watch (the magnifier opens it to check).
  3. 3 After file is processed - move or copy it to the Archive folder, or delete it.
  4. 4 Scan existing files - also process files already in the folder.
Network share
Task Wizard — Input Folder page, Network tab with path, username and password 1 2
  1. 1 The network folder path (UNC).
  2. 2 Username and Password for the share.
Concept · Why network folders need credentials If your measurements land on a shared drive, CC Sync stores the share's credentials so it can silently re-mount the folder after a network hiccup - no babysitting required.

Step 3 - Archive Folder

The Archive Folder is where processed files are moved or copied. This page works just like the Input Folder page - the same Local / Network tabs and folder picker - so it'll feel familiar. It only appears if you chose to move or copy files on the previous step; if you chose to delete them, the wizard skips it. When it does appear, the folder is required.

Task Wizard — Archive Folder page with Local/Network tabs and folder picker
Tip · Input and Archive can be the same folder You can point the Archive folder at the same folder as the Input. CC Sync then processes a measurement, saves a renamed copy back into that same folder, and uploads it - handy when you want the processed copy to live right alongside the originals.

Step 4 - File Recognition

Not every file in a folder is relevant to every task. File Recognition makes sure CC Sync only picks up the ones you mean - by file type, and optionally by filename.

Task Wizard — File Recognition page with file extension radios and a name filter 1 2 3
  1. 1 Accepted file extensions - match your instrument's output.
  2. 2 Other - type a custom extension if yours isn't listed.
  3. 3 Accept file names - narrow further by filename (all / contains text / regex).

Step 5 - File Naming

Renaming files on the way out keeps your uploads organized and traceable. These options are optional, and the live preview shows exactly how each file will be named.

Task Wizard — File Naming page with a live filename preview and rename options 1 2
  1. 1 A live filename preview (original → modified) updates as you change the options.
  2. 2 Add a date or serial number suffix, a prefix, or fully rename the file.

Step 6 - Destination

Finally, tell CC Sync where the data should land on ChromaChecker by picking the tab that matches your setup: Auto Recognition lets the server route the file by its contents; Specific Track sends it to a device and track you've already set up; Project routes it by buyer → project → device; and Color Library imports color files (CxF/MxF/QTX) into a named library. Detailed setup of these lives in the ChromaChecker docs - for the quick start, just pick what matches your workflow.

Task Wizard — Destination page with Auto Recognition, Specific Track, Project and Color Library tabs 1 2
  1. 1 The destination tabs - choose how files are routed.
  2. 2 For Specific Track: pick the device and its track.

Step 7 - Task summary

The final page summarizes every choice you made. Review it - and if something needs changing, click any group box to jump straight back into quick-edit for that step. When everything looks right, click Create Task; it's added to your list and starts watching right away.

Task Wizard — Task summary page with grouped settings and a Create Task button

Managing your tasks

Back on the Task Panel, you manage tasks day to day:

  • Pause / resume, edit, or delete a task from its row (or double-click a row to open it).
  • Import… / Export… (Tasks menu) to back up your task setups or move them to another machine.
  • Import Legacy Tasks… to bring over your tasks from CC Uploader.
Tip · Moving from CC Uploader Use Tasks → Import Legacy Tasks… to convert your old CC Uploader task list. Destinations are re-matched to your current ChromaChecker setup; anything that can't be matched is flagged so you can fix it.
Task Panel rows with per-task pause/resume, edit, and delete controls 1 2 3
  1. 1 Pause / resume a task without removing it.
  2. 2 Edit a task (or double-click its row to open it).
  3. 3 Delete a task you no longer need.

The CC Dashboard

CC Sync has the ChromaChecker dashboard built in. Switch to the WebViewer from the bottom toolbar to open the CC Dashboard. It signs you in automatically, so you can review the data your tasks uploaded without opening a browser.

CC Dashboard embedded inside CC Sync, showing a ChromaChecker Inspector
Warning · Legacy (SOAP) users If you signed in with SOAP Auth (Legacy), the first time you open the CC Dashboard you'll be asked to provide your ChromaChecker credentials for the dashboard view. Operator Auth users are signed in automatically.

Preferences

Open Preferences from the App menu (or the crossed hammer-and-wrench icon on the toolbar) to adjust how CC Sync behaves.

CC Sync Preferences window with CC Dashboard Role, Security, Language, and Plugins / Change Account buttons 1 2 3 4
  1. 1 CC Dashboard Role - which role the built-in Dashboard signs in as. Only shown when it applies to your account (for example, manager-capable accounts).
  2. 2 Security - passwords stored in the OS keychain; toggle auto-login or clear saved passwords.
  3. 3 Language - change the interface language anytime.
  4. 4 Plugins… / Change Account… - open the Plugin Manager, or switch accounts.
Tip · Auto-login When enabled, Auto-login submits your saved credentials for you instead of showing the login form each launch. It's off by default - turn it on for your own machine, and leave it off on shared ones.

Admin Lock

Admin Lock (Tasks → Admin Lock) lets an administrator lock task editing so operators can't add, edit, or remove tasks. The first time you open it, if no admin credentials exist yet, CC Sync asks whether you'd like to set them up - choose Yes to create an admin login and password, and the Admin Lock window opens. After that, changing the lock requires that admin login and password, and the state persists across restarts.

Unlocked - editing allowed
Admin Lock window in the unlocked state with a green padlock 1 2 3
  1. 1 Green padlock - editing is unlocked (default).
  2. 2 Enter the admin login and password.
  3. 3 Press Lock Editing to protect the configuration.
Locked - editing blocked
Admin Lock window in the locked state with a red padlock 1 2 3
  1. 1 Red padlock - editing is locked; operators can't change tasks.
  2. 2 Enter the admin login and password.
  3. 3 Then press Unlock Editing - the lock state only changes once you click the button.

To change the admin login or password, enter the current admin credentials, then use Edit Credentials.

Concept · Who is this for? Admin Lock is for sites where a manager or IT sets up the tasks and operators should only run them - not reconfigure them. When locked, New Task, Edit, Remove (and Import Legacy Tasks and plugin actions) are blocked with a message.

CC Plugins

Plugins add optional features. Open the Plugin Manager from App → Plugins… (or Preferences → Plugins). Plugins on the left are Installed; plugins on the right are Available - the column a plugin is in is its state.

Plugin Manager with an Installed column (RHT Sensor) and an Available column (File Routing) 1 2 3 4
  1. 1 Installed - your active plugins (here, RHT Sensor).
  2. 2 The Enabled toggle turns a plugin's feature on or off without uninstalling. Each card also has Docs and Setup buttons and an arrow to uninstall.
  3. 3 Available - plugins you can add (here, File Routing).
  4. 4 Click + to install - it activates and opens its Setup.
Tip · Do I need plugins? No - CC Sync works fully without them. Add one only if you need its feature, such as logging room temperature and humidity (RHT Sensor) alongside your measurements.

Running in the background

CC Sync is built to keep running quietly. Clicking the window's X minimizes it to the system tray - it does not quit, and your tasks keep uploading. Look for the CC Sync icon in the tray (its tooltip reads “ChromaChecker Sync”); right-click it for Show (reopen the window) and Exit (fully quit).

To keep your data flowing, leave CC Sync running in the tray. Use Exit only when you really want uploads to stop - it confirms, stops your tasks, and closes the app.

Getting help

CC Sync has support tools built in, under the Help menu:

  • Run Diagnostics… - checks your environment and connection and produces a copyable report.
  • Troubleshooting Guide… - a built-in FAQ for common issues.
  • Report a Bug… / Request a Feature… / Report a Translation Issue… - send feedback from inside the app. A bug report can even be pre-filled for you after a crash.
Tip · If something looks wrong Run Diagnostics first - it often pinpoints a network, proxy, or permission issue, and you can attach the result to a bug report.

Next steps

That's the tour. Your task is running - drop measurement files into the watched folder and watch the Files Sent count climb, then open the CC Dashboard to see the results in ChromaChecker.

Peter · AI Assistant
Setting up CC Sync? Ask me about logging in, tasks, or the Dashboard.