An Omarchy shell plugin that puts your Google Drive storage quota and connection status in the bar. Click the icon for a panel with a usage meter and a full quota breakdown.
Storage is read through rclone, so the plugin never
handles your Google credentials itself — rclone owns the OAuth flow and the
token, and this plugin only ever reads remote names and rclone about
output.
- Omarchy 4.0 or newer
rcloneandjq
omarchy pkg add rclone jqomarchy plugin add https://github.com/RobertDougan/omarchy-gdrive --enableThen connect a Google account, if you have not already:
rclone configChoose n for a new remote, name it (gdrive is the conventional choice),
pick the drive backend, and complete the browser login. The plugin picks up
the first drive-type remote automatically; set rclone remote in the
widget settings if you have more than one and want a specific account.
| Section | Shows |
|---|---|
| Hero | Account state and the active remote |
| Meter | Consumed vs. total, with a warning tint past 80% and an urgent tint past 95% |
| Breakdown | Drive, other Google services, trash, free, and total |
| Actions | Open Drive, refresh, reconfigure |
On the headline number. Your Google quota is shared between Drive, Gmail
and Photos, but rclone's used counts only the Drive slice. Reporting that as
your usage understates it — often badly. The headline is therefore derived from
total - free, which is what drive.google.com shows, and the Drive-only figure
appears in the breakdown. On a 2 TB account holding 94 GB in Drive and 173 GB
elsewhere, this widget says 267 GB (12%), not 94 GB (4%).
Accounts with no fixed cap report no total, so the meter is hidden and usage reads as "Unlimited" rather than inventing a denominator.
Bar icon — left click opens the panel, right click refreshes, middle click opens drive.google.com.
In the panel — arrow keys move, Enter activates, and r / s / o
refresh, run setup, and open Drive.
Configure these under the widget in Omarchy's bar settings.
| Setting | Default | Meaning |
|---|---|---|
refreshIntervalSec |
300 |
How often to re-read the quota. Each refresh is one Drive API call. |
remoteName |
(blank) | Which rclone remote to read. Blank uses the first drive remote. |
showUsageInBar |
false |
Show the used percentage next to the bar icon. |
The plugin registers under robertdougan.gdrive:
omarchy-shell robertdougan.gdrive toggle
omarchy-shell robertdougan.gdrive refresh
omarchy-shell robertdougan.gdrive usage # "7.6 GB of 16.1 GB"
omarchy-shell robertdougan.gdrive status # "Connected"status.sh is the only thing that talks to rclone. It resolves a Drive remote,
runs rclone about --json, and emits one JSON object. Service.qml polls it on
a timer; Model.js holds the parsing and formatting (and is plain JS, so it
runs under node for tests); Panel.qml renders the bar icon and panel using
Omarchy's shared qs.Ui components, so it follows your theme.
MIT