https://github.com/keiaa-75/tasks

A simple desktop application to display your Google Tasks.
https://github.com/keiaa-75/tasks

google-tasks google-tasks-api python python3 qt

Last synced: about 1 month ago
JSON representation

A simple desktop application to display your Google Tasks.

• Host: GitHub
• URL: https://github.com/keiaa-75/tasks
• Owner: keiaa-75
• License: mit
• Created: 2025-11-11T04:22:06.000Z (7 months ago)
• Default Branch: master
• Last Pushed: 2025-11-11T05:43:57.000Z (7 months ago)
• Last Synced: 2025-11-11T06:22:13.844Z (7 months ago)
• Topics: google-tasks, google-tasks-api, python, python3, qt
• Language: Python
• Homepage:
• Size: 5.86 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Tasks

[![Google Tasks API](https://img.shields.io/badge/Made%20with-Tasks%20API-4285F4.svg?style=flat&logo=google&logoColor=white)](https://developers.google.com/tasks)

[![Python](https://img.shields.io/badge/Made%20with-Python-4285F4.svg?style=flat&logo=python&logoColor=white)](https://www.python.org/)

[![Qt](https://img.shields.io/badge/Made%20with-Qt-41CD52.svg?style=flat&logo=qt&logoColor=white)](https://www.qt.io/)

A simple, cross-platform, PyQt-based Google Tasks client. Made for learning purposes.

## Setup

### 1. Google Cloud Console Setup

1. Go to the [Google Cloud Console](https://console.cloud.google.com/)

2. Create a new project or select an existing one

3. Enable the Google Tasks API:

   - Go to "APIs & Services" > "Library"

   - Search for "Tasks API"

   - Click on it and press "Enable"

4. Create credentials:

   - Go to "APIs & Services" > "Credentials"

   - Click "Create Credentials" > "OAuth client ID"

   - If prompted, configure the OAuth consent screen first

   - Choose "Desktop application" as the application type

   - Give it a name (e.g., "Tasks")

   - Download the JSON file

   - Go to "Audience" > "Test Users"

   - Add your preferred Google Account

5. Place the credentials file:

   Rename the downloaded file to `credentials.json` and place it in the correct directory for your operating system. You may need to create the tasks folder.

    - **Linux:** `~/.config/tasks/`

    - **Windows:** `%APPDATA%\tasks\`

    - **macOS:** `~/Library/Application Support/tasks/`

### 2. Installation

You must have Git and Python installed on your system and available in your PATH.

1. **Clone the repository:**

   ```bash

   git clone https://github.com/keiaa-75/tasks && cd tasks

   ```

2. **Create and activate a virtual environment:**

   For Linux/macOS:

   ```bash

   python3-m venv .venv

   source .venv/bin/activate

   ```

   For Windows:

   ```pwsh

   python -m venv .venv

   .venv\Scripts\activate

   ```

3. **Install the application:**

   ```bash

   pip install .

   ```

### 3. Build an Executable (Optional)

You can also build a single-file executable. This project uses `PyInstaller`.

1. **Install PyInstaller:**

   ```bash

   pip install pyinstaller

   ```

2. **Run the build script:**

   ```bash

   python build.py

   ```

## Usage

Run the application:

```

tasks

```

On first run, it will open a browser window for Google authentication. Grant the necessary permissions to access your Google Tasks.