Skip to main content
This script imports your Dropbox files into a Dust folder and keeps them in sync. This open-source script, available on GitHub atdust-tt/dust-labs/dropbox, automates the process of exporting your Dropbox files (including Paper docs) and importing them into a Dust datasource. It supports multiple file types and preserves file metadata, like so:
The script then formats and uploads this data to Dust, maintaining the original file structure and content integrity.

Key Features

  • Multiple File Type Support: Works with various file formats including:
    • Dropbox Paper documents (.paper)
    • Markdown files (.md)
    • Word documents (.docx)
    • Text files (.txt)
  • Metadata Preservation: Maintains important file information:
    • Original file names and IDs
    • Full file paths and folder structure
    • Creation and modification dates
    • File format details
  • Smart Processing:
    • Concurrent file processing for improved performance
    • Rate limiting to respect API constraints
    • Error handling with retries
    • Extension-based filtering options
      Run the script on a schedule to keep your Dust knowledge base synchronized with your Dropbox content. Your agents can then use the imported documents for analysis, content discovery, and knowledge management. The script handles large volumes of Dropbox files reliably.

Getting Started

  1. Prerequisites:
    • Node.js (v14 or higher)
    • npm (Node Package Manager)
    • Dropbox account with API access
    • Dust account with API access
  2. Installation:
  1. Configuration:
    Create a .env file with your credentials:
  1. Usage:
    To sync all files:
code
To sync specific file types (e.g., only Paper docs):

Best Practices

  1. Start Small: Begin with a specific file type or folder to test the integration
  2. Monitor Progress: Watch the console output for sync status and any potential issues
  3. Regular Updates: Schedule periodic syncs to keep your Dust knowledge base current
  4. Error Handling: Check logs for any failed imports and address issues promptly
The script is actively maintained and handles large-scale document synchronization while preserving data integrity.