Export¶
Export your print data for analysis, reporting, or backup purposes.
Export Options¶
Export Formats¶
| Format | Extension | Best For |
|---|---|---|
| CSV | .csv | Spreadsheets, data analysis, importing |
| Excel | .xlsx | Reports, formatting, charts |
Archive Export¶
Export your print archive data:
How to Export¶
- Go to Archives page
- Apply any desired filters
- Click Export button
- Choose format (CSV or Excel)
- Download begins
Exported Fields¶
| Field | Description |
|---|---|
| Name | Print name |
| Filename | Original 3MF filename |
| Printer | Which printer completed it |
| Date | Completion date/time |
| Duration | Print time |
| Result | Success/Failed/Stopped |
| Filament Type | Material used |
| Filament Used | Grams consumed |
| Filament Cost | Cost of material |
| Energy | Wh consumed (if tracked) |
| Energy Cost | Electricity cost |
| Total Cost | Filament + energy |
| Tags | Assigned tags |
| Project | Assigned project |
| Designer | Model designer |
| Notes | Archive notes |
Filter-Aware Export¶
Export respects your current filters:
- Printer filter - Only selected printer
- Date range - Only within range
- Status filter - Only selected status
- Project filter - Only in project
- Search query - Only matching results
Statistics Export¶
Export statistics data:
How to Export¶
- Go to Statistics page
- Set your time range and filters
- Click Export button
- Choose format
- Download begins
Exported Data¶
| Data | Description |
|---|---|
| Summary stats | Total prints, success rate, etc. |
| Per-printer stats | Breakdown by printer |
| Material usage | Filament consumption |
| Cost breakdown | By printer, material |
| Time analysis | Duration statistics |
| Daily/weekly counts | Activity over time |
Export Settings¶
Date Format¶
Dates are exported in ISO 8601 format:
Number Format¶
- Decimals use period (.)
- No thousands separator
- Suitable for most spreadsheets
Text Encoding¶
- UTF-8 encoding
- Handles international characters
- Compatible with all modern software
Working with Excel¶
Opening CSV in Excel¶
- Open Excel
- Go to Data > From Text/CSV
- Select the downloaded file
- Choose UTF-8 encoding
- Click Load
Direct Open May Fail
Double-clicking CSV files may cause encoding issues. Use the import method above.
Creating Charts¶
- Select your data
- Go to Insert > Charts
- Choose chart type
- Customize as needed
Working with Google Sheets¶
Importing CSV¶
- Open Google Sheets
- Go to File > Import
- Upload the CSV file
- Choose Replace spreadsheet or Insert new sheet
- Click Import data
Direct Link (Advanced)¶
If you host Bambuddy publicly, you can link directly to export URLs.
API Export¶
Export via the REST API:
Archive Export¶
Parameters¶
| Parameter | Description |
|---|---|
format | csv or xlsx |
printer_id | Filter by printer |
status | Filter by status |
start_date | Filter start |
end_date | Filter end |
search | Search query |
Example¶
curl -H "X-API-Key: your-key" \
"http://localhost:8000/api/v1/archives/export?format=csv&status=success" \
-o archives.csv
Scheduled Exports¶
For regular exports, set up a cron job:
# Weekly export every Sunday at midnight
0 0 * * 0 curl -H "X-API-Key: your-key" \
"http://localhost:8000/api/v1/archives/export?format=csv" \
-o "/backup/archives_$(date +\%Y\%m\%d).csv"
Backup Use¶
Export can serve as a partial backup:
What Export Captures¶
- Print metadata
- Statistics
- Tags and notes
What Export Doesn't Capture¶
- 3MF files
- Thumbnails
- Settings
- Notification configs
For full backups, use the Backup & Restore feature.
Tips¶
Regular Exports
Export monthly for record keeping, even if you have database backups.
Filter First
Apply filters before exporting to get exactly the data you need.
Version Control
Include dates in export filenames to track versions.
External Analysis
Export to CSV for analysis in Python, R, or other tools.
Reporting
Use Excel format for formatted reports with charts and branding.