# at.atmosynth.sample

> Published by [atmosynth.at](https://lexicon.garden/identity/did:plc:fzjkahpwapmoqxybwdjb6ysf)

✓ This is the authoritative definition for this NSID.

## Description

A recording published to be found and used: a one-shot, a loop or a longer take, with what is known of its time and pitch. A recording used only inside an arrangement is a blob of that arrangement and needs no record; this is for sharing one.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:fzjkahpwapmoqxybwdjb6ysf/at.atmosynth.sample)
- [Documentation](https://lexicon.garden/lexicon/did:plc:fzjkahpwapmoqxybwdjb6ysf/at.atmosynth.sample/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:fzjkahpwapmoqxybwdjb6ysf/at.atmosynth.sample/examples)

## Definitions

### `at.atmosynth.sample`

**Type**: `record`

A sample, held in its creator's own repository.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `audio` | `blob` | Yes | The recording, in this record's own account. |
| `beats` | `integer` | No | How many beats a loop lasts, where `tempo` alone would leave it to rounding. Optional. |
| `createdAt` | `string` (datetime) | Yes |  |
| `description` | `string` | No |  |
| `key` | `ref` → `at.atmosynth.defs#key` | No | The key a melodic loop or take is in. Optional. |
| `kind` | `string` | No | `oneShot`: a single hit or note, played from a key. `loop`: a whole number of beats meant to repeat. `recording`: a longer take. Optional: absent says nothing of how it is meant to be used. |
| `license` | `ref` → `at.atmosynth.defs#license` | No |  |
| `lineage` | `array` | No |  |
| `name` | `string` | Yes | What its creator calls it. |
| `rootNote` | `integer` | No | The note a one-shot was recorded at, as a MIDI note number, so a key plays it at its own pitch. Optional. |
| `seconds` | `string` | No | How long it lasts, in seconds, as decimal text, so a listing can say so without fetching it. |
| `tags` | `array` | No | Freely created tags, lower-cased on write. |
| `tempo` | `string` | No | The tempo it was played at, in beats per minute from 20 to 999, as decimal text, from which a clip can be warped to an arrangement's. Optional: absent where it has none. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A sample, held in its creator's own repository.",
      "key": "tid",
      "record": {
        "properties": {
          "audio": {
            "accept": [
              "audio/wav",
              "audio/flac"
            ],
            "description": "The recording, in this record's own account.",
            "maxSize": 52428800,
            "type": "blob"
          },
          "beats": {
            "description": "How many beats a loop lasts, where `tempo` alone would leave it to rounding. Optional.",
            "minimum": 1,
            "type": "integer"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "maxLength": 3000,
            "type": "string"
          },
          "key": {
            "description": "The key a melodic loop or take is in. Optional.",
            "ref": "at.atmosynth.defs#key",
            "type": "ref"
          },
          "kind": {
            "description": "`oneShot`: a single hit or note, played from a key. `loop`: a whole number of beats meant to repeat. `recording`: a longer take. Optional: absent says nothing of how it is meant to be used.",
            "knownValues": [
              "oneShot",
              "loop",
              "recording"
            ],
            "maxLength": 32,
            "type": "string"
          },
          "license": {
            "ref": "at.atmosynth.defs#license",
            "type": "ref"
          },
          "lineage": {
            "items": {
              "ref": "at.atmosynth.defs#lineage",
              "type": "ref"
            },
            "maxLength": 64,
            "type": "array"
          },
          "name": {
            "description": "What its creator calls it.",
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          },
          "rootNote": {
            "description": "The note a one-shot was recorded at, as a MIDI note number, so a key plays it at its own pitch. Optional.",
            "maximum": 127,
            "minimum": 0,
            "type": "integer"
          },
          "seconds": {
            "description": "How long it lasts, in seconds, as decimal text, so a listing can say so without fetching it.",
            "maxLength": 32,
            "type": "string"
          },
          "tags": {
            "description": "Freely created tags, lower-cased on write.",
            "items": {
              "maxLength": 128,
              "type": "string"
            },
            "maxLength": 32,
            "type": "array"
          },
          "tempo": {
            "description": "The tempo it was played at, in beats per minute from 20 to 999, as decimal text, from which a clip can be warped to an arrangement's. Optional: absent where it has none.",
            "maxLength": 32,
            "type": "string"
          }
        },
        "required": [
          "name",
          "audio",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A recording published to be found and used: a one-shot, a loop or a longer take, with what is known of its time and pitch. A recording used only inside an arrangement is a blob of that arrangement and needs no record; this is for sharing one.",
  "id": "at.atmosynth.sample",
  "lexicon": 1
}
```