Docs

Email / IMAP

Connect your inbox so order emails are pulled in automatically.

Use a Google app password, not your regular Gmail password (2FA must be on).

Sync

Control how often the workers poll external APIs. Changes take effect on next worker restart (or after the current interval elapses).

How often the eBay Fulfillment API is polled. Default 360 (6 hours). Lower = fresher status, more API calls.
How often the Vinted wallet (Pending £527.20) is scraped. Default 360 (6 hours) like eBay. 0 = disabled.
eBay orders in in_transit are assumed delivered after this many days if no delivery email arrives.
Gmail IDLE keepalive. Gmail drops idle after ~29 min.

API Keys

Store third-party credentials. They are saved in data.sqlitesettings and override env vars.

Used for Game/DVD photo analysis. Get one at aistudio.google.com.

Integrations

Connect marketplaces so order data stays in sync.

eBay
Sync order fulfillment status

Crosslist

Marketplace and price settings — adapted from app.crosslist.com/account/settings/marketplaces, price-markups and region. Saved to crosslist.sqlite (/api/crosslist/settings) — survives browser reset.

Marketplace visibility
Visible marketplaces appear in the Select marketplaces posting/delisting dialogs. Hidden ones are omitted.
Price markups — per platform
eBayApplied on post
Facebook
Vinted
Markups are applied to the base price per marketplace on posting. Negative values discount. Saved locally.
Region
Shipping — per platform
Facebook
Vinted
Shipping option is determined by category — set defaults here, override per listing in the editor.

Platform logs

Service Activity Log — sleep, wake and run events (last 7 days retained). Mirrors marketplace-monitor dashboard/index.html Service Activity Log. Auto-refreshes every 15s.

Loading…
wake / run_start run_done sleep error
Also visible on System health → Service Activity when you prefer a full-width view.

Danger zone

Irreversible actions. Be careful. Deleting a database cannot be undone.

Delete game database
Permanently delete all games, prices and scan history (game database)
Delete DVD database
Permanently delete all DVD/CD entries and scan history (DVD database)
Master kill switch — stop everything
Kills API (:8080), Vite dev (:9173/:9174), workers (imap/ebay/vinted), Tesseract/OCRmyPDF, frees ports & cleans /tmp/ocr-* — stays inside project, nothing global. Use before moving/deleting the folder.