Skip to main content
This guide walks through Hoard Desktop from download to first sync. It is written for people who do not want to use the command line and do not need to understand the technical details. Hoard Desktop opens TCGplayer in its own controlled browser, downloads your inventory and order reports, sends them to Hoard, and can upload price updates back to TCGplayer.
During a sync, let Hoard’s browser windows do their work. Do not close them. Do not click around in them. Do not minimize them while a step is running. Closing a browser window will usually make the sync fail, and minimizing a browser window mid-step can make the browser stop responding.

​
Before you start

You need:
  • A Hoard account
  • A TCGplayer seller account
  • The computer you use for Hoard Desktop to stay awake while syncing
You do not need to install a separate browser extension. Hoard Desktop handles everything for you.

​
1. Download Hoard Desktop

Go to the Hoard downloads or setup page and download the Hoard Desktop app for your computer. Use the file that matches your computer:
If you are not sure which Mac you have, click the Apple menu, then About This Mac. If it says Apple M1, M2, M3, or M4, use the Apple Silicon download.

​
2. Open Hoard Desktop

Open the file you downloaded.
Mac only: macOS blocks apps not from the App Store. You will see a message saying the file “cannot be opened because the developer cannot be verified.”To get past this: right-click (or Control-click) the downloaded file, choose Open, then click Open again in the dialog that appears. You only need to do this once.If you prefer the terminal:
You can also go to System Settings → Privacy & Security and click Allow Anyway after the first blocked attempt.
On Windows, Hoard may open in a small terminal-looking window. That is normal.
Hoard Desktop terminal window showing the app has started and is updating itself
This window means Hoard Desktop is running. It may say things like:
  • Hoard Desktop v...
  • Hoard is running in your tray
  • Update available
  • Updated to v...
You do not need to type anything in this window.
Do not close this window unless you mean to quit Hoard Desktop. If you close Hoard Desktop, syncs stop.

​
3. Find the Hoard icon

Hoard Desktop runs in your tray or menu bar. On Windows, the icon may be inside the small up-arrow menu near the clock.
Windows tray showing the Hoard icon
Hovering over the icon shows whether Hoard is running and what local port it is using.
Windows taskbar preview showing Hoard is running

​
4. Open the Hoard tray menu

Click the Hoard icon to open the menu.
Hoard tray menu with Open Agent, Settings, Open Hoard Dashboard, Launch at Login, Restart Desktop Client, Check for Updates, and Quit
The most important items are: Click Open Agent.

​
5. Understand the Hoard Agent page

The Hoard Agent page opens in your normal browser at an address like 127.0.0.1:1993. This page is local to your computer.
Hoard Agent local page showing running status, session ok, and logs
At the top you will see a status bar.
Hoard Agent status bar with running state, pid, uptime, last sync, session, version, and action buttons
Here is what each part means: The buttons on the right are:
Seeing Waiting - no sync needed right now in the logs is normal. It means Hoard is healthy and the server has not asked it to sync at that moment.

​
6. Start your first sync

On the Hoard Agent page, click Sync Now. The button may briefly say Requesting... and then Requested!. That means Hoard has received the request. It may take a short moment to start the actual sync. Once it starts, the logs will move quickly. You may see lines for inventory, orders, sales reports, pricing, and uploads.
After you click Sync Now, do not repeatedly press it. One request is enough. Wait for the current sync to finish.

​
7. Log into Hoard’s TCGplayer browser

The first time Hoard needs TCGplayer, it opens a special browser window. This browser belongs to Hoard. It may look different from your usual Chrome browser. It may show a message at the top saying Chrome is being controlled by automation, or it may not have the normal search/address bar you are used to.
TCGplayer browser window showing an automation controlled browser banner
Use only this Hoard browser to log into TCGplayer.
  1. Click inside the TCGplayer login page that Hoard opened.
  2. Log in with your TCGplayer seller account.
  3. Complete any CAPTCHA, two-factor check, or security prompt if TCGplayer shows one.
  4. Leave the browser open after you log in.
