ray
96 lines
3.3 KiB
Markdown
96 lines
3.3 KiB
Markdown
# Import Progress Reference
|
|
|
|
> Companion for the `immich-server` skill. Documents what to expect during and after a large immich-go import.
|
|
|
|
## immich-go Progress Output
|
|
|
|
When running immich-go `from-google-photos`, output scrolls like:
|
|
|
|
```
|
|
Immich read 100%, Assets found: 18595, Upload errors: 0, Uploaded 2735
|
|
Immich read 100%, Assets found: 18595, Upload errors: 0, Uploaded 2742
|
|
...
|
|
```
|
|
|
|
Key fields:
|
|
- **Assets found** — total photos/videos detected (excludes .json sidecars)
|
|
- **Uploaded** — running count of files sent to Immich
|
|
- **Upload errors** — should stay 0; if non-zero, check the server logs
|
|
|
|
### Final Summary Format
|
|
|
|
```
|
|
Asset Tracking Report:
|
|
=====================
|
|
Total Assets: 18595 (183.1 GB)
|
|
Processed: 16590 (149.9 GB)
|
|
Discarded: 1987 (33.2 GB)
|
|
Errors: 0 (0 B)
|
|
Pending: 18 (35.2 MB)
|
|
|
|
Event Report:
|
|
=============
|
|
Discovery (Assets):
|
|
discovered image : 17805 (44.8 GB)
|
|
discovered video : 790 (138.3 GB)
|
|
|
|
Discovery (Non-Assets):
|
|
discovered sidecar : 18377 (13.8 MB)
|
|
discovered unknown file : 1046 (-)
|
|
discovered unsupported file : 244 (208.9 MB)
|
|
|
|
Asset Lifecycle (PROCESSED):
|
|
uploaded successfully : 16401 (148.7 GB)
|
|
server asset upgraded : 101 (907.2 MB)
|
|
metadata updated : 16502 (355.2 MB)
|
|
|
|
Asset Lifecycle (DISCARDED):
|
|
discarded local duplicate : 2062 (33.5 GB)
|
|
|
|
Processing Events:
|
|
associated metadata : 18577
|
|
missing metadata : 18
|
|
stacked : 459
|
|
added to album : 933
|
|
tagged : 29069
|
|
```
|
|
|
|
**What the sections mean:**
|
|
- **Processed** vs **Discarded** — processed = newly uploaded, discarded = already existed on server (deduplicated by content hash)
|
|
- **Pending** (18) — 18 assets that didn't reach a final state. Usually harmless edge case; those files likely uploaded but the status check didn't confirm before the tool exited. Manually verify by checking Immich's asset count after processing finishes.
|
|
- **added to album** (933) — Google Photos albums recreated in Immich
|
|
- **tagged** (29069) — people tags from Google Photos applied
|
|
- **stacked** (459) — burst photos grouped into stacks
|
|
|
|
## Monitoring During Import
|
|
|
|
For background processes (via Hermes terminal background=true):
|
|
|
|
```python
|
|
# Check progress with poll()
|
|
process(action="poll", session_id="proc_xxx")
|
|
|
|
# When the imported finishes, capture the full output:
|
|
process(action="log", session_id="proc_xxx")
|
|
```
|
|
|
|
## Sample Job Queue After Large Import
|
|
|
|
After importing ~18,595 assets (16,401 new), expect queues like:
|
|
|
|
```
|
|
🟢 thumbnailGeneration: 3 active, 890 waiting
|
|
🟢 metadataExtraction: 5 active, 10587 waiting
|
|
🟢 videoConversion: 1 active, 260 waiting
|
|
🟢 smartSearch: 2 active, 2574 waiting
|
|
🟢 faceDetection: 2 active, 6698 waiting
|
|
🟢 facialRecognition: 1 active, 4358 waiting
|
|
🟢 ocr: 1 active, 8421 waiting
|
|
🟢 storageTemplateMigration: 1 active, 825 waiting
|
|
```
|
|
|
|
Processing all jobs on a 4-core i5-6500T with 7GB RAM takes approximately:
|
|
- Thumbnails + metadata: 2-4 hours
|
|
- Smart search (CLIP), face rec, OCR: 12-24 hours each
|
|
- Video conversion: 10-20 hours (if enabled)
|