cmdg项目安装与配置指南

1. 项目基础介绍

cmdg 是一个命令行的Gmail客户端，它提供了一个类似于Pine/Alpine的UI界面。该项目使用Go语言（98.6%）和C语言（1.3%）进行开发，通过Gmail API与用户的邮箱进行交互。cmdg 的设计理念是为了提供一个更加高效、快速的邮件处理方式，同时减少了密码泄露的风险，因为它使用OAuth2进行身份验证。

2. 项目使用的关键技术和框架

• Gmail API：用于与Gmail服务交互，进行邮件的读取、发送等操作。
• OAuth2：用于用户认证，确保用户邮箱的安全。
• 终端UI：使用终端界面进行交互，提供快捷的键盘操作。

3. 安装和配置准备工作

在开始安装之前，请确保您的系统中已经安装了以下工具：

• Go语言环境：需要安装Go语言环境，具体安装步骤请参考Go官方文档。
• 终端：需要一个能够运行命令行的终端环境。

4. 安装步骤

步骤1：克隆项目

首先，您需要从GitHub上克隆cmdg项目到本地计算机：

git clone https://github.com/ThomasHabets/cmdg.git

步骤2：编译项目

进入项目目录，编译源代码：

cd cmdg
go build ./cmd/cmdg

步骤3：安装项目

编译成功后，将生成的cmdg可执行文件移动到您的系统路径中，以便全局访问：

sudo cp cmdg /usr/local/bin

步骤4：配置项目

在第一次运行cmdg之前，您需要对其进行配置以提供认证信息。以下是配置步骤：

1. 打开Google开发者控制台，创建一个新项目或选择一个现有项目。
2. 确保以下API已启用：Gmail API、Google Drive API、People API。
3. 前往OAuth同意屏幕页面，填写必要的信息。
4. 在“手动添加范围”下添加必要的API范围。
5. 前往凭据页面，创建一个新的OAuth客户端ID，类型为桌面应用。
6. 创建完成后，您将获得Client ID和Client Secret。

在终端中运行以下命令来配置cmdg：

cmdg -configure

根据提示输入您的Client ID和Client Secret。之后，cmdg将会生成配置文件~/.cmdg/cmdg.conf。

步骤5：运行项目

配置完成后，您可以通过以下命令运行cmdg：

cmdg

在大多数屏幕上，按下?或F1可以查看键盘快捷键。要退出程序，请按q。

以上就是cmdg项目的详细安装和配置指南。祝您使用愉快！