Skip to main content

goodoc

CI PyPI Python License

Upload Office files to Google Drive with automatic conversion to native Google formats (Docs / Sheets / Slides). Integrates into macOS Finder as a right-click action.

Typical workflow: got a file to review → right-click → opens in Google Docs. No Word, no drag-and-drop.


Usage

goodoc file.docx                      # upload and open in browser
goodoc file.xlsx --no-open            # upload without opening
goodoc file.docx file.xlsx file.pptx  # upload multiple files

goodoc login                          # authorize without uploading
goodoc logout                         # forget the stored token

Supported formats:

Extension Converts to
.doc, .docx Google Docs
.xls, .xlsx Google Sheets
.ppt, .pptx, .pptm Google Slides

Installation

curl -fsSL https://raw.githubusercontent.com/djachenko/goodoc/master/install.sh | bash

Installs goodoc, the Finder Quick Action, and adds goodoc-update / goodoc-uninstall to your shell.

Alternatively, CLI only (no Quick Action or shell helpers):

pipx install git+https://github.com/djachenko/goodoc.git

First run

goodoc talks to Google Drive through your own Google Cloud project. On the first run, a setup wizard starts automatically:

  1. Google Cloud credentials — opens the browser, walks you through creating an OAuth client, prompts for the downloaded JSON file
  2. Authorization — opens the browser for Google sign-in, saves the token

After that, every run is silent.

There is also a shared client maintained by the author, with limited capacity. If you have an access key, skip the wizard entirely:

goodoc login --key <KEY>

Ask for a key in issues. Treat the key as a credential — don't publish it.

Enable the Quick Action in: System Settings → Privacy & Security → Extensions → Finder Extensions.


Update / Uninstall

goodoc-update      # upgrade to latest version
goodoc-uninstall   # remove goodoc, the Quick Action, and credentials

To re-authorize without uninstalling:

goodoc logout

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

goodoc-1.6.0.tar.gz (10.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

goodoc-1.6.0-py3-none-any.whl (8.6 kB view details)

Uploaded Python 3

File details

Details for the file goodoc-1.6.0.tar.gz.

File metadata

  • Download URL: goodoc-1.6.0.tar.gz
  • Upload date:
  • Size: 10.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for goodoc-1.6.0.tar.gz
Algorithm Hash digest
SHA256 2ce3d711058d6d11c1a4ecec7550b0a8af290e7c7184876f6244ec9d71a032ab
MD5 002496008a0da509a3b460b89bf7dae5
BLAKE2b-256 7c7f70a52bd6e324e50e3af68fc74b362977367860a9765d56a8df1644bde1ec

See more details on using hashes here.

Provenance

The following attestation bundles were made for goodoc-1.6.0.tar.gz:

Publisher: release.yml on djachenko/goodoc

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file goodoc-1.6.0-py3-none-any.whl.

File metadata

  • Download URL: goodoc-1.6.0-py3-none-any.whl
  • Upload date:
  • Size: 8.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for goodoc-1.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ad5a7862f63dcee5ad1f0d82f1dab9d8412766ef31f30b7ffd70b1bb466d4a8b
MD5 d6e76cb3d88202085c9614eecee42e22
BLAKE2b-256 ce81d2c3bd539cd9f933d03ecc8220306fd34ced40e7f4d83d23632b589a5495

See more details on using hashes here.

Provenance

The following attestation bundles were made for goodoc-1.6.0-py3-none-any.whl:

Publisher: release.yml on djachenko/goodoc

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page