# Progress & Tasks: Monitor Your Transfers

> Start workflows, monitor transfers, and control running tasks in Blober.

The Progress page is your control center for running transfers. Start workflows, monitor real-time progress, and manage running tasks.

## Understanding Tasks

When you start a workflow, Blober creates a **task**. A task is a single execution of a workflow that tracks:

* Which files need to be transferred
* Current progress (files and bytes)
* Status of each file
* Logs and error messages

### Workflow vs Task

| Concept      | Description                                       | Persistence             |
| ------------ | ------------------------------------------------- | ----------------------- |
| **Workflow** | Saved configuration (source, destination, action) | Permanent until deleted |
| **Task**     | Single execution of a workflow                    | Kept for history        |

You can run the same workflow multiple times, creating a new task each time.

## Starting a Workflow

### From the Progress Page

1. Go to the **Progress** page
2. Find the workflow you want to run
3. Click **Start**
4. A new task is created and begins executing

### What Happens When You Start

1. **Enumeration** - Blober lists all files matching your source criteria
2. **Filtering** - Filters are applied to include/exclude files
3. **Transfer** - Files are processed one by one
4. **Completion** - Task status changes to completed or failed

## Controlling Tasks

### Pause a Running Task

1. Find the running task
2. Click **Pause**
3. The task pauses after the current file completes
4. State changes to **Paused**

**Why pause?**

* Free up bandwidth for other work
* Investigate an issue without losing progress
* Resume later when convenient

### Resume a Paused Task

1. Find the paused task
2. Click **Resume**
3. Task continues from where it left off
4. State changes to **Running**

### Cancel a Task

1. Find the task (running or paused)
2. Click **Cancel**
3. Task moves to **Stopping** state
4. After cleanup, state changes to **Cancelled**

**What happens to files?**

* Files already transferred remain at destination
* The current file may be partially transferred
* Source files are unchanged (unless Move action completed for some files)

## Progress Indicators

### Task Progress

Each task shows real-time progress:

| Metric           | Description                |
| ---------------- | -------------------------- |
| **Files**        | `X / Y` files processed    |
| **Size**         | `X MB / Y MB` transferred  |
| **Progress Bar** | Visual percentage complete |

### File-Level Progress

For large files, you may see:

* Current file being transferred
* Bytes transferred for current file
* Transfer speed

## Viewing Logs

Each task maintains a log of operations:

### Log Entries

| Entry Type  | Description                                 |
| ----------- | ------------------------------------------- |
| **Info**    | Normal operations (file started, completed) |
| **Warning** | Non-fatal issues (retry, skip)              |
| **Error**   | Problems that caused failures               |

## File States

Within a task, each file has its own status:

| Status         | Description                    |
| -------------- | ------------------------------ |
| **Pending**    | File queued for processing     |
| **Processing** | Currently being transferred    |
| **Processed**  | Successfully transferred       |
| **Failed**     | Transfer failed for this file  |
| **Retrying**   | Attempting again after failure |
| **Paused**     | Waiting for task to resume     |

## Error Handling

### Automatic Retries

Blober automatically retries failed operations:

* Network timeouts
* Rate limiting (429 errors)
* Temporary API errors

### Common Errors

| Error                     | Cause                        | Solution                       |
| ------------------------- | ---------------------------- | ------------------------------ |
| **Authentication Failed** | Invalid credentials          | Update credentials in workflow |
| **Permission Denied**     | Insufficient access rights   | Check provider permissions     |
| **Not Found**             | Source file no longer exists | Skip or re-run workflow        |
| **Quota Exceeded**        | Storage limit reached        | Free up space or upgrade plan  |
| **Network Error**         | Connection issues            | Check internet, retry          |

### Partial Failures

If some files fail:

* Successfully transferred files remain at destination
* Failed files are logged with error messages
* You can create a new task to retry

## Task History

Completed and cancelled tasks remain visible:

* Review what was transferred
* Check for errors
* Reference for troubleshooting

## Performance Tips

### Optimize Transfer Speed

1. **Use a wired connection** - More stable than WiFi
2. **Close other applications** - Free up bandwidth and CPU
3. **Transfer during off-peak hours** - Less network congestion
4. **Choose nearby regions** - For cloud providers, pick closest region

### Large Transfers

For transfers with thousands of files:

* Expect initial enumeration to take time
* Progress will be slow at first, then speed up
* Consider breaking into smaller batches

### Resumable Transfers

If a task is interrupted:

1. Don't delete the task
2. Click **Resume** to continue
3. Blober skips already-transferred files

## Troubleshooting

### Task Stuck on "Pending"

* Check if another task is running
* Verify internet connection
* Restart the app if needed

### Transfer Very Slow

* Check your internet speed
* Verify provider isn't rate-limiting
* Try smaller batch sizes

### Task Failed Immediately

* Check credentials in the workflow
* Verify source path exists
* Check destination has write access

### Files Missing at Destination

* Verify path template is correct
* Check filters aren't excluding files
* Look in subfolders (if using path templates)