☁️ Check Cloud Drives

A beautiful macOS menu bar app for monitoring your cloud drive status

About

Check Cloud Drives is a sleek PySide6 GUI application that monitors the status of your cloud drives using rclone. It lives in your macOS menu bar and provides a modern, intuitive interface to check storage usage across all your configured cloud drives.

Author: Rich Lewis - @RichLewis007

Features

🎨 Beautiful UI

Modern, clean interface with smooth animations and a light theme

📊 Real-time Status

View total, used, and free space for each drive with relative timestamps

🔄 Auto-refresh

Automatically updates drive status at configurable intervals

📌 Stay on Top

Toggle to keep the window above other applications

🎯 Menu Bar Integration

Lives in macOS menu bar for easy access

🔒 Privacy First

All private configuration stored locally (excluded from git)

⚙️ Easy Configuration

Simple setup dialog to select which drives to monitor

🎨 Custom Icons

Support for custom SVG icons for different drive types

Requirements

  • Python 3.11 or higher
  • uv - Fast Python package installer
  • rclone installed and configured
  • macOS (for menu bar integration)

Installation

1. Install uv

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Clone the Repository

git clone https://github.com/RichLewis007/check-cloud-drives.git
cd check-cloud-drives

3. Install Dependencies

uv sync

4. Configure rclone

Make sure rclone is installed and configured:

rclone listremotes

Usage

Run the Application

./run.sh

Or run directly with uv:

uv run -m check_cloud_drives.main

First Run

On first run, the app will:

  • Detect all available rclone remotes
  • Show a setup dialog to select which drives to monitor
  • Automatically fetch status for selected drives

Features

  • Refresh All: Manually refresh all drive statuses
  • Add Drive: Add additional drives to monitor
  • Drag & Drop: Reorder drive cards by dragging
  • Settings: Configure auto-refresh, stay on top, and more

Configuration

The application stores all configuration in check-cloud-drives.toml in the project root directory. This file includes:

  • List of monitored drives
  • Window position and size
  • Stay on top preference
  • Auto-refresh interval
  • Run at system startup setting

Note: This config file is excluded from git to protect your private cloud drive information.

Development

Tech Stack

  • PySide6 - Modern Qt6 Python bindings
  • rclone - Command-line tool for cloud storage
  • uv - Fast Python package installer and resolver

Adding Dependencies

uv add package-name

Updating Dependencies

uv sync --upgrade

Links

View on GitHub Releases