← The board

H1 Cross-seeding

Area
H — Ecosystem glue
Audience
operator
Kind
feature
Status
accepted
Maturity
planned
Labels
seed, storage, wiring, verification
Relates to
C5D1

The feature in the specification · Read at

Requirements

  1. H1-R1acceptedMUST

    The cross-seeding service and every indexer it depends on MUST be open-source and self-hostable; the tool MUST NOT depend on any hosted or proprietary matching service.

    locked by
    0.20.0 open
  2. H1-R2acceptedMUST

    The tool MUST wire the torrent client and the configured indexers via their APIs, and MUST NOT require the operator to copy credentials between web interfaces.

    locked by
    0.20.0 open
  3. H1-R3acceptedMUST

    A candidate MUST be confirmed as a cross-seed by matching the underlying data (files, sizes, and piece hashes where available), not by title alone.

    locked by
    0.20.0 open
  4. H1-R4acceptedMUST

    A confirmed match MUST be added by reusing the existing on-disk files; the tool MUST NOT re-download or copy the payload.

    locked by
    0.20.0 open
  5. H1-R5acceptedMUST

    Before adding a match, the tool MUST verify that the source files and the seed path share one filesystem, and MUST refuse the link rather than fall back to copying across a device boundary.

    locked by
    0.20.0 open
  6. H1-R6acceptedMUST

    Where a separate seed directory is required, files MUST be linked using the same inode discipline as C5, and the resulting link MUST share an inode with its source.

    locked by
    0.20.0 open
  7. H1-R7acceptedMUST

    The tool MUST prove the wiring empirically: a service ping, an accepted-credential check for the client and each indexer, and a test search returning a match for a known local item.

    locked by
    0.20.0 open
  8. H1-R8acceptedMUST

    A configuration that cannot demonstrate a real match against real local data MUST be reported as unproven, never as ready.

    locked by
    0.20.0 open
  9. H1-R9acceptedMUST

    A layout mismatch (enclosing folder present on one side, extra small files) MUST be reported as a near-miss rather than counted as a match.

    locked by
    0.20.0 open
  10. H1-R10acceptedMUST

    A partial data match MUST NOT be added as a full seed, and the missing pieces MUST be reported.

    locked by
    0.20.0 open
  11. H1-R11acceptedMUST

    An indexer that becomes unreachable mid-pass MUST be marked failed for that pass while the remaining indexers continue.

    locked by
    0.20.0 open
  12. H1-R12acceptedMUST

    A per-tracker cross-seed exclusion MUST be honoured, and a duplicate of data already seeding on a tracker MUST be skipped.

    locked by
    0.20.0 open
  13. H1-R13acceptedMUST

    A revoked or rotated client credential MUST fail the credential proof loudly and halt further additions until re-proven.

    locked by
    0.20.0 open
  14. H1-R14acceptedMUST

    Triggering a search, listing matches, and running the wiring proof MUST each be reachable non-interactively.

    locked by
    0.20.0 open