mountlet 0.2.1__tar.gz → 0.2.2__tar.gz

{mountlet-0.2.1 → mountlet-0.2.2}/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.2.2 - 2026-06-19
+
+- Added a guided new-remote wizard for major cloud providers, with browser and
+  token-based rclone authentication flows, provider-specific fields, official
+  setup links, connection validation, and cleanup of incomplete remotes.
+- Added remote ordering controls, saved one-time sorting by registration time,
+  name, provider, and storage usage, and per-remote move buttons.
+- Added provider-colored labels and browser shortcuts, compact mount controls,
+  dynamic window sizing, and responsive background mount, unmount, usage, and
+  folder-opening operations.
+- Added frameless main and configuration windows, an in-window keep-above
+  control, and reliable current-desktop tray behavior on Plasma X11. Pinning and
+  desktop movement now use EWMH requests without remapping the Qt window.
+- Added provider status colors in the new-remote wizard to distinguish locally
+  tested providers from untested setup paths without adding extra label text.
+- Added a dedicated Koofr setup path using rclone's Koofr backend instead of
+  routing Koofr through WebDAV.
+- Added provider-specific S3 setup hints and links for Cloudflare R2, MinIO,
+  Amazon S3, Wasabi, and other S3-compatible providers.
+- Added post-registration and post-mount connection checks so failed setup does
+  not quietly leave unusable remotes in the app list.
+- Improved remote naming, provider suffixes, credential reuse, OAuth port
+  handling, wizard cancellation, application shutdown, and child-window
+  lifecycle behavior.
+- Documented locally tested providers and untested provider paths.
+
 ## 0.2.1 - 2026-06-02
 
 - Added a cropped transparent Mountlet icon for the tray and window.

