Skip to content

Commit 6a4b125

Browse files
authored
nip71: make video events regular (#1704)
1 parent f440eac commit 6a4b125

File tree

4 files changed

+24
-24
lines changed

4 files changed

+24
-24
lines changed

51.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ Aside from their main identifier, the `"d"` tag, sets can optionally have a `"ti
5050
| Relay sets | 30002 | user-defined relay groups the user can easily pick and choose from during various operations | `"relay"` (relay URLs) |
5151
| Bookmark sets | 30003 | user-defined bookmarks categories , for when bookmarks must be in labeled separate groups | `"e"` (kind:1 notes), `"a"` (kind:30023 articles), `"t"` (hashtags), `"r"` (URLs) |
5252
| Curation sets | 30004 | groups of articles picked by users as interesting and/or belonging to the same category | `"a"` (kind:30023 articles), `"e"` (kind:1 notes) |
53-
| Curation sets | 30005 | groups of videos picked by users as interesting and/or belonging to the same category | `"a"` (kind:34235 videos) |
53+
| Curation sets | 30005 | groups of videos picked by users as interesting and/or belonging to the same category | `"a"` (kind:21 videos) |
5454
| Kind mute sets | 30007 | mute pubkeys by kinds<br>`"d"` tag MUST be the kind string | `"p"` (pubkeys) |
5555
| Interest sets | 30015 | interest topics represented by a bunch of "hashtags" | `"t"` (hashtags) |
5656
| Emoji sets | 30030 | categorized emoji groups | `"emoji"` (see [NIP-30](30.md)) |

68.md

+3-3
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ The idea is for this type of event to cater to Nostr clients resembling platform
1212

1313
## Picture Events
1414

15-
Picture events contain a `title` tag and description in the `.content`.
15+
Picture events contain a `title` tag and description in the `.content`.
1616

1717
They may contain multiple images to be displayed as a single post.
1818

@@ -81,12 +81,12 @@ They may contain multiple images to be displayed as a single post.
8181

8282
The `imeta` tag `annotate-user` places a user link in the specific position in the image.
8383

84-
Only the following media types are accepted:
84+
Only the following media types are accepted:
8585
- `image/apng`: Animated Portable Network Graphics (APNG)
8686
- `image/avif`: AV1 Image File Format (AVIF)
8787
- `image/gif`: Graphics Interchange Format (GIF)
8888
- `image/jpeg`: Joint Photographic Expert Group image (JPEG)
8989
- `image/png`: Portable Network Graphics (PNG)
9090
- `image/webp`: Web Picture format (WEBP)
9191

92-
Picture events might be used with [NIP-71](71.md)'s kind `34236` to display short vertical videos in the same feed.
92+
Picture events might be used with [NIP-71](71.md)'s kind `22` to display short vertical videos in the same feed.

71.md

+16-16
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,19 @@ Video Events
66

77
`draft` `optional`
88

9-
This specification defines video events representing a dedicated post of externally hosted content. These video events are _addressable_ and delete-requestable per [NIP-09](09.md).
9+
This specification defines _video_ events representing a dedicated post of externally hosted content.
1010

11-
Unlike 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.
11+
Unlike 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.
1212

1313
## Video Events
1414

15-
There are two types of video events represented by different kinds: horizontal and vertical video events. This is meant to allow clients to cater to each as the viewing experience for horizontal (landscape) videos is often different than that of vertical (portrait) videos (Stories, Reels, Shorts, etc).
15+
There are two types of video events represented by different kinds: _normal_ and _short_ video events. This is meant to allow clients to cater to each as the viewing experience for longer, mostly horizontal (landscape) videos is often different than that of short-form, mostly vertical (portrait), videos ("stories", "reels", "shorts" etc).
16+
17+
Nothing except cavaliership and common sense prevents a _short_ video from being long, or a _normal_ video from being vertical, and that may or may not be justified, it's mostly a stylistic qualitative difference, not a question of actual raw size.
1618

1719
#### Format
1820

19-
The format uses an _addressable event_ kind `34235` for horizontal videos and `34236` for vertical videos.
21+
The format uses a _regular event_ kind `21` for _normal_ videos and `22` for _short_ videos.
2022

2123
The `.content` of these events is a summary or description on the video content.
2224

@@ -27,7 +29,7 @@ Each `imeta` tag can be used to specify a variant of the video by the `dim` & `m
2729
Example:
2830
```json
2931
[
30-
["imeta",
32+
["imeta",
3133
"dim 1920x1080",
3234
"url https://myvideo.com/1080/12345.mp4",
3335
"x 3093509d1e0bc604ff60cb9286f4cd7c781553bc8991937befaacfdc28ec5cdc",
@@ -38,7 +40,7 @@ Example:
3840
"fallback https://andanotherserver.com/1080/12345.mp4",
3941
"service nip96",
4042
],
41-
["imeta",
43+
["imeta",
4244
"dim 1280x720",
4345
"url https://myvideo.com/720/12345.mp4",
4446
"x e1d4f808dae475ed32fb23ce52ef8ac82e3cc760702fca10d62d382d2da3697d",
@@ -49,7 +51,7 @@ Example:
4951
"fallback https://andanotherserver.com/720/12345.mp4",
5052
"service nip96",
5153
],
52-
["imeta",
54+
["imeta",
5355
"dim 1280x720",
5456
"url https://myvideo.com/720/12345.m3u8",
5557
"x 704e720af2697f5d6a198ad377789d462054b6e8d790f8a3903afbc1e044014f",
@@ -86,17 +88,15 @@ Additionally `service nip96` may be included to allow clients to search the auth
8688
"id": <32-bytes lowercase hex-encoded SHA-256 of the the serialized event data>,
8789
"pubkey": <32-bytes lowercase hex-encoded public key of the event creator>,
8890
"created_at": <Unix timestamp in seconds>,
89-
"kind": 34235 | 34236,
91+
"kind": 21 | 22,
9092
"content": "<summary / description of video>",
9193
"tags": [
92-
["d", "<UUID>"],
93-
9494
["title", "<title of video>"],
9595
["published_at", "<unix timestamp>"],
9696
["alt", <description>],
9797

98-
// Video Data
99-
["imeta",
98+
// video Data
99+
["imeta",
100100
"dim 1920x1080",
101101
"url https://myvideo.com/1080/12345.mp4",
102102
"x 3093509d1e0bc604ff60cb9286f4cd7c781553bc8991937befaacfdc28ec5cdc",
@@ -113,17 +113,17 @@ Additionally `service nip96` may be included to allow clients to search the auth
113113
["content-warning", "<reason>"],
114114
["segment", <start>, <end>, "<title>", "<thumbnail URL>"],
115115

116-
// Participants
116+
// participants
117117
["p", "<32-bytes hex of a pubkey>", "<optional recommended relay URL>"],
118118
["p", "<32-bytes hex of a pubkey>", "<optional recommended relay URL>"],
119119

120-
// Hashtags
120+
// hashtags
121121
["t", "<tag>"],
122122
["t", "<tag>"],
123123

124-
// Reference links
124+
// reference links
125125
["r", "<url>"],
126126
["r", "<url>"]
127127
]
128128
}
129-
```
129+
```

README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -122,6 +122,8 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
122122
| `16` | Generic Repost | [18](18.md) |
123123
| `17` | Reaction to a website | [25](25.md) |
124124
| `20` | Picture | [68](68.md) |
125+
| `21` | Video Event | [71](71.md) |
126+
| `22` | Short-form Portrait Video Event | [71](71.md) |
125127
| `40` | Channel Creation | [28](28.md) |
126128
| `41` | Channel Metadata | [28](28.md) |
127129
| `42` | Channel Message | [28](28.md) |
@@ -227,10 +229,8 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
227229
| `31924` | Calendar | [52](52.md) |
228230
| `31925` | Calendar Event RSVP | [52](52.md) |
229231
| `31989` | Handler recommendation | [89](89.md) |
230-
| `31990` | Handler information | [89](89.md) |
231-
| `32267` | Software Application | |
232-
| `34235` | Video Event | [71](71.md) |
233-
| `34236` | Short-form Portrait Video Event | [71](71.md) |
232+
| `31990` | Handler information | [89](89.md) | |
233+
| `32267` | Software Application | | |
234234
| `34550` | Community Definition | [72](72.md) |
235235
| `37375` | Cashu Wallet Event | [60](60.md) |
236236
| `38383` | Peer-to-peer Order events | [69](69.md) |

0 commit comments

Comments
 (0)