Local-first tasks
Every todo lives in a local tasks.json. Add, edit, delete and toggle todos instantly, fully offline.
v1.5.0/MIT license/Windows 10 & 11/Rainmeter 4.5.26+
Rainmeter Todo Skin with Google Tasks sync
Todo Board is a local-first todo widget for your Windows desktop. Click a todo and it becomes a real Google Task, signed in once with OAuth 2.0. No Google Cloud project needed.
Free and open source. Not affiliated with Google or Rainmeter.
- Works offline with tasks.json
- One-click Google sign-in
- DPAPI-encrypted tokens
- DPI-aware UI
- Self-updating
Features
A todo board that lives on your desktop
Everything below comes straight from the project README. The board is local first; Google is only contacted when you click a todo that has no custom link.
Click to create a Google Task
Clicking a todo with no custom link creates a real task in your Google account through the Google Tasks API.
Dates become all-day tasks
A todo with a date (YYYY-MM-DD) syncs as an all-day task. Undated todos are created without a due date.
One-click Google sign-in
Settings, Google Tasks, Sign in with Google. A built-in OAuth 2.0 client means no Google Cloud project, though you can bring your own.
DPAPI-encrypted tokens
OAuth tokens are encrypted with Windows DPAPI for your user, refresh automatically, and revoked grants are detected.
Custom links preserved
A todo with a custom link opens that link normally and is never sent to Google.
DPI-aware layout
The host is process-DPI aware and scales the tile and dialogs automatically. UI scale is auto or 50% to 200% on the About tab.
Built-in updater
Check for updates on the About tab. It installs the newest GitHub release and keeps tasks.json, ui-scale.txt and your secrets.
Optional extras
Daily arXiv paper feed
Import 1 to 20 papers per day with 1 to 90 days of cache retention.
DeepSeek scoring
Score titles and abstracts with your own prompts. Only called after you confirm a manual refresh.
File server sync
Share paper scoring results between devices through a File Browser account.
Title translation
Optional Tencent Cloud translation of paper titles to Chinese. Credentials are DPAPI-encrypted.
Companion Calendar skin
Installed by the same package; it can sync with any CalDAV server.
How it works
Rainmeter draws it. TodoHost.exe does the talking.
Rainmeter alone cannot handle HTTPS callbacks or encrypted token storage, so a small C# host app, TodoHost.exe, performs the OAuth 2.0 desktop flow, calls the Google Tasks API and stores tokens.
| You do this | What happens |
|---|---|
| Click a todo with no custom link | Creates a Google Task. All-day if the todo has a date, no due date otherwise. |
| Click a todo with a custom link | Opens the link. No Google Task is created. |
| Tick the checkbox | Marks the todo complete on the board only. It does not change an existing Google Task. |
| Add with the + button | Saved locally to tasks.json. It only reaches Google Tasks when you click the todo. |
Good to know. Sync is one-way: tasks are written to Google Tasks and not read back. Every click creates a new task and clicks are not deduplicated, so click once. Todos without a date show in Google Tasks but not on the Google Calendar grid.
Local-first by design
All todo data lives in @Resources\tasks.json. Nothing is stored in the cloud except the tasks you deliberately create in Google Tasks.
Encrypted secrets
Google tokens (gtasks.secret), translation, file-sync and CalDAV credentials are all stored encrypted with Windows DPAPI under your user account.
No tracking in the app
The updater contacts GitHub only when you click Check for updates. Otherwise network use is limited to the services you configure.
Screens
The board, as it ships
Screenshots below are the project's own images from the repository.
One settings dialog, seven tabs
The all-English Todo settings dialog groups everything into tabs:
PapersGoogle TasksDeepSeek APIFilter & ScoreFile SyncTranslationAbout
Quick start
Install in a minute
The board works fully offline as soon as it is loaded. Connecting Google Tasks is optional.
- Download the latest release (1.5.0) from the Releases page.
- Install it. Double-click
Todo-Skin-v1.5.0.rmskin(installs the Todo and Calendar skins), or extractTodo-Skin-v1.5.0.zipand copySkins\Todo(andSkins\Calendar) into your Rainmeter skins folder, e.g.Documents\Rainmeter\Skins. - Refresh. Choose Refresh All from the Rainmeter context menu (or restart Rainmeter) and load the Todo Board skin.
- Optional: open Settings, then Google Tasks, then Sign in with Google and approve in your browser.
Requirements
- Windows 10 or Windows 11
- Rainmeter 4.5.26 or newer
- .NET Framework 4.x runtime (ships with Windows)
- A Google account, only for the optional Google Tasks sync
- Internet only for Google Tasks, the paper feed, DeepSeek, file sync and translation
Build TodoHost.exe from source (optional)
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe /nologo /target:winexe /optimize+ /r:System.Web.Extensions.dll /r:System.Windows.Forms.dll /r:System.Drawing.dll /r:System.Security.dll /out:TodoHost.exe backend\Common.cs backend\Todo*.csGoogle sign-in and your files
Sign-in opens the Google consent page for the scope https://www.googleapis.com/auth/tasks. Google then redirects the browser to http://127.0.0.1:8392/, where the host app stores your tokens. Prefer your own OAuth client? Drop a gtasks-client.json into @Resources; see the setup guide.
tasks.json entry (empty target = click creates a Google Task)
{
"id": "local_1725300000000",
"title": "Ship v1.0",
"target": "",
"note": "Announce on the forum.",
"labels": ["work"],
"completed": false,
"source": "local",
"due_at": "2026-08-05T00:00:00+09:00"
}| File in @Resources | Purpose |
|---|---|
tasks.json | All todo data |
gtasks-client.json | Optional own OAuth client (secret, never commit) |
gtasks.secret | Encrypted token; delete it to reset sign-in |
ui-scale.txt | UI scale multiplier |
FAQ
Questions, answered
Does Rainmeter Todo Skin create Google Calendar events?
No. It creates real Google Tasks, not Google Calendar events. A todo with a date is created as an all-day task (due date YYYY-MM-DDT00:00:00.000Z), which then appears in the Google Calendar Tasks layer and at tasks.google.com. A todo without a date is created without a due date.
Do I need my own Google Cloud project?
No. Since v1.5.0 the host app ships with a built-in OAuth 2.0 client, so one-click sign-in works out of the box: open Settings, then the Google Tasks tab, then Sign in with Google. Bringing your own client is optional: place a gtasks-client.json file in the skin's @Resources folder and it takes precedence over the built-in one.
What happens when I click a todo?
If the todo has a custom link, the link opens in your browser and nothing is sent to Google. If it has no custom link, TodoHost.exe calls the Google Tasks API and creates a real Google Task: all-day if the todo has a date, with no due date otherwise.
Does it work offline or without a Google account?
Yes. Todo Board is local-first: every todo lives in a local tasks.json file, and adding, editing, deleting and toggling todos all work offline. Google is only contacted when you click a todo that has no custom link. A Google account is only needed for that optional sync.
Is my Google sign-in token safe?
Tokens are encrypted with Windows DPAPI under your Windows user account and stored locally in @Resources\gtasks.secret. They refresh automatically, and revoked grants are detected and cleaned up. Use Sign out on the Google Tasks tab to remove the saved account.
Does sync work both ways?
No. Sync is one-way: tasks are written to Google Tasks but are not read back into the skin. Ticking a todo's checkbox marks it done on the board only; it does not change the Google Task. Each click on a todo creates a new Google Task and clicks are not deduplicated, so avoid clicking the same todo twice.
Why does the skin need a C# host app (TodoHost.exe)?
TodoHost.exe performs the OAuth 2.0 desktop flow with its loopback redirect on port 8392, calls the Google Tasks API, scores papers and stores tokens encrypted. Rainmeter alone cannot handle HTTPS callbacks and encrypted token storage reliably. The source is in the repository's backend folder and builds with the csc compiler that ships with Windows.
Which Windows and Rainmeter versions are supported?
Windows 10 and Windows 11 with Rainmeter 4.5.26 or newer. The included TodoHost.exe uses the .NET Framework 4.x runtime that ships with Windows. The latest version is 1.5.0 and the project is MIT licensed.
Which optional extras are included besides todos?
A daily arXiv paper feed, optional DeepSeek scoring of titles and abstracts (only called after you confirm a manual refresh), file-server sync of scoring results through a File Browser account, optional Tencent Cloud title translation, and a companion Calendar skin that can sync with a CalDAV server. All of these are optional; the todo board works without them.