{mountlet-0.2.1/src/mountlet.egg-info → mountlet-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mountlet
-Version: 0.2.1
+Version: 0.2.2
 Summary: CLI and tray tools for mounting rclone remotes
 Author: Eric Holt
 License-Expression: MIT
@@ -130,15 +130,52 @@ pipx inject mountlet PySide6
 The tray app uses the tray icon this way:
 
 - Hover shows a short mounted/unmounted summary.
-- Left-click opens the Mountlet window with compact remote strips, storage
-  usage, mount-state toggles, click-to-open behavior, and config actions.
+- Left-click opens or closes the Mountlet window. If it is behind another
+  window, the first click brings it forward. On Plasma X11, opening it from a
+  different desktop moves it to the current desktop.
 - Right-click shows app-level actions such as mount all, unmount all, update
   status, app settings, raw app, mount, rclone, and FUSE config files, and
   quit.
 
+The Mountlet window provides:
+
+- Compact remote strips with storage usage and mount-state toggles.
+- Click-to-open folders, provider website shortcuts, and per-remote settings.
+- A guided `+` flow for adding supported cloud remotes through rclone.
+- Sorting by registration time, name, provider, total size, used space, or
+  remaining space, with manual move controls for final adjustments.
+- A pin control that keeps the window above other windows without tying it to
+  one desktop.
+
 If your desktop session does not expose a system tray, use the terminal menu
 instead.
 
+## Provider Support
+
+Mountlet uses `rclone` under the hood, so provider support depends on both
+Mountlet's setup UI and rclone's backend behavior.
+
+Locally tested with the current GUI flow and/or active local remotes:
+
+- Google Drive
+- Dropbox
+- Microsoft OneDrive
+- Box
+- pCloud
+- Cloudflare R2 through the S3-compatible wizard
+- Koofr through rclone's dedicated Koofr backend
+
+Available but not yet locally tested:
+
+- Amazon S3
+- MinIO and other S3-compatible providers
+- Wasabi
+- WebDAV providers such as Nextcloud, ownCloud, SharePoint, and Fastmail Files
+
+In the setup window, tested options are shown in white and untested options in
+yellow. Untested providers may work through rclone, but expect rough edges until
+the wizard path is tested with a real account.
+
 ## Extra Commands
 
 These are useful for backup, troubleshooting, or moving to another computer:
@@ -190,7 +227,7 @@ export MOUNTLET_MOUNT_BASE=/path/to/mounts
 ### App Settings
 
 In the tray app, use `Config` > `App settings` to edit app-wide behavior. Use
-the `Config` button on a remote strip to edit only that mount. The settings
+the gear button on a remote strip to edit only that mount. The settings
 windows show the available fields with text boxes, checkboxes, and dropdowns,
 then write `config.toml` and `mounts.toml` for you.
 

{mountlet-0.2.1 → mountlet-0.2.2}/README.md

@@ -99,15 +99,52 @@ pipx inject mountlet PySide6
 The tray app uses the tray icon this way:
 
 - Hover shows a short mounted/unmounted summary.
-- Left-click opens the Mountlet window with compact remote strips, storage
-  usage, mount-state toggles, click-to-open behavior, and config actions.
+- Left-click opens or closes the Mountlet window. If it is behind another
+  window, the first click brings it forward. On Plasma X11, opening it from a
+  different desktop moves it to the current desktop.
 - Right-click shows app-level actions such as mount all, unmount all, update
   status, app settings, raw app, mount, rclone, and FUSE config files, and
   quit.
 
+The Mountlet window provides:
+
+- Compact remote strips with storage usage and mount-state toggles.
+- Click-to-open folders, provider website shortcuts, and per-remote settings.
+- A guided `+` flow for adding supported cloud remotes through rclone.
+- Sorting by registration time, name, provider, total size, used space, or
+  remaining space, with manual move controls for final adjustments.
+- A pin control that keeps the window above other windows without tying it to
+  one desktop.
+
 If your desktop session does not expose a system tray, use the terminal menu
 instead.
 
+## Provider Support
+
+Mountlet uses `rclone` under the hood, so provider support depends on both
+Mountlet's setup UI and rclone's backend behavior.
+
+Locally tested with the current GUI flow and/or active local remotes:
+
+- Google Drive
+- Dropbox
+- Microsoft OneDrive
+- Box
+- pCloud
+- Cloudflare R2 through the S3-compatible wizard
+- Koofr through rclone's dedicated Koofr backend
+
+Available but not yet locally tested:
+
+- Amazon S3
+- MinIO and other S3-compatible providers
+- Wasabi
+- WebDAV providers such as Nextcloud, ownCloud, SharePoint, and Fastmail Files
+
+In the setup window, tested options are shown in white and untested options in
+yellow. Untested providers may work through rclone, but expect rough edges until
+the wizard path is tested with a real account.
+
 ## Extra Commands
 
 These are useful for backup, troubleshooting, or moving to another computer:
@@ -159,7 +196,7 @@ export MOUNTLET_MOUNT_BASE=/path/to/mounts
 ### App Settings
 
 In the tray app, use `Config` > `App settings` to edit app-wide behavior. Use
-the `Config` button on a remote strip to edit only that mount. The settings
+the gear button on a remote strip to edit only that mount. The settings
 windows show the available fields with text boxes, checkboxes, and dropdowns,
 then write `config.toml` and `mounts.toml` for you.
 

{mountlet-0.2.1 → mountlet-0.2.2}/SECURITY.md

@@ -23,4 +23,5 @@ can be reviewed before public disclosure.
 
 ## Supported Versions
 
-No public stable version is supported yet.
+Mountlet is still pre-1.0. Security fixes are intended for the latest public
+0.2.x release line.

{mountlet-0.2.1 → mountlet-0.2.2}/docs/README.md

@@ -51,9 +51,33 @@ ignored by git and must not be part of the installed-user workflow.
 - Build a wheel and install it in a clean virtual environment.
 - Test on a fresh Ubuntu installation with `rclone` and `fuse3`.
 - Verify import/export flows with non-sensitive sample configs.
+- Update the provider support table in the root README after checking real
+  setup paths.
 - Confirm the built wheel and source distribution do not include local secrets.
 - Follow [RELEASE.md](RELEASE.md) when merging `wip` to `main`, tagging, and publishing.
 
+## Provider Test Status
+
+The 0.2.2 release documents provider status based on local remotes in
+`~/.config/rclone/rclone.conf` and recent GUI setup work.
+
+Locally tested:
+
+- Google Drive
+- Dropbox
+- Microsoft OneDrive
+- Box
+- pCloud
+- Cloudflare R2
+- Koofr
+
+Available but untested:
+
+- Amazon S3
+- MinIO and other S3-compatible storage
+- Wasabi
+- WebDAV providers including Nextcloud, ownCloud, SharePoint, and Fastmail Files
+
 ## Release Strategy
 
 - Keep the CLI/TUI core MIT licensed.

{mountlet-0.2.1 → mountlet-0.2.2}/docs/RELEASE.md

@@ -17,7 +17,7 @@ Create release branches only if a maintained older line needs fixes while
 Run these from `wip` first:
 
 ```bash
-VERSION=0.2.1
+VERSION=0.2.2
 python -m unittest discover -s tests
 python -m compileall -q src tests
 python -m pip wheel . -w /tmp/mountlet-release --no-deps --no-build-isolation
@@ -26,6 +26,7 @@ python -m pip wheel . -w /tmp/mountlet-release --no-deps --no-build-isolation
 Confirm:
 
 - `README.md` describes the user flow.
+- `README.md` documents the tested and untested provider setup paths.
 - `CHANGELOG.md` has a section for the version being released.
 - `pyproject.toml` and `src/mountlet/__init__.py` have the same version.
 - `SECURITY.md` has an active security reporting path or GitHub private vulnerability reporting is enabled.

{mountlet-0.2.1 → mountlet-0.2.2}/examples/rclone.conf.sample

@@ -5,3 +5,6 @@
 # client_id = your-client-id.apps.googleusercontent.com
 # client_secret = your-client-secret
 # token = {"access_token":"..."}
+#
+# Provider setup paths marked tested in the Mountlet UI are based on local
+# maintainer testing. Do not use this file for real credentials.

{mountlet-0.2.1 → mountlet-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mountlet"
-version = "0.2.1"
+version = "0.2.2"
 description = "CLI and tray tools for mounting rclone remotes"
 readme = "README.md"
 requires-python = ">=3.10"

{mountlet-0.2.1 → mountlet-0.2.2}/src/mountlet/__init__.py

@@ -1,5 +1,5 @@
 """Mountlet package."""
 
-__version__ = "0.2.1"
+__version__ = "0.2.2"
 
 __all__ = ["__version__"]

{mountlet-0.2.1 → mountlet-0.2.2}/src/mountlet/core.py

@@ -114,6 +114,7 @@ class RemoteInfo:
     flags: List[str] = field(default_factory=list)
     extra_info: Dict[str, str] = field(default_factory=dict)
     auto_mount: bool = False
+    remote_path: str = ""
 
     @property
     def display_name(self) -> str:
@@ -136,7 +137,18 @@ class StorageUsage:
         return min(round((used / self.total) * 100), 100)
 
 
+@dataclass(frozen=True)
+class DriveOAuthCredentials:
+    remote_name: str
+    client_id: str
+    client_secret: str
+    remote_names: Tuple[str, ...] = ()
+
+
 PIDS: Dict[str, int] = {}
+OAUTH_BACKEND_TYPES = {"drive", "dropbox", "onedrive", "box", "pcloud"}
+RCLONE_STATUS_TIMEOUT_SECONDS = 20
+RCLONE_CONNECT_TIMEOUT_SECONDS = 20
 
 
 TYPE_FLAG_PRESETS: Dict[str, List[str]] = {
@@ -164,6 +176,12 @@ TYPE_FLAG_PRESETS: Dict[str, List[str]] = {
         "--buffer-size",
         "16M",
     ],
+    "koofr": [
+        "--vfs-cache-mode",
+        "full",
+        "--buffer-size",
+        "16M",
+    ],
     "s3": [
         "--vfs-cache-mode",
         "full",
@@ -187,6 +205,14 @@ SAFE_RCLONE_CONFIG_KEYS: Dict[str, Tuple[str, ...]] = {
     "onedrive": ("drive_type", "region", "drive_id"),
     "webdav": ("url", "vendor"),
     "s3": ("provider", "region", "endpoint", "env_auth", "storage_class", "acl"),
+    "koofr": ("provider", "user", "mountid"),
+}
+S3_PROVIDER_DISPLAY_NAMES = {
+    "cloudflare": "Cloudflare R2",
+    "minio": "MinIO",
+    "aws": "Amazon S3",
+    "wasabi": "Wasabi",
+    "other": "S3",
 }
 
 
@@ -280,6 +306,47 @@ def save_rclone_fields(remote_name: str, updates: Dict[str, str]) -> None:
     _save_config(config)
 
 
+def drive_oauth_credentials() -> List[DriveOAuthCredentials]:
+    config = _load_config()
+    groups: Dict[Tuple[str, str], List[str]] = {}
+    for remote_name in config.sections():
+        section = config[remote_name]
+        if section.get("type", "").lower() != "drive":
+            continue
+        client_id = section.get("client_id", "").strip()
+        client_secret = section.get("client_secret", "").strip()
+        if client_id and client_secret:
+            groups.setdefault((client_id, client_secret), []).append(remote_name)
+    credentials: List[DriveOAuthCredentials] = []
+    for (client_id, client_secret), remote_names in groups.items():
+        names = tuple(remote_names)
+        credentials.append(
+            DriveOAuthCredentials(
+                remote_name=_drive_credential_group_label(names),
+                client_id=client_id,
+                client_secret=client_secret,
+                remote_names=names,
+            )
+        )
+    return credentials
+
+
+def _drive_credential_group_label(remote_names: Tuple[str, ...]) -> str:
+    if not remote_names:
+        return "existing remote"
+    if len(remote_names) == 1:
+        return remote_names[0]
+    return f"{remote_names[0]}, +{len(remote_names) - 1}"
+
+
+def delete_rclone_remote(remote_name: str) -> bool:
+    config = _load_config()
+    if not config.remove_section(remote_name):
+        return False
+    _save_config(config)
+    return True
+
+
 def _build_flags(backend_type: str, extra_flags: List[str]) -> List[str]:
     flags = list(TYPE_FLAG_PRESETS.get(backend_type, DEFAULT_FLAGS))
     if backend_type == "drive" and "--links" not in flags:
@@ -288,18 +355,31 @@ def _build_flags(backend_type: str, extra_flags: List[str]) -> List[str]:
     return flags
 
 
-def load_remotes() -> List[RemoteInfo]:
+def _s3_provider_display_name(provider: str, fallback: str = "S3") -> str:
+    normalized = provider.strip().lower()
+    return S3_PROVIDER_DISPLAY_NAMES.get(normalized, provider.strip() or fallback)
+
+
+def load_remotes(*, include_incomplete: bool = True) -> List[RemoteInfo]:
     config = _load_config()
     app_settings = load_app_settings()
     mount_settings = load_mount_settings()
-    remotes: List[RemoteInfo] = []
-    for name in config.sections():
+    remotes: List[Tuple[int | None, int, RemoteInfo]] = []
+    for config_index, name in enumerate(config.sections()):
         section = config[name]
         remote_settings = mount_settings.get(name)
         if remote_settings and not remote_settings.enabled:
             continue
         backend_type = section.get("type", "").lower()
+        if not include_incomplete and not _remote_section_is_configured(backend_type, dict(section.items())):
+            continue
         alias, provider = _parse_remote_name(name, backend_type)
+        mount_provider = provider
+        display_provider = (
+            _s3_provider_display_name(section.get("provider", ""), provider)
+            if backend_type == "s3"
+            else provider
+        )
         extra_flags_str = section.get("mount_flags", "").strip()
         extra_flags = shlex.split(extra_flags_str) if extra_flags_str else []
         if remote_settings:
@@ -307,7 +387,7 @@ def load_remotes() -> List[RemoteInfo]:
         mount_path = (
             _resolve_configured_mount_path(remote_settings.mount_path)
             if remote_settings and remote_settings.mount_path
-            else _build_mount_path(provider, alias)
+            else _build_mount_path(mount_provider, alias)
         )
         auto_mount = (
             remote_settings.auto_mount
@@ -317,15 +397,46 @@ def load_remotes() -> List[RemoteInfo]:
         info = RemoteInfo(
             name=name,
             alias=alias,
-            provider=provider,
+            provider=display_provider,
             backend_type=backend_type,
             mount_path=mount_path,
+            remote_path=remote_settings.remote_path if remote_settings and remote_settings.remote_path else "",
             flags=_build_flags(backend_type, extra_flags),
             extra_info=dict(section.items()),
             auto_mount=auto_mount,
         )
-        remotes.append(info)
-    return remotes
+        order = remote_settings.order if remote_settings else None
+        remotes.append((order, config_index, info))
+    if any(order is not None for order, _config_index, _info in remotes):
+        remotes.sort(
+            key=lambda item: (
+                item[0] is None,
+                item[0] if item[0] is not None else item[1],
+                item[1],
+            )
+        )
+    return [info for _order, _config_index, info in remotes]
+
+
+def _remote_section_is_configured(backend_type: str, values: Dict[str, str]) -> bool:
+    if backend_type not in OAUTH_BACKEND_TYPES:
+        if backend_type == "s3":
+            provider = values.get("provider", "").strip()
+            env_auth = values.get("env_auth", "").strip().lower() in {"true", "1", "yes", "on"}
+            has_keys = bool(values.get("access_key_id", "").strip() and values.get("secret_access_key", "").strip())
+            if not provider or not (env_auth or has_keys):
+                return False
+            if provider.lower() != "aws" and not values.get("endpoint", "").strip():
+                return False
+            return True
+        if backend_type == "webdav":
+            return values.get("url", "").strip().startswith(("http://", "https://"))
+        if backend_type == "koofr":
+            return bool(values.get("provider", "").strip() and values.get("user", "").strip() and values.get("password", "").strip())
+        return bool(backend_type)
+    if backend_type == "onedrive":
+        return bool(values.get("token") and values.get("drive_id") and values.get("drive_type"))
+    return bool(values.get("token") or values.get("service_account_file"))
 
 
 def find_rclone() -> str | None:
@@ -346,6 +457,11 @@ def mount_path(remote: RemoteInfo) -> str:
     return remote.mount_path
 
 
+def remote_source(remote: RemoteInfo) -> str:
+    path = remote.remote_path.strip().lstrip("/")
+    return f"{remote.name}:{path}" if path else f"{remote.name}:"
+
+
 def is_mounted_windows(path: str) -> bool:
     if not os.path.exists(path):
         return False
@@ -455,10 +571,45 @@ def mount_remote(remote: RemoteInfo) -> Tuple[bool, str]:
     if not ok:
         return False, err or "[!] Unable to prepare mount directory."
 
-    args = [rclone_bin, "mount", f"{remote.name}:", remote.mount_path]
+    args = [rclone_bin, "mount", remote_source(remote), remote.mount_path]
     args.extend(remote.flags)
 
-    return _launch_mount_process(remote, args)
+    success, message = _launch_mount_process(remote, args)
+    if not success:
+        return success, message
+
+    connected, connection_message = check_remote_connection(remote, rclone_bin)
+    if connected:
+        return success, message
+
+    unmounted, unmount_message = unmount_remote(remote)
+    if not unmounted:
+        return False, f"{connection_message}\n{unmount_message}"
+    return False, connection_message
+
+
+def check_remote_connection(remote: RemoteInfo, rclone_bin: str | None = None) -> Tuple[bool, str]:
+    binary = rclone_bin or find_rclone()
+    if not binary:
+        return False, "[!] rclone not found. Set RCLONE_PATH or add rclone to PATH."
+    source = remote_source(remote)
+    try:
+        result = subprocess.run(
+            [binary, "lsf", source, "--max-depth", "1"],
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.PIPE,
+            text=True,
+            timeout=RCLONE_CONNECT_TIMEOUT_SECONDS,
+        )
+    except subprocess.TimeoutExpired:
+        return False, f"[!] {remote.display_name} did not respond while checking {source}."
+    except Exception as exc:
+        return False, f"[!] Failed to check {remote.display_name}: {exc}"
+    if result.returncode == 0:
+        return True, f"[*] connected {remote.display_name}."
+    detail = result.stderr.strip()
+    summary = detail.splitlines()[0] if detail else f"exit code {result.returncode}"
+    return False, f"[!] {remote.display_name} is not connected to {source}: {summary}"
 
 
 def unmount_remote(remote: RemoteInfo) -> Tuple[bool, str]:
@@ -548,9 +699,10 @@ def get_storage_usage_details(remote: RemoteInfo) -> StorageUsage:
         return StorageUsage("?")
     try:
         output = subprocess.check_output(
-            [rclone_bin, "about", f"{remote.name}:", "--json"],
+            [rclone_bin, "about", remote_source(remote), "--json"],
             stderr=subprocess.DEVNULL,
             text=True,
+            timeout=RCLONE_STATUS_TIMEOUT_SECONDS,
         )
         data = json.loads(output)
         used = int(data.get("used", 0))
@@ -574,7 +726,7 @@ def verify_remote(remote: RemoteInfo) -> Tuple[bool, str]:
         return False, "[!] rclone not found."
     try:
         result = subprocess.run(
-            [rclone_bin, "about", f"{remote.name}:"],
+            [rclone_bin, "about", remote_source(remote)],
             stdout=subprocess.PIPE,
             stderr=subprocess.PIPE,
             text=True,
@@ -611,6 +763,7 @@ __all__ = [
     "editable_rclone_fields",
     "save_rclone_fields",
     "mount_remote",
+    "check_remote_connection",
     "unmount_remote",
     "refresh_remote",
     "mount_all",