cmdg - A command line client to GMail

Installation

brew tap cutzenfriend/homebrew-cmdg
brew install cmdg

Documentation

For documentation and initial configuration refer to: https://github.com/ThomasHabets/cmdg

Copyright Thomas Habets [email protected] 2015-2021

Configuring

You need to configure cmdg in order to provide it with authentication so it can talk to GMail on your behalf. To do this you'll need to generate a ClientID and ClientSecret. You can do this with the following steps:

1. Go to the Google Developers Console.
2. Select an existing project or create a new project
3. Navigate to the "APIs & Services > OAuth consent screen" page.
4. Fill out the OAuth consent screen.
5. Make sure to add scopes for the various APIs you'll need
   1. Drive API - .../auth/drive.appdata
   2. Gmail API - ../auth/gmail.modify
   3. People API - .../auth/contacts.readonly
6. Click the button "Create Credentials" and select "OAuth client ID" from the dropdown.
7. Set the "Application type" to "Desktop app" and make the name anything you'd like.
8. This should give you a Client ID and Client Secret you can provide to cmdg.

$ cmdg -configure
[It will ask about ClientID and ClientSecret.
For now you have create one at https://console.developers.google.com]
Cut and paste this URL into your browser:
  https://long-url....
Returned code: <code shows up here, just FYI>
$

This creates ~/.cmdg/cmdg.conf.

Running

$ cmdg

For keyboard shortcuts press '?' or F1 in most screens.

To quit, press 'q'.