Skip to main content

goodoc

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.0.tar.gz (9.1 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.0-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: goodoc-1.4.0.tar.gz
  • Upload date:
  • Size: 9.1 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.0.tar.gz
Algorithm Hash digest
SHA256 41765158d111f45a47f23289ef2ddb9a6fd5c331ef36a4554496e5846254b8ca
MD5 fc4f148961872581b15af67b74f700d4
BLAKE2b-256 1b96a4a909a10633fd9a5dcb4c64b8a6e88ff855bdd29677cae136d22c07f8a2

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: goodoc-1.4.0-py3-none-any.whl
  • Upload date:
  • Size: 7.2 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c9b06c90f86c46edd570c2fb72126b8455b78b18ad9b5f8d413ea4fa3587ff94
MD5 bef5add60eb99530a5f105a1c0a1d93b
BLAKE2b-256 4fc5f7e948f9e7e23e67c82a6f49f35c50858de7be246c430cb3d8a185a7bd63

See more details on using hashes here.

Provenance

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