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

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for goodoc-1.3.1.tar.gz
Algorithm Hash digest
SHA256 293f8884dfaa473c7f0555ed3957ddbb956c30e049550fa8679fd093d7149542
MD5 4674f1db247217a7ee7763190000d2e3
BLAKE2b-256 7e4de281943e054cebad3e61c7fc5185a4664735638f3e04d210e3b0ed207f11

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: goodoc-1.3.1-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.12

File hashes

Hashes for goodoc-1.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 28fa38df13b8da4e3a1e080123dc341051300a2a467fd3a8dc12742b1ca8bfae
MD5 d28544dfda5ce2272291572ac04a3b13
BLAKE2b-256 0351e8b60173e027cc898a92635260f6d956027b4396b8cb5a48ee4d66224ce9

See more details on using hashes here.

Provenance

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