cloudsinker 0.1.0

A powerful, command-line utility to download and mirror public Google Drive files.

# cloudsinker

[](https://opensource.org/licenses/MIT)

A powerful, command-line utility designed to reliably download and synchronize public files and folders from Google Drive.

Its purpose is to fill the gap between simple, single-file downloaders (like gdown) and the full, complex Google Drive API.

## 🚀 Core Features

* **Smart G-Workspace Export**: Automatically detects links to Google Docs, Sheets, or Slides. Instead of downloading the HTML preview, it exports them in useful formats like .pdf, .docx, or .csv.

* **Recursive Folder Mirroring**: Given a link to a public folder, it recursively crawls the entire directory and recreates the exact folder structure on your local machine.

* **Resilient Rate-Limit Handling**: Built for large-scale downloads. When it hits Google's rate limits, it automatically waits and retries using exponential backoff.

* **Metadata "Pre-Flight" Check**: A special mode that allows you to get rich information about a file (like its size, type, and name) before committing to the full download.

## 💾 Installation

You can install cloudsinker directly from PyPI:

pip install cloudsinker

## 💻 Basic Usage

Once installed, you can use the cloudsinker command from your terminal.

**To download a single file (or export a G-Doc):**

cloudsinker "\[https://docs.google.com/document/d/](https://docs.google.com/document/d/)..."

**To mirror an entire public folder:**

cloudsinker "\[https://drive.google.com/drive/folders/](https://drive.google.com/drive/folders/)..." ./my-local-folder

**To run a "pre-flight" check on a file:**

cloudsinker --check "\[https://drive.google.com/file/d/](https://drive.google.com/file/d/)..."

## ⚖️ License

This project is licensed under the MIT License. See the LICENSE file for details.