Skip to main content

goodoc

CI PyPI Python License

Upload .docx, .xlsx, .pptx, and .pptm 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

Supported formats:

Extension Converts to
.docx Google Docs
.xlsx Google Sheets
.pptx Google Slides
.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

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.

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:

rm ~/.config/goodoc/token.json

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.4.1.tar.gz (9.4 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.4.1-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for goodoc-1.4.1.tar.gz
Algorithm Hash digest
SHA256 d1f948ec03dcb70c791bd5e50eaef4f27adb94ff4f7f8a0b9e083ef673bec8d8
MD5 f2f512c3b67f65f4981dffd7c18512f1
BLAKE2b-256 4da4a0419d361b7f4748fda3db0a796ecc1097fa23e2d79e2db3fa203d5d6458

See more details on using hashes here.

Provenance

The following attestation bundles were made for goodoc-1.4.1.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.4.1-py3-none-any.whl.

File metadata

  • Download URL: goodoc-1.4.1-py3-none-any.whl
  • Upload date:
  • Size: 7.3 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.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 afc9848fdabedee81e56a0c458b4f5e9aaa2ecbcc64d5076ae7e1286ed16cb49
MD5 9b0332b6c95c3dac5b22437b6e5712ad
BLAKE2b-256 198b48d94ece613de1cfc9dad8f47ee582eb197bb97faeed6a48802ee51afe57

See more details on using hashes here.

Provenance

The following attestation bundles were made for goodoc-1.4.1-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