upleb.uk

Public git repos — served from a NIP-34 GRASP relay at git.upleb.uk

summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorzmeyer44 <54515037+zmeyer44@users.noreply.github.com>2023-12-09 12:55:25 -0500
committerGitHub <noreply@github.com>2023-12-09 12:55:25 -0500
commitcec99e7b13a823d08527790bd46297d545ddb881 (patch)
tree89d7a0fb8bb80bbd7a635c22dbf79fbd43e50526
parenta2914eed6d34d2e40ad2e361519bcd52300ef25e (diff)
Update 44.md
Updating to reference NIP-94 file metadata event
-rw-r--r--44.md26
1 files changed, 10 insertions, 16 deletions
diff --git a/44.md b/44.md
index 1c857c8..4a80c63 100644
--- a/44.md
+++ b/44.md
@@ -6,9 +6,9 @@ Video Events
6 6
7`draft` `optional` 7`draft` `optional`
8 8
9This specification defines video events representing a dedicated post of externally hosted content. These video events are _parameterized replaceable_ and deletable per [NIP-09](09.md). 9This specification defines video events representing a dedicated post of externally hosted content. These video events are _parameterized replaceable_ and deletable per [NIP-09](09.md). The content of a video event is the stringified JSON of a `kind 1063` File metadata event as described in [NIP-94](94.md).
10 10
11Unlike a `kind 1` event with a video attached, Video Events are meant to contain all necessary metadata concerning the media and to be surfaced in media specific clients rather than general micro-blogging clients. The thought is for events of this kind to be referenced in a YouTube like nostr client where the video itself is at the center of the experience. 11Unlike a `kind 1` event with a video attached, Video Events are meant to contain all additional metadata concerning the subject media and to be surfaced in video-specific clients rather than general micro-blogging clients. The thought is for events of this kind to be referenced in a Netflix, YouTube, or TikTok like nostr client where the video itself is at the center of the experience.
12 12
13## Video Events 13## Video Events
14 14
@@ -18,23 +18,20 @@ There are two types of video events represented by different kinds: horizontal a
18 18
19The format uses a parameterized replaceable event kind `34235` for horizontal videos and `34236` for vertical videos. 19The format uses a parameterized replaceable event kind `34235` for horizontal videos and `34236` for vertical videos.
20 20
21The `.content` of these events is optional and should be a summary of the video's contents. 21The `.content` of these events is the stringified JSON of a `kind 1063` file metadata event.
22 22
23The list of tags are as follows: 23The list of tags are as follows:
24* `d` (required) universally unique identifier (UUID). Generated by the client creating the video event. 24* `d` (required) universally unique identifier (UUID). Generated by the client creating the video event.
25* `e` (required, repeated) reference tag to kind 1063 file metadata event being posted, optional relay information for the file metadata event, optional quality value (low|medium|high)
25* `title` (required) title of the video 26* `title` (required) title of the video
26* `url` (required) a link to the video data
27* `m` (optional) the MIME type of the video data in the `src` tag
28* `summary` (optional) summary/description of the video (same as content) 27* `summary` (optional) summary/description of the video (same as content)
29* `image` (optional) url of preview image with same dimensions 28* `url` (optional) a default link to the video data
30* `thumb` (optional) url of thumbnail with same aspect ratio
31* `dim` (optional) size of file in pixels in the form <width>x<height>
32* `text-track` (optional, repeated) link to WebVTT file for video, type of supplementary information (captions/subtitles/chapters/metadata), optional language code 29* `text-track` (optional, repeated) link to WebVTT file for video, type of supplementary information (captions/subtitles/chapters/metadata), optional language code
30* `thumb` (optional) url of thumbnail with same aspect ratio
33* `content-warning` (optional) warning about content of NSFW video 31* `content-warning` (optional) warning about content of NSFW video
34* `alt` (optional) description for accessibility
35* `t` (optional, repeated) hashtag to categorize video 32* `t` (optional, repeated) hashtag to categorize video
36* `p` (optional, repeated) 32-bytes hex pubkey of a participant in the video, optional recommended relay URL 33* `p` (optional, repeated) 32-bytes hex pubkey of a participant in the video, optional recommended relay URL
37* `r` (optional, repeated) references / links to web pages. 34* `r` (optional, repeated) references / links to web pages
38 35
39```json 36```json
40{ 37{
@@ -42,22 +39,19 @@ The list of tags are as follows:
42 "pubkey": <32-bytes lowercase hex-encoded public key of the event creator>, 39 "pubkey": <32-bytes lowercase hex-encoded public key of the event creator>,
43 "created_at": <Unix timestamp in seconds>, 40 "created_at": <Unix timestamp in seconds>,
44 "kind": 34235 | 34236, 41 "kind": 34235 | 34236,
45 "content": "<summary of video>", 42 "content": "<stringified JSON of kind 1063 event>",
46 "tags": [ 43 "tags": [
47 ["d", "<UUID>"], 44 ["d", "<UUID>"],
45 ["e", "<hex-id>", "<relay-url>", "<optional quality value>"],
48 46
49 ["title", "<title of video>"], 47 ["title", "<title of video>"],
50 ["summary", "<summary of video>"], 48 ["summary", "<summary of video>"],
51 ["thumb", "<thumbnail image for video>"], 49 ["thumb", "<thumbnail image for video>"],
52 ["image", "<preview image for video>"],
53 ["alt", <description>],
54 50
55 // Video Data 51 // Video Data
56 ["url", "<url>"], 52 ["url", "<optional recommended url>"]
57 ["m", "<MIME type>"],
58 ["text-track", "<url>", "<text track type>", "<optional language>"], 53 ["text-track", "<url>", "<text track type>", "<optional language>"],
59 ["content-warning", "<reason>"], 54 ["content-warning", "<reason>"],
60 ["dim", <size of video in pixels>],
61 55
62 // Participants 56 // Participants
63 ["p", "<32-bytes hex of a pubkey>", "<optional recommended relay URL>"], 57 ["p", "<32-bytes hex of a pubkey>", "<optional recommended relay URL>"],