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.3.2.tar.gz (8.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.3.2-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: goodoc-1.3.2.tar.gz
  • Upload date:
  • Size: 8.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.3.2.tar.gz
Algorithm Hash digest
SHA256 d2c660ff0decda9e19f56418ec6aea579f5eaa10433d67b2d83b2401f9eca953
MD5 3ae73fed21f20c7f92b07189abacb2d2
BLAKE2b-256 0c6879e62c09c0ce7b40c7d5509a3d07693a6d672871c7e5924b5df6a2e34aeb

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: goodoc-1.3.2-py3-none-any.whl
  • Upload date:
  • Size: 7.0 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.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 5ef5ef64d7ac88c7f75dc723563e1a04fae94eadf7ae70d5784b1ee4b0a46530
MD5 1d0bded46edecd93b823854ba8e191ee
BLAKE2b-256 8b41f42ef7a9b7e3af4c0290d4c43d0571d137675397ff0b27284c106f249d8b

See more details on using hashes here.

Provenance

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