Export Your Data

Wherever you look at your data in Rostoc, there’s a way to take it with you — your whole account, a single roast, or an inventory snapshot built for handing to someone outside Rostoc.

Export your whole account

Go to Settings, and under Your data click Export all my data.

This downloads a single ZIP file with everything Rostoc holds for your account:

Every roast batch and its full curve — every recorded channel with its label, unit and role, plus milestones and any control changes you made during the roast
Your green coffee — coffee lines and lots
Your plans
Your machines

It’s free on every plan, with no limit on how far back it goes — this is your data, and leaving shouldn’t cost anything.

For a large account, preparing the file can take a minute. You’ll see a status message while it works, and you can leave the page and come back — Rostoc keeps preparing it in the background. When it’s ready, a Download button appears showing the file size and a summary of what’s inside. The prepared file stays available for a week; after that, request a new one.

Curves come in two formats inside the ZIP: a CSV for opening straight in a spreadsheet, and a JSON version that keeps each channel’s unit and role attached to the numbers, for anyone building something with the data. Each curve’s CSV opens with the same roast record as a single-roast export, described below, so a file still says which roast it is once it leaves the ZIP.

The ZIP’s batches.csv lists every roast on one sheet. Its duration is the roast’s, from Charge to Drop, and it is empty when either mark is missing; the full recording length sits beside it, since a recording can run past Drop.

Export a single roast

Open any batch’s detail page, open the … menu at the right end of the page header, and choose Export as CSV, Export as JSON or Export as .alog.

This downloads immediately — there’s no wait, even for a long roast. Use it when you need one roast only: to check something in a spreadsheet, or to hand a single result to someone without sending your whole account.

The file is named after the roast, so a folder of exports reads the way your batch list does.

What the CSV holds

The CSV opens with the roast’s record, one item per row, with the name in the first column and the value in the second:

Batch code and roast name, and when the roast started (in UTC)
Machine, Roasting Plan, green coffee and Lot
Roaster name
Input weight, output weight and weight loss
Colour reading and colour scale
Roast duration, from Charge to Drop
Charge temperature, turning point, dry end, first crack and second crack, drop temperature, development time and DTR
Your notes

A blank row follows, then the curve itself: one column per channel your machine recorded, each headed with its unit, and one row per reading.

Every record row is there even when you haven’t filled it in, so the curve always starts on the same line and two exports line up row for row. Weights in the record are in grams and its temperatures in °C, whatever units you work in.

Milestone times in the record count from Charge, the way the batch page shows them. The curve’s Time column counts from when recording started, so the record also gives Charge at Time (s): where Charge falls in that column.

What only the JSON holds

The JSON carries the same record and curve, plus the roast’s milestones, any control changes you made and your timed comments, all on one timeline. Control changes and comments aren’t in the CSV: they happened between readings, so the curve has no row for them.

What the .alog file holds

An .alog file is a roast file that profile-design tools import, such as Loring’s Roast Architect (File > Import). Use it to start a new roast profile from a roast you recorded in Rostoc.

It holds less than the other two: the bean and environment temperatures, the milestones (Charge, dry end, first crack, second crack, Drop, and the turning point), the roast’s name, green coffee, notes and roaster name, and the input and output weights in grams. Its temperatures stay in the unit your machine recorded, °C or °F. Other channels, control changes and comments stay in the JSON.

A roast with no bean temperature recorded can’t be exported this way.

Export an inventory snapshot

Open the Inventory Dashboard, open the … menu at the right end of the page header, then Download snapshot….

This one is different — not your data to take with you, but a report built for handing to someone outside Rostoc: an accountant closing the month, an insurer, a lender. It shows stock and value per coffee line, with no lot-level detail.

By default it downloads as of today. Pick an earlier date in the dialog instead to get stock and value as they stood at the end of that day — useful for closing last month’s books after the month has already turned over. If your coffee is priced in more than one currency, the file keeps each currency’s total separate rather than adding them together.