@@ -206,6 +207,10 @@ export function updateDownloadRow(row, download) {
setText(startButton.querySelector('[data-role="start-label"]'), starting ? 'Starting' : 'Start');
setProgressValue(row, 'putio-bar', 'putio-progress', putioProgress);
setProgressValue(row, 'local-bar', 'local-progress', localProgress);
+ const putioStatusMessage = putioStatusDetails(download);
+ const putioStatus = row.querySelector('[data-role="putio-status-message"]');
+ setText(putioStatus, putioStatusMessage);
+ setHidden(putioStatus, !putioStatusMessage);
populateFilePanel(row, download, fileItems);
}
@@ -751,3 +756,13 @@ export function downloadStatusText(download) {
}
return `${phase} ยท ${clampPercent(download.putioProgress)}%`;
}
+
+export function putioStatusDetails(download) {
+ const message = String(download.putioStatusMessage ?? '').trim();
+ if (message) return message;
+ if (download.lifecycle !== 'remote' || download.putioStatus !== 'DOWNLOADING') return '';
+
+ const peers = Math.max(0, Number(download.putioPeers ?? 0));
+ const peerText = peers > 0 ? `${peers} peer${peers === 1 ? '' : 's'}` : 'No peers';
+ return `${peerText} | availability: ${clampPercent(download.putioAvailability)}%`;
+}
diff --git a/src/web/styles/07-downloads.css b/src/web/styles/07-downloads.css
index 99c165d..6445c43 100644
--- a/src/web/styles/07-downloads.css
+++ b/src/web/styles/07-downloads.css
@@ -277,6 +277,13 @@
gap: 9px;
}
+.putio-status-message {
+ margin-left: 54px;
+ color: var(--muted);
+ font-size: 11.5px;
+ overflow-wrap: anywhere;
+}
+
.download-footer {
display: flex;
align-items: center;
diff --git a/test/download-metrics.test.js b/test/download-metrics.test.js
index 540c1cc..69f7bce 100644
--- a/test/download-metrics.test.js
+++ b/test/download-metrics.test.js
@@ -114,6 +114,31 @@ test('local download progress updates dashboard speed and ETA metrics', async ()
}
});
+test('put.io refresh exposes the transfer status message on the dashboard', async () => {
+ const harness = await createHarness([{
+ id: 70,
+ fileId: 80,
+ saveParentId: 42,
+ hash: 'putiostatushash',
+ name: 'Waiting Release',
+ status: 'DOWNLOADING',
+ statusMessage: 'Waiting for torrent details from the network...',
+ peers: 2,
+ availability: 11,
+ percentDone: 0,
+ }]);
+ try {
+ await harness.service.refreshRemoteTransfers();
+
+ const [download] = harness.service.listDownloads();
+ assert.equal(download.putioStatusMessage, 'Waiting for torrent details from the network...');
+ assert.equal(download.putioPeers, 2);
+ assert.equal(download.putioAvailability, 11);
+ } finally {
+ harness.store.close();
+ }
+});
+
test('dashboard reports multi-file progress details', async () => {
const harness = await createHarness();
try {
diff --git a/test/putio-client.test.js b/test/putio-client.test.js
index 14a085a..abc4ac0 100644
--- a/test/putio-client.test.js
+++ b/test/putio-client.test.js
@@ -124,6 +124,20 @@ test('PutioClient normalizes transfer and file endpoints', async () => {
assert.equal(calls.at(-1).url, 'https://api.put.io/v2/files/delete');
});
+test('normalizeTransfer keeps Put.io status details', () => {
+ const transfer = normalizeTransfer({
+ id: 22,
+ status: 'DOWNLOADING',
+ status_message: 'Waiting for torrent details from the network...',
+ peers: 2,
+ availability: 11,
+ });
+
+ assert.equal(transfer.statusMessage, 'Waiting for torrent details from the network...');
+ assert.equal(transfer.peers, 2);
+ assert.equal(transfer.availability, 11);
+});
+
test('PutioClient handles folder creation and transfer edge cases', async () => {
const missingFolder = createFetch([
{ body: { files: [] } },
diff --git a/test/state-store.test.js b/test/state-store.test.js
index a162302..af526f2 100644
--- a/test/state-store.test.js
+++ b/test/state-store.test.js
@@ -65,6 +65,36 @@ test('createOrUpdateTransfer persists put.io completion_percent across updates',
}
});
+test('createOrUpdateTransfer persists put.io status details across updates', () => {
+ const store = new StateStore(':memory:');
+ try {
+ const created = store.createOrUpdateTransfer({
+ putio_transfer_id: 12,
+ hash: 'statusmessagehash',
+ name: 'Waiting Transfer',
+ putio_status: 'DOWNLOADING',
+ putio_status_message: 'Waiting for torrent details from the network...',
+ putio_peers: 0,
+ putio_availability: 0,
+ });
+ assert.equal(created.putio_status_message, 'Waiting for torrent details from the network...');
+
+ const updated = store.createOrUpdateTransfer({
+ putio_transfer_id: 12,
+ hash: 'statusmessagehash',
+ putio_status_message: '',
+ putio_peers: 2,
+ putio_availability: 11,
+ });
+ assert.equal(updated.id, created.id);
+ assert.equal(updated.putio_status_message, '');
+ assert.equal(updated.putio_peers, 2);
+ assert.equal(updated.putio_availability, 11);
+ } finally {
+ store.close();
+ }
+});
+
test('profile rows migrate local_path to downloadAt', async () => {
const root = await mkdtemp(path.join(tmpdir(), 'putiorr-store-'));
const dbPath = path.join(root, 'state.sqlite');
diff --git a/test/web-download-testids.test.js b/test/web-download-testids.test.js
index b810f55..04b22e4 100644
--- a/test/web-download-testids.test.js
+++ b/test/web-download-testids.test.js
@@ -25,3 +25,11 @@ test('downloads UI exposes stable data-testid hooks for frontend tests', () => {
assert.match(source, new RegExp(`data-testid=["']${testId}["']|['"]data-testid['"], ['"]${testId}['"]`));
}
});
+
+test('downloads UI renders Put.io status messages or peer availability below the progress bars', () => {
+ const downloadsJs = readFileSync(new URL('../src/web/downloads.js', import.meta.url), 'utf8');
+
+ assert.match(downloadsJs, /data-role="putio-status-message"/);
+ assert.match(downloadsJs, /\$\{peerText\} \| availability: \$\{clampPercent\(download\.putioAvailability\)\}%/);
+ assert.doesNotMatch(downloadsJs, /putioDownloaded|putioUploaded/);
+});