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

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

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.5.0.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.5.0-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: goodoc-1.5.0.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.5.0.tar.gz
Algorithm Hash digest
SHA256 c4462129359c8235eca19bcee52a1934f284f42f824d4498c515e60dfbeab18f
MD5 02d768fb6188fbd26e385e6083dc69ea
BLAKE2b-256 eb60f58dd0375a8f5212e805920fa294a27d9f0547da8717250b64d36a56f809

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: goodoc-1.5.0-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.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e1fa183fe22dcf41bde56964561b8738abd471165e6b349acb1535f7d9cdcc24
MD5 48cad08a6a3376f523481ca72bd56f83
BLAKE2b-256 3ddc454dc7a6365bd929485562d05b7a52522471492a614b8baf4a900995ff02

See more details on using hashes here.

Provenance

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