goodoc

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

goodoc login                          # authorize without uploading
goodoc logout                         # forget the stored token

Supported formats:

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

goodoc talks to Google Drive through your own Google Cloud project.

Google gates Drive access behind an OAuth client, and shipping a single shared client for everybody requires app verification — a domain, a privacy policy, a review. Until that happens, each user creates their own client. It's a one-time step.

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 — step by step, including the case of a client that already exists: docs/oauth-client.md
2. Authorization — opens the browser for Google sign-in, saves the token

Google shows an "unverified app" warning during authorization. It refers to the client you just created — proceed past it.

After that, every run is silent.

There is also a shared client maintained by the author, with limited capacity. If you have an access key, skip the wizard entirely:

goodoc login --key <KEY>

Ask for a key in issues. Treat the key as a credential — don't publish it.

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:

goodoc logout

License

MIT