# quest.sableye.magnet.entry

> Published by [matt.evil.gay](https://lexicon.garden/identity/did:plc:tas6hj2xjrqben5653v5kohk)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:tas6hj2xjrqben5653v5kohk/quest.sableye.magnet.entry)
- [Documentation](https://lexicon.garden/lexicon/did:plc:tas6hj2xjrqben5653v5kohk/quest.sableye.magnet.entry/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:tas6hj2xjrqben5653v5kohk/quest.sableye.magnet.entry/examples)

## Definitions

### `quest.sableye.magnet.entry`

**Type**: `record`

A magnet link entry in the Sableye tracker index.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | Yes | Display name / title for the torrent. |
| `tags` | `array` | No | Categorization tags. |
| `infoHash` | `string` | No | The info hash extracted from the magnet URI, hex-encoded. |
| `createdAt` | `string` (datetime) | Yes |  |
| `fileCount` | `integer` | No | Number of files in the torrent, if known. |
| `magnetUri` | `string` | Yes | The magnet URI (magnet:?xt=urn:btih:...) |
| `sizeBytes` | `integer` | No | Total size in bytes, if known. |
| `description` | `string` | No | Optional longer description. |
| `torrentFile` | `blob` | No | Optional .torrent file stored on the author's PDS. |

## Raw Schema

```json
{
  "id": "quest.sableye.magnet.entry",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "magnetUri",
          "name",
          "createdAt"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 512,
            "description": "Display name / title for the torrent.",
            "maxGraphemes": 256
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 128,
              "maxGraphemes": 64
            },
            "maxLength": 16,
            "description": "Categorization tags."
          },
          "infoHash": {
            "type": "string",
            "maxLength": 64,
            "description": "The info hash extracted from the magnet URI, hex-encoded."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "fileCount": {
            "type": "integer",
            "description": "Number of files in the torrent, if known."
          },
          "magnetUri": {
            "type": "string",
            "maxLength": 2048,
            "description": "The magnet URI (magnet:?xt=urn:btih:...)"
          },
          "sizeBytes": {
            "type": "integer",
            "description": "Total size in bytes, if known."
          },
          "description": {
            "type": "string",
            "maxLength": 10000,
            "description": "Optional longer description.",
            "maxGraphemes": 5000
          },
          "torrentFile": {
            "type": "blob",
            "accept": [
              "application/x-bittorrent",
              "application/octet-stream"
            ],
            "maxSize": 5242880,
            "description": "Optional .torrent file stored on the author's PDS."
          }
        }
      },
      "description": "A magnet link entry in the Sableye tracker index."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```