Skip to main content
The Dropbox Importer for Dust is a powerful tool designed to seamlessly integrate your Dropbox files with Dust’s AI-powered knowledge management platform. 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 comprehensive 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
    • Robust error handling
    • Extension-based filtering options
      By leveraging this script, teams can effortlessly keep their Dust knowledge base synchronized with their Dropbox content. This integration enables more effective use of Dust’s AI capabilities for document analysis, content discovery, and knowledge management. The script is designed with scalability in mind, ensuring reliable performance even with large volumes of Dropbox files.

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 designed to handle enterprise-scale document synchronization needs while maintaining data integrity and performance.