A modern, fast, offline-first Google Tasks desktop client & terminal dashboard for Linux built with Rust.
gtasks is an open-source productivity application designed to provide Linux users with a fast, native desktop client (GTK4/Libadwaita) and terminal dashboard (Ratatui) for managing their Google Tasks.
- π₯οΈ Dual Interface: Keyboard-driven Terminal User Interface (TUI) and GTK4 Desktop GUI.
- π΄ Offline-First Management: Local SQLite cache allowing offline reading, creation, and editing of tasks.
- ποΈ Natural Language Recognition: Smart date parsing (e.g.,
"Buy milk tomorrow"). - π² Hierarchical Organization: Nested tasks and subtask management.
- π Automatic Synchronization: Seamless background delta syncing with Google Tasks.
gtasks requests access to your Google Account data via the official Google Tasks API (https://www.googleapis.com/auth/tasks). Here is how we handle and protect your data:
To function as a Google Tasks client on Linux, gtasks requires access to read, create, modify, and delete tasks and task lists in your Google account based strictly on your direct actions within the app.
- Displaying Tasks: To show your task lists, task titles, descriptions, due dates, and completion status inside the application.
- Task Management: To create, edit, reorder, mark complete, or delete tasks on your Google account when requested by you.
- Background Synchronization: To sync changes made offline in the local SQLite database back to your Google Tasks account once online.
- Local-First & No Third-Party Servers:
gtasksdoes not transmit your tasks, account data, or authentication tokens to any external servers managed by MCR-Project or third parties. All API communication occurs directly between your local device and Google's official servers (googleapis.com). - Secure Local Credential Storage: OAuth 2.0 tokens are encrypted and stored using your operating system's native secret storage (e.g., Linux Secret Service / KWallet via
keyring). - No Selling or Advertising: Your Google user data is never sold, rented, shared, or used for advertising or marketing.
- No AI/ML Model Training: Google Workspace user data accessed by
gtasksis never used to train, develop, or improve AI or Machine Learning models.
For full details, please review our complete Privacy Policy.
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Terminal UI β Desktop GUI β
β (Ratatui / Crossterm) β (Relm4 / GTK4) β
βββββββββββββββββββββ¬ββββββββββββββββββββ¬βββββββββββββββββ
β β
βΌ βΌ
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β gtasks_core Engine β
β β’ Tokio Async Runtime β’ OAuth 2.0 PKCE Handler β
β β’ Background Sync Engine β’ OS Keyring Credentials β
β β’ NLP Date Parsing β’ Task Hierarchy Processor β
ββββββββββββββββ¬βββββββββββββββββββββββββ¬βββββββββββββββββ
β β
ββββββββββββββββΌβββββββ ββββββββΌβββββββββββββββββ
β Local SQLite Cache β β Google Tasks REST API β
β (Fast offline read)β β (Background HTTP Sync)β
βββββββββββββββββββββββ βββββββββββββββββββββββββ
The repository is structured as a Rust Cargo Workspace:
crates/gtasks_core- Core business logic, OAuth 2.0 PKCE flow, SQLite database persistence, background sync worker, and natural language date parser.crates/gtasks_tui- Terminal dashboard application powered by Ratatui & Crossterm.crates/gtasks_gui- Native Linux desktop GUI built with Relm4 (GTK4 / Libadwaita).
To build gtasks on Linux, ensure you have the Rust toolchain installed alongside native development headers:
# Ubuntu / Debian
sudo apt update
sudo apt install build-essential pkg-config libssl-dev libsecret-1-dev libgtk-4-dev libadwaita-1-dev
# Fedora
sudo dnf install @development-tools openssl-devel libsecret-devel gtk4-devel libadwaita-devel
# Arch Linux / Manjaro
sudo pacman -S base-devel openssl libsecret gtk4 libadwaitaCreate a .env file in the root directory (or copy from template) containing your Google Cloud OAuth Client ID and Secret:
GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here# Clone the repository
git clone https://github.com/MCR-Project/google-tasks-gui.git
cd google-tasks-gui
# Run the Terminal User Interface (TUI)
cargo run -p gtasks_tui
# Run the Desktop GUI (GTK4 / Relm4)
cargo run -p gtasks_guicargo testWhen running gtasks_tui, use the following keyboard controls:
| Key | Action |
|---|---|
Tab |
Switch focus between Task Lists sidebar and Tasks view |
j / Down |
Move selection down |
k / Up |
Move selection up |
g |
Jump to top of list |
G |
Jump to bottom of list |
Space |
Toggle task completion status ([ ] / [x]) |
c |
Create new task in active list |
L |
Create new task list (when focused on Task Lists pane) |
e |
Edit selected task details (Title, Notes, Due Date) |
d / Delete |
Delete selected task |
r |
Trigger manual sync with Google Tasks API |
q |
Quit application |
When creating or editing tasks, natural language expressions in task titles are automatically parsed into structured due dates:
| Input Text | Resulting Task Title | Extracted Due Date |
|---|---|---|
Buy groceries today |
Buy groceries |
Today |
Finish quarterly report tomorrow |
Finish quarterly report |
Tomorrow |
Sync with team next monday |
Sync with team |
Next Monday |
- Phase 0: Workspace Architecture
- Modular Cargo workspace (
gtasks_core,gtasks_tui,gtasks_gui).
- Modular Cargo workspace (
- Phase 1: Secure Core & Engine
- OAuth 2.0 PKCE authentication flow with local loopback listener.
- Linux System Keyring integration (
Secret Service/ KWallet). - SQLite local database cache (
task_lists.db). - Google Tasks REST API client integration.
- Natural Language Date Parsing (NLP).
- Phase 2: User Interfaces
- Interactive Terminal User Interface (
gtasks_tui). - Native Linux GTK4 Desktop GUI (
gtasks_gui).
- Interactive Terminal User Interface (
- Phase 3: Sync & Offline Resilience
- Offline edit queuing with
dirty_bitflag tracking. - Background delta sync engine.
- Soft-deletion queue & sync.
- Offline edit queuing with
- Phase 4: Packaging & Distribution
- Flatpak & AUR packaging.
- Desktop entry & icon integration.
Contributions are very welcome! If you find a bug or have a feature suggestion, please feel free to open an issue or submit a pull request.
- Fork the Repository
- Create your Feature Branch (
git checkout -b feature/amazing-feature) - Commit your Changes (
git commit -m 'Add some amazing-feature') - Verify tests pass (
cargo test) - Push to the Branch (
git push origin feature/amazing-feature) - Open a Pull Request
gtasks is a local-first application and prioritizes your data privacy. Google Tasks data and OAuth tokens are strictly stored locally on your device or in your OS Keyring and are never transmitted to any third-party servers. For details, see the complete Privacy Policy.
This project is licensed under the MIT License - see the LICENSE file for details.