Skip to main content

OneDrive Sync

Key Concepts​

The OneDrive addon watches a folder in your OneDrive and keeps it in sync with your Printago Parts library. Drop a new .stl, .3mf, or .gcode file into the watched folder, and Printago imports it as a Part on the next sync, no manual upload required. Edit a file in place and Printago updates the matching Part's file for you. This is a good fit if your team already stores print files in OneDrive and wants those files to show up in Printago automatically instead of being uploaded one at a time.

Both kinds of Microsoft account work: a personal Microsoft account and a work or school account signed in to Microsoft 365.

Getting Started​

1. Activate the Addon​

Go to Addons, find OneDrive, and click Activate.

2. Connect Your Account​

Click Connect OneDrive. You'll be sent to Microsoft to sign in and approve read-only access. Printago never sees your password, and you can revoke access at any time from your Microsoft account settings.

Once you're connected, the page splits into three tabs: Connection (the account and the folder you're watching), Files (everything that has synced), and Settings.

If you come back here often, click the pin icon on the OneDrive card on the Addons page to add a OneDrive shortcut to the Add-Ons menu in the sidebar. See Addons Overview.

3. Pick a Folder to Watch​

On the Connection tab, click Select folder to browse your account. Click a folder name to open it and see what's inside, or click Select next to a folder to choose it. You can only watch one folder per connected account, but that folder can contain as many subfolders and files as you like; everything inside it is synced.

Subfolders are mirrored as Part folders in Printago, so a file in Prototypes/Brackets lands in a Brackets folder inside Prototypes. Files sitting directly in the watched folder go to the top level of your Parts. Move a file to a different folder in OneDrive and the next sync moves its Part to match, without re-downloading it. Folders more than eight levels below the watched folder are skipped, since that is Printago's own folder depth limit.

4. Sync​

Click Sync Now to sync immediately, or leave Sync automatically turned on under Settings (the default) so Printago checks the folder for changes about once an hour on its own. A sync runs in the background, so you can keep working while it finishes; the page shows a Syncing badge and updates the file list live as files come in.

5. Watch the Files Tab​

The Files tab lists everything Printago has synced from the watched folder, with the tab itself showing the total. Each filename links to the Part it created, so you can jump straight from a file to what it became.

A busy folder can hold thousands of files, so the list is built for that: it shows fifty at a time with page controls at the bottom, and a row of counts at the top tells you how many files are synced, pending, errored, or no longer in sync. Click any of those counts to see just those files. You can also search by filename or folder, or narrow to a single folder with the folder picker. Anything that failed to import shows the reason right on its row.

What Syncs​

Printago only imports files it knows how to use for printing:

  • .stl files become STL Parts
  • .3mf files become 3MF Parts
  • .gcode files become G-code Parts
  • .gcode.3mf files become sliced G-code bundle Parts

Every other file type in the watched folder is ignored.

How Updates and Deletes Are Handled​

  • New file in the watched folder: a new Part is created in Printago. A .3mf Part keeps the process profile saved in the file, the same as one you upload yourself. A 3MF with no saved profile in it — plain geometry exported from CAD — is sliced with the printer's profile.
  • Changed file (you re-save or replace it in the cloud): the matching Part's file is updated the next time Printago syncs.
  • Deleted file (removed from the cloud folder): by default, Printago just marks that file as no longer synced. The Part it created stays in Printago untouched, since a print file disappearing from a shared drive shouldn't silently delete something you're using.

If you want deletions to actually delete the Part too, turn on Delete parts removed from OneDrive on the Settings tab. This is off by default; turn it on only if you're sure you want cloud-side deletes to remove Parts in Printago.

Reconnecting​

If Microsoft revokes Printago's access (for example, if a password changes or the connection is manually removed on their end), the addon shows a Needs reconnect badge and pauses syncing until you reconnect. Click Reconnect and approve access again; your watched folder and sync history are preserved.

Disconnecting​

Click Disconnect on the Connection tab to stop syncing and remove the connected account. Parts already imported into Printago stay exactly as they are; disconnecting only stops future syncing.