52 lines
2.8 KiB
Markdown
52 lines
2.8 KiB
Markdown
# GUI Desktop Application Guide
|
|
|
|
The **Nextcloud Upload Tool GUI** is a fast desktop application designed for streamlined file queuing, drag-and-drop uploads, public share creation, and multi-account management.
|
|
|
|
---
|
|
|
|
## 1. Interface Overview
|
|
|
|
The interface is structured into three primary sections:
|
|
|
|
1. **Header Bar**:
|
|
- Displays the application branding.
|
|
- **Account Switcher**: Quick-switch dropdown to select the target Nextcloud account for uploads.
|
|
- **Navigation Tabs**: Toggle between **Upload Queue** and **Accounts & Auth**.
|
|
|
|
2. **Upload Queue Tab**:
|
|
- **Target Settings**: Configure remote directory on Nextcloud (default: `Uploads`), toggle public share generation, and set optional link passwords.
|
|
- **Drag & Drop Zone**: Visual target supporting OS file drops or manual system file browser selection (`Browse Files`).
|
|
- **Queue List**: Per-file upload queue showing status badges (`queued`, `uploading`, `completed`, `error`), live percentage, byte counters, and action buttons (`▲`, `▼`, `✕`, inline `↻ Retry`).
|
|
- **Global Actions**: `Upload All (N)` button and `Clear Completed` / `Clear All`.
|
|
|
|
3. **Accounts & Auth Tab**:
|
|
- **Connected Accounts**: Interactive cards displaying connected usernames, server endpoints, custom labels, and active default status.
|
|
- **Browser Login (Login Flow v2)**: One-click interactive authorization opening your web browser with support for 2FA / SSO.
|
|
- **Manual App Password Entry**: Form for connecting with custom server URLs, usernames, and generated application tokens.
|
|
|
|
---
|
|
|
|
## 2. Step-by-Step Walkthrough
|
|
|
|
### Connecting Your First Account
|
|
1. Open the application and switch to the **Accounts & Auth** tab.
|
|
2. Enter your Nextcloud server URL (e.g. `https://cloud.example.com`).
|
|
3. Click **Authorize in Browser (Login Flow v2)**.
|
|
4. Your default browser opens the authorization page. Click **Grant Access**.
|
|
5. The GUI automatically polls and securely stores your token in your operating system's native keychain.
|
|
|
|
### Uploading Files & Creating Share Links
|
|
1. Navigate to the **Upload Queue** tab.
|
|
2. Drag and drop one or more files from Finder / Explorer / File Manager into the dropzone.
|
|
3. (Optional) Check **Generate public share link** and specify a **Share password** if needed.
|
|
4. Set the **Remote Directory** (e.g. `Projects/Assets` or `Uploads`).
|
|
5. Click **Upload All**.
|
|
6. Real-time progress bars update for both the total batch and each individual file.
|
|
7. Once finished:
|
|
- Click **Copy Link** to copy the public share URL to clipboard.
|
|
- Click **Copy Direct Download** to copy the raw download URL.
|
|
|
|
### Managing Failed Uploads
|
|
- If any file fails (e.g. due to network glitch or server quota), an error badge is displayed with details.
|
|
- Click the inline **↻ Retry** button next to that item to re-attempt the upload immediately without resetting the queue.
|