Do not log into TCGplayer in your regular browser for this step. Hoard needs the login inside the browser it opened. Logging in somewhere else does not give Hoard access.

​
8. Leave Hoard’s browsers alone during sync

During the sync, Hoard may open additional TCGplayer windows or tabs for different steps.
Two TCGplayer browser windows open while Hoard runs sync steps
This is normal. For example, Hoard may use different pages for:
  • Checking that you are logged in
  • Exporting inventory
  • Exporting orders
  • Exporting sales reports
  • Uploading price updates
The windows may move, change pages, download files, or sit still for a while. Let them work. Do not:
  • Close the windows
  • Minimize the windows while a step is running
  • Click buttons in TCGplayer unless Hoard is waiting for you to log in or complete a security check
  • Use Hoard’s browser for normal browsing
  • Type in Hoard’s browser after the login is done
If you need to keep working, use a different browser window that you opened yourself. Leave Hoard’s windows visible and untouched until the sync finishes.

​
9. Watch for a successful finish

When the sync finishes, the log shows a success line.
Hoard Agent log showing Done success and waiting for the next sync
You may see:
  • Done (success)
  • Waiting - no sync needed right now
That means the current sync is finished and Hoard is waiting for the next scheduled sync or manual Sync Now request.

​
10. Check the Hoard dashboard

Open your normal Hoard dashboard from either:
  • The tray menu: Open Hoard Dashboard
  • The Hoard Agent page: Dashboard
  • Your browser: tryhoard.com
After a successful sync, your dashboard should show updated inventory, prices, orders, and sync activity. For a guided tour of the dashboard after syncing, read Your first sync - what just happened.

​
What Hoard does during a sync

A full sync can include several steps:
  1. Check that the TCGplayer session is still logged in.
  2. Export your current TCGplayer inventory.
  3. Upload that inventory to Hoard.
  4. Export recent orders.
  5. Upload orders to Hoard.
  6. Export sales or payment reports.
  7. Run Hoard pricing rules.
  8. Download price updates from the server.
  9. Upload the price updates to TCGplayer.
Some steps may open a new browser page. Some steps may take longer than others. This is normal.

​
Review Mode and Full Sync

Some accounts run in Review Mode first. In Review Mode, Hoard can generate price update CSVs without automatically pushing them every time. The Agent page may show a REVIEW MODE badge and a list of recent exports. If price updates are ready, you may see buttons like: If your account is already in Full Sync, you may not see the Review Mode badge. In Full Sync, Hoard can export, price, and upload updates as part of the normal sync flow.

​
What to do if something goes wrong

​
Hoard’s browser closed

Go back to the Hoard Agent page and click Restart. Then click Sync Now again after Hoard is running.

​
The log says login failed

The TCGplayer session probably expired or the login was not completed in Hoard’s browser. Click Restart, then Sync Now, and log into TCGplayer in the browser that Hoard opens.

​
The page says stopped

Click Start. If it stops again, click Restart Desktop Client from the tray menu.

​
The page says error

Click Restart. If it returns to error, open the Logs page and look at the last few lines. The error usually says whether it is a login problem, internet problem, or browser problem.

​
The log says waiting

This is usually fine. Waiting - no sync needed right now means Hoard is connected and waiting for the server to ask it to sync.

​
The TCGplayer browser asks for a CAPTCHA or security check

Complete it in Hoard’s browser. After you finish, stop touching the browser and let Hoard continue.

​
Safe habits

  • Leave Hoard Desktop running while you want syncs to happen.
  • Keep Launch at Login checked if this computer should sync automatically.
  • Let Hoard’s TCGplayer windows stay open and visible while a sync is running.
  • Use Open Agent to check status instead of guessing.
  • Use Restart before trying anything complicated.
  • Use your normal browser for your own work, and leave Hoard’s browser for Hoard.

​
When you are done for the day

If you want Hoard to keep syncing later, leave Hoard Desktop running. If you quit Hoard Desktop, scheduled syncs will not run until you open it again. Nothing is deleted, but Hoard cannot sync while it is off.