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

Uploaded Python 3

File details

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

File metadata

  • Download URL: goodoc-1.4.2.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.2.tar.gz
Algorithm Hash digest
SHA256 d8c244259374eae0c870f34150f934980c1917971ca546d20105e2a154a5a8c2
MD5 523c9d3e85a9c98605559f76b2f37503
BLAKE2b-256 86ae7d164cc18b1958ce5700306097577e49d7dca163e4a8f88c1edc46b1fbf5

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: goodoc-1.4.2-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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 98aa59a945c7b72c700c10fcd668c41b3433a9aa1b333713e9122f4a1ec79b65
MD5 298da5880ba83361ba8184b3ca313998
BLAKE2b-256 c644fd173a5285f79ed9e1497ec6ff59ddd32525b53d1dec049f1fd0a92256ae

See more details on using hashes here.

Provenance

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