Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
acb65f4214 | ||
|
|
8a2b384d7a | ||
|
|
8e650605f8 | ||
|
|
56c2cee10c | ||
|
|
71e2d941e1 | ||
|
|
9a2ae04f03 | ||
|
|
574331c265 | ||
|
|
458695c319 | ||
|
|
0ed609fe0b | ||
|
|
1893674356 | ||
|
|
69498079c3 | ||
|
|
fbfb2a995b | ||
|
|
4405d546e1 | ||
|
|
6c19532a09 | ||
|
|
9773035069 | ||
|
|
de423ff072 | ||
|
|
7f68c04ade | ||
|
|
9070b38d4f | ||
|
|
833841a8d9 | ||
|
|
80a9ec5756 | ||
|
|
1608276446 | ||
|
|
45cce47335 | ||
|
|
3ad4f0b8e9 | ||
|
|
32d4c933a0 | ||
|
|
80b4335990 | ||
|
|
5a128dfcaa | ||
|
|
bb3cd71e85 | ||
|
|
070c89c2d0 | ||
|
|
f4f50ba274 | ||
|
|
1bf49bbd0c | ||
|
|
777339c2d0 | ||
|
|
e4ff8cf279 | ||
|
|
fe2d7125b9 | ||
|
|
fcb0316e80 | ||
|
|
e5bea5971b | ||
|
|
8b7641c4ba | ||
|
|
cffe5201e6 | ||
|
|
2a0cfa3afc | ||
|
|
00d5293bb7 | ||
|
|
71f14ceb5d | ||
|
|
39fa9eafe8 | ||
|
|
4b3d64b539 | ||
|
|
07ddd3ec8c | ||
|
|
5e9c787131 | ||
|
|
1e407fc05e | ||
|
|
e1b25759de | ||
|
|
4184565130 | ||
|
|
09bf8e17dc | ||
|
|
f35065a1e0 | ||
|
|
df27eb34cf | ||
|
|
19178f65c5 | ||
|
|
40e5050f29 | ||
|
|
4f6f53b3b4 | ||
|
|
63fbc775dd | ||
|
|
fa709ceb61 | ||
|
|
761fae733c | ||
|
|
4213ab2fe8 | ||
|
|
c828c51d21 | ||
|
|
885095674f | ||
|
|
b3b458b0ae | ||
|
|
1eba32766a | ||
|
|
f1cb6b5375 | ||
|
|
49a335b004 | ||
|
|
6fa7452ceb | ||
|
|
ae68e527d5 | ||
|
|
07207d2940 | ||
|
|
f2037c23ca | ||
|
|
61ae1cc74e | ||
|
|
66b2b3449f | ||
|
|
f3f36c888f | ||
|
|
b908241a19 | ||
|
|
10a2ee1d92 | ||
|
|
c9e18f12e7 | ||
|
|
d22eb5c470 | ||
|
|
d33af68580 | ||
|
|
3b5781c5ad | ||
|
|
92c322c058 | ||
|
|
03e42ae5b5 | ||
|
|
a15e23bef8 | ||
|
|
5282362872 | ||
|
|
22f868b02b | ||
|
|
2f826a7591 | ||
|
|
094393d3cf | ||
|
|
608dcfba6e | ||
|
|
cf51095ddd | ||
|
|
7b67a564e2 | ||
|
|
722b497bdd | ||
|
|
2dcaf34e1b | ||
|
|
5956c97320 | ||
|
|
ad88b1723a | ||
|
|
0cd1de2d7d | ||
|
|
b48dc1b5c6 | ||
|
|
e598289ddb | ||
|
|
ae5971257e | ||
|
|
d0b22ad61d | ||
|
|
115a26adc3 | ||
|
|
bdf237e3a6 | ||
|
|
5e9b67d106 | ||
|
|
949eb314ed | ||
|
|
b39da33cff | ||
|
|
3b10c58bac | ||
|
|
af115170ac | ||
|
|
dc78fcccf0 | ||
|
|
4819391345 | ||
|
|
910dce021d | ||
|
|
b35adbe8cd | ||
|
|
694fb08c4a | ||
|
|
8104011dc6 | ||
|
|
f1a2031992 | ||
|
|
8b7ff05b74 | ||
|
|
c3f5e471a2 | ||
|
|
581b67789c | ||
|
|
ca37bb7db7 | ||
|
|
3811cd42c3 | ||
|
|
6bf1b6b3e6 | ||
|
|
fec6acae45 | ||
|
|
bc71f416ca | ||
|
|
f907de154a | ||
|
|
0da268e3b0 | ||
|
|
2087dbe913 | ||
|
|
c6127c1557 | ||
|
|
8e040895f9 | ||
|
|
4d60511d32 | ||
|
|
fb0a0367ab | ||
|
|
0a886dd26f | ||
|
|
fbe7519cde | ||
|
|
22187e50dd | ||
|
|
2d63278d64 | ||
|
|
fac4f4fb54 | ||
|
|
6f7546664f | ||
|
|
5bf007855d | ||
|
|
2e116b7531 | ||
|
|
8a9d294213 | ||
|
|
f9ce181762 | ||
|
|
7dfe448bf1 | ||
|
|
9d32439bb0 | ||
|
|
ac60239d6c | ||
|
|
2acd2b5795 | ||
|
|
2cdc457dd8 | ||
|
|
f876c0d553 | ||
|
|
a52358a08e | ||
|
|
7a3017641e | ||
|
|
18987a2a39 | ||
|
|
6630a42d28 | ||
|
|
4143398ba5 | ||
|
|
b8c14e50e8 | ||
|
|
f0e50b43c3 | ||
|
|
7870d90e21 | ||
|
|
d1274fa9c6 | ||
|
|
d4b2f00d15 | ||
|
|
01c69f9193 | ||
|
|
bfd3be01e3 | ||
|
|
e437bacf7b | ||
|
|
e6d1a9d5f3 | ||
|
|
2abc80a56c | ||
|
|
0a5bed7898 | ||
|
|
27dde7759e | ||
|
|
aeda3643d1 | ||
|
|
e53afefebe | ||
|
|
2441832038 | ||
|
|
c10333f978 | ||
|
|
4b7b1e7b6c | ||
|
|
33c4fc8835 | ||
|
|
2683be9621 | ||
|
|
dc6e3ddd3a | ||
|
|
e0c8a455ab | ||
|
|
5b4c6b1cdb | ||
|
|
a4de2d04ff | ||
|
|
fdf2e8f163 | ||
|
|
b144266661 | ||
|
|
c00ab8325b | ||
|
|
7d65d1034d | ||
|
|
3a7004e2f7 | ||
|
|
2db1345278 | ||
|
|
2e0ed9e9c1 | ||
|
|
46d750817b | ||
|
|
a34db836ec | ||
|
|
0861b20a7a | ||
|
|
28690cb2a2 | ||
|
|
1582b19be1 | ||
|
|
e5af43bfcc | ||
|
|
38150d6e4d | ||
|
|
52dc451832 | ||
|
|
f9daad4428 | ||
|
|
919c466f24 | ||
|
|
f74f788117 | ||
|
|
dd32bb88a6 | ||
|
|
253dd9c021 | ||
|
|
3da61fd346 | ||
|
|
fa29463ef4 | ||
|
|
b590cbf68c | ||
|
|
965e7a0374 | ||
|
|
30f8d3f9e0 | ||
|
|
4dbff0617f | ||
|
|
be5f70acb9 | ||
|
|
c2a12e95a5 | ||
|
|
f915907984 | ||
|
|
96bd3a5f36 | ||
|
|
6356db6432 | ||
|
|
aa221c1736 | ||
|
|
be0d96e566 | ||
|
|
cb3b61f686 | ||
|
|
e5b22970a7 | ||
|
|
b4fa705c1f | ||
|
|
3a7f3835e6 | ||
|
|
94c8dc266d | ||
|
|
e8855252ca | ||
|
|
019e2bf77f | ||
|
|
ab2f9a7737 | ||
|
|
0341ea9a47 | ||
|
|
b08db34594 | ||
|
|
f8f7b53feb | ||
|
|
fc9ffcfbd5 | ||
|
|
e0fb982927 | ||
|
|
599561fc70 | ||
|
|
0b78e95dc5 | ||
|
|
3f11de8b22 | ||
|
|
a023f40f68 | ||
|
|
4500473bd6 | ||
|
|
b68d0413eb | ||
|
|
4e86fc438b | ||
|
|
c5ca08d456 | ||
|
|
2484e5302f | ||
|
|
66632f320f | ||
|
|
84f3011e8e | ||
|
|
e8b7e97b08 | ||
|
|
08cf1be4de | ||
|
|
a7d392a002 | ||
|
|
f0285ec3c9 | ||
|
|
ea923b3a70 | ||
|
|
d63c41b7cd | ||
|
|
b3cc0bdd29 | ||
|
|
0793061e5b | ||
|
|
6cc956c45e | ||
|
|
060f83037d | ||
|
|
bec8919fed | ||
|
|
ef48bb3774 | ||
|
|
572b410e6e | ||
|
|
65c80f68ec | ||
|
|
c5af88ef3f | ||
|
|
fc5d917ba5 | ||
|
|
9611cf9879 | ||
|
|
757a6075e2 | ||
|
|
708c582bb8 | ||
|
|
32b8336497 | ||
|
|
4f90bdb590 | ||
|
|
22cbe88d94 | ||
|
|
1566bdd55d | ||
|
|
bf37953720 | ||
|
|
e87a699f65 | ||
|
|
6d97e37a37 | ||
|
|
19b0ec8cd5 | ||
|
|
2e00846c41 | ||
|
|
8ebc870961 | ||
|
|
3f7cacf908 | ||
|
|
db21aacfc9 | ||
|
|
8be791211a | ||
|
|
bf1932384d | ||
|
|
e427aa733f | ||
|
|
76933724e9 | ||
|
|
6ffbd0306f | ||
|
|
9ab3fa427d | ||
|
|
5cd70e33a2 | ||
|
|
894d67a9c5 | ||
|
|
8e01651b6b | ||
|
|
53824658d2 | ||
|
|
e242efa0c2 | ||
|
|
dfa272e0e7 | ||
|
|
38b166a855 | ||
|
|
e4f90d3b0d | ||
|
|
3d0c473a2c | ||
|
|
ef654845d0 | ||
|
|
dcfc7731fe | ||
|
|
a8006bec9a | ||
|
|
4ece68d1b9 | ||
|
|
67cd130d96 | ||
|
|
21f1232b60 | ||
|
|
61be70c014 | ||
|
|
8084d806e2 | ||
|
|
91f63cd01d | ||
|
|
4e07e78b91 | ||
|
|
5458d18ea2 | ||
|
|
6f7951dfb9 | ||
|
|
79828a6410 | ||
|
|
5f756ffb53 | ||
|
|
723a072418 | ||
|
|
cf85ab2db6 | ||
|
|
dba0b170ad | ||
|
|
557da3aa51 | ||
|
|
cbc07ac78d | ||
|
|
f103ed4c31 | ||
|
|
e00e9f8da0 | ||
|
|
866b2c3e95 | ||
|
|
83cb7e2458 | ||
|
|
3b44939fae | ||
|
|
de0a5a49bd | ||
|
|
0bfef8a751 | ||
|
|
364d04d745 | ||
|
|
5e49cdb73a | ||
|
|
749554d8a7 | ||
|
|
12cd23278c | ||
|
|
967d1209a4 | ||
|
|
aaacfdaee7 | ||
|
|
d800e04b3e | ||
|
|
b908dd70ac | ||
|
|
624227159b | ||
|
|
873d411fe6 | ||
|
|
f34849b48a | ||
|
|
4b1c89ecac | ||
|
|
1f6d11eb21 | ||
|
|
4f314d13e8 | ||
|
|
14819ae40a | ||
|
|
18390fbb61 | ||
|
|
8f09ad01d7 | ||
|
|
993ace3d0e | ||
|
|
b61e2ca6fc | ||
|
|
583604e845 | ||
|
|
60e3a4005a | ||
|
|
0b11e35d9b | ||
|
|
351618193a | ||
|
|
de43bd91fd | ||
|
|
b45048402d | ||
|
|
ab7ad9c4b1 | ||
|
|
8366803ae9 | ||
|
|
dfba18c420 | ||
|
|
631d4fff20 | ||
|
|
15b3ac6df7 | ||
|
|
500d748cac | ||
|
|
fc841c3279 | ||
|
|
e27afabe2f | ||
|
|
8cdd471e47 | ||
|
|
f4ddda39be | ||
|
|
83c5e881c9 | ||
|
|
8223a35a51 | ||
|
|
41bbf24ffb | ||
|
|
0a6971cb87 | ||
|
|
05569aeff5 | ||
|
|
e3d66ae364 | ||
|
|
32b830b0c1 | ||
|
|
94c9c1ed75 | ||
|
|
47bd56c716 | ||
|
|
cf3c763e1a | ||
|
|
ba9c992aa8 | ||
|
|
bd83ba523c | ||
|
|
acf500c528 | ||
|
|
e5268b8254 | ||
|
|
997cee5bad | ||
|
|
f4236409d4 | ||
|
|
e6c0bfe29d | ||
|
|
7e0195b302 | ||
|
|
d8e073eb61 | ||
|
|
4d0eaba115 | ||
|
|
75afdf08ab | ||
|
|
5243d34dec | ||
|
|
5a2653fcbc | ||
|
|
4460c9b7d3 | ||
|
|
62b354bdda | ||
|
|
c7cdd0c312 | ||
|
|
b9a26da535 | ||
|
|
136586a546 | ||
|
|
335949e5bf | ||
|
|
b2b83bf34d | ||
|
|
4beccc5eee | ||
|
|
f677e033b9 | ||
|
|
ca58f8a391 | ||
|
|
799082188c | ||
|
|
9bb043b5d1 | ||
|
|
cef5f99aef | ||
|
|
d1d0c82994 | ||
|
|
573538882d | ||
|
|
6ebc924093 | ||
|
|
0120c29ca2 | ||
|
|
2bf2ccdf95 | ||
|
|
ef59132bb3 | ||
|
|
4fc03fe151 | ||
|
|
fd0580be4d | ||
|
|
36e4113db2 | ||
|
|
19580fb685 | ||
|
|
e9f5e8b3be | ||
|
|
af75ac8cb9 | ||
|
|
98bdef83fd | ||
|
|
47a062d593 | ||
|
|
3cc717e7c1 | ||
|
|
03ec95678c | ||
|
|
976f4dafc5 | ||
|
|
7fc44a577e | ||
|
|
cd71fefe2b | ||
|
|
696f38bfda | ||
|
|
a838fda1d7 | ||
|
|
1382d8af48 | ||
|
|
1df90766c9 | ||
|
|
cfbbf28048 | ||
|
|
98f3cd709d | ||
|
|
8c1708b89e | ||
|
|
2fd54be19b | ||
|
|
769db713e8 | ||
|
|
2e988768ce | ||
|
|
bde83a6c57 | ||
|
|
2c630e16e0 | ||
|
|
e6b6dcf8d3 | ||
|
|
f3a0d8e17b | ||
|
|
e9dfca5404 | ||
|
|
37d817cab7 | ||
|
|
a3ca58f551 | ||
|
|
290959305b | ||
|
|
6f592fd2dc | ||
|
|
a45ca75b17 | ||
|
|
b20dab2ad9 | ||
|
|
7acc53cfd0 | ||
|
|
a33924414a | ||
|
|
ecc8914186 | ||
|
|
5c63c8a657 | ||
|
|
f8f7e356ed | ||
|
|
187a634197 | ||
|
|
ef20d5eb5d | ||
|
|
00183bee51 | ||
|
|
e84b034016 | ||
|
|
d4ff64d4cc | ||
|
|
6875257e15 | ||
|
|
18ba64c296 | ||
|
|
c0df7423d3 | ||
|
|
523be33e17 | ||
|
|
d8e0a0be51 | ||
|
|
13ba83a898 | ||
|
|
b8051fe6ef | ||
|
|
e08b49eea5 | ||
|
|
e5e3c055c9 | ||
|
|
1d5a237d96 | ||
|
|
224ce1afdb | ||
|
|
66c9842ef6 | ||
|
|
e27c05d6f4 | ||
|
|
afed4d03bb | ||
|
|
38852c06d7 | ||
|
|
2c2cf01b42 | ||
|
|
b87104c892 | ||
|
|
f30d422b5d | ||
|
|
ed5c3c500e | ||
|
|
efb31546a1 | ||
|
|
0f679cce46 | ||
|
|
b90280b985 | ||
|
|
0ce1623e13 | ||
|
|
c91ecba36d | ||
|
|
9c50a94973 | ||
|
|
0afcb02b22 | ||
|
|
41369a2980 | ||
|
|
439cda900d | ||
|
|
5df53fcaee | ||
|
|
aefe844308 | ||
|
|
136c6e0486 | ||
|
|
c7715b25a9 | ||
|
|
e0c621778e | ||
|
|
a245f61f28 | ||
|
|
7d50d5fda5 | ||
|
|
4fef744f90 | ||
|
|
c1f517291c | ||
|
|
4774f72c54 | ||
|
|
89251e8a31 | ||
|
|
508898d1a4 | ||
|
|
d40195ad85 | ||
|
|
ebd8779f33 | ||
|
|
fa6f9c044b | ||
|
|
eb08f89f69 | ||
|
|
a447aa67e2 | ||
|
|
6bec2fe208 | ||
|
|
ea25d85087 | ||
|
|
39c4fcc29c | ||
|
|
21a4700012 | ||
|
|
633f05d9ab | ||
|
|
ed60ee2f45 | ||
|
|
0f4773e1a2 | ||
|
|
99477035e8 | ||
|
|
ce510df908 | ||
|
|
d38d369326 | ||
|
|
ab880c6c56 | ||
|
|
262405b882 | ||
|
|
eb07751266 | ||
|
|
5f85e9f398 | ||
|
|
66aabf41b9 | ||
|
|
e3dd0fc95e | ||
|
|
8158f1129b | ||
|
|
1d57ccfd5f | ||
|
|
de15c163c3 | ||
|
|
18a8b8537e | ||
|
|
5f80a230a9 | ||
|
|
8c55166701 | ||
|
|
cb9fb777d2 | ||
|
|
ad42bde77f | ||
|
|
607c2acc56 | ||
|
|
c62b50cea2 | ||
|
|
615c23e4b8 | ||
|
|
c8c72f6ab8 | ||
|
|
68967c3bb1 | ||
|
|
f11ff475a3 | ||
|
|
1a8c8cb083 | ||
|
|
682d9cde3a | ||
|
|
afad717dbe | ||
|
|
0804c0cb89 | ||
|
|
44646a9d86 | ||
|
|
5fc86f1131 | ||
|
|
ee0a7ec986 | ||
|
|
d57a4c16fe | ||
|
|
ebe614861d | ||
|
|
faf70e9f94 | ||
|
|
2f495aa792 | ||
|
|
d30f196885 | ||
|
|
6de312564a | ||
|
|
5a0f056cf3 | ||
|
|
1ba623e11e | ||
|
|
7348c6c76a | ||
|
|
1e24e951c1 | ||
|
|
d65012067e | ||
|
|
2c7a346dd4 | ||
|
|
c8805ff506 | ||
|
|
1b040f7d17 | ||
|
|
55bcca8152 | ||
|
|
037dd02c75 | ||
|
|
a3c10a83d1 | ||
|
|
2e89a250b9 | ||
|
|
65a6e4c03f | ||
|
|
9f8451a907 | ||
|
|
2014d1090d | ||
|
|
ba709feb77 | ||
|
|
41bcc963e1 | ||
|
|
8e60153c62 | ||
|
|
5fccb74647 | ||
|
|
26becd11dd | ||
|
|
ac9ee69687 | ||
|
|
b15f6b1d74 | ||
|
|
6f7ecbf56f | ||
|
|
94d84664d1 | ||
|
|
bea79bc718 | ||
|
|
09703b36b9 | ||
|
|
d3bfd80c6d | ||
|
|
f83750b3ec | ||
|
|
3d65852057 | ||
|
|
ccb88174c5 | ||
|
|
8644901107 | ||
|
|
c103bdd36d | ||
|
|
5ec31a78b8 | ||
|
|
d271dfa4ad | ||
|
|
ba93872c71 | ||
|
|
da4e296caa | ||
|
|
496a6bdf88 | ||
|
|
196176d820 | ||
|
|
2ce31ddb65 | ||
|
|
811533d472 | ||
|
|
00cc351d64 | ||
|
|
bd675479ab | ||
|
|
e53227cfad | ||
|
|
cef7336b11 | ||
|
|
c77946d939 | ||
|
|
fb214a54c3 | ||
|
|
2cd22a49b4 | ||
|
|
82f36fb6db | ||
|
|
6c53a3b144 | ||
|
|
8508805da0 | ||
|
|
e55f641f1c | ||
|
|
84c04c83a4 | ||
|
|
85fe839b8f | ||
|
|
80e7afce96 | ||
|
|
3af19f6287 | ||
|
|
fc6c656500 | ||
|
|
b4f9df75b4 | ||
|
|
b47ef4e341 | ||
|
|
2f8ca8f7de | ||
|
|
8e0285d492 | ||
|
|
07317284c8 | ||
|
|
e5c0057c1d | ||
|
|
13917649c5 | ||
|
|
89ee93284a | ||
|
|
c3a0e1bf89 | ||
|
|
a12b7179a1 | ||
|
|
5c85688965 | ||
|
|
80e959e9a7 | ||
|
|
79324eeb8a | ||
|
|
cc834a7a16 | ||
|
|
b59a4e6432 | ||
|
|
6f68884db7 | ||
|
|
0cd23ab88a | ||
|
|
3be41f0e3c | ||
|
|
6938e62b93 | ||
|
|
15e16786a7 | ||
|
|
fe27f54320 | ||
|
|
f222cc2ee8 | ||
|
|
f3739f3c5f | ||
|
|
f89315e91a | ||
|
|
0e16b1f924 | ||
|
|
a3c7e3370e | ||
|
|
fd396cbd3a | ||
|
|
d44445a7cc | ||
|
|
c79d9e32cc | ||
|
|
ab120feeed | ||
|
|
8fc7cf0f88 | ||
|
|
34fe923f50 | ||
|
|
5de8cf03c1 | ||
|
|
ddda0fa080 | ||
|
|
73cf3067c3 | ||
|
|
4cf63588c7 | ||
|
|
58c7644ad4 | ||
|
|
701c8c518a | ||
|
|
d6ec90d4f3 | ||
|
|
ddd682ca3b | ||
|
|
b1298b9033 | ||
|
|
418ba58d3c | ||
|
|
a36080994a | ||
|
|
911f316743 | ||
|
|
70baf983ac | ||
|
|
5d6c78bcc8 | ||
|
|
d333b22ea3 | ||
|
|
1f88cfa439 | ||
|
|
84cd3dc2d3 | ||
|
|
a78cdf4a5c | ||
|
|
4a14e822a5 | ||
|
|
734c586b10 | ||
|
|
a02f54829d | ||
|
|
4955faaa63 | ||
|
|
b6e7c3b2e2 | ||
|
|
18e45eab64 | ||
|
|
18796c82fd | ||
|
|
63a007f766 | ||
|
|
db37cf4fdf | ||
|
|
4ae243fcf7 | ||
|
|
2ba447ad02 | ||
|
|
8f96def584 | ||
|
|
b0ac4bbc35 | ||
|
|
8f9f1f7b9c | ||
|
|
f2dd3ba7e2 | ||
|
|
960dc4aa96 | ||
|
|
4c447ce5b6 | ||
|
|
f7dc589511 | ||
|
|
beb3fee101 | ||
|
|
f62d228cdf | ||
|
|
a512db2520 | ||
|
|
4519fcca11 | ||
|
|
f0f925bd2a | ||
|
|
53de27ff9f | ||
|
|
b008d5cdee | ||
|
|
f07dfbf5da | ||
|
|
8d9f4ae492 | ||
|
|
16726969cf | ||
|
|
93430f7548 | ||
|
|
fd3090b2f1 | ||
|
|
5ab7de4924 | ||
|
|
ef9d5cd39b | ||
|
|
17d804c53b | ||
|
|
12fcae97a6 | ||
|
|
e183226b89 | ||
|
|
8f4731368a | ||
|
|
b322452569 | ||
|
|
437d94cd29 | ||
|
|
6600641ba4 | ||
|
|
0d2100ee1e | ||
|
|
ada339d871 | ||
|
|
3f6c33f7ca | ||
|
|
3e5377868c | ||
|
|
880b0c7b55 | ||
|
|
710b525f11 | ||
|
|
567e48da31 | ||
|
|
34d1014b7d | ||
|
|
9853a0bff0 | ||
|
|
38ea00bd8d | ||
|
|
579f804003 | ||
|
|
f0c2e69c5b | ||
|
|
74f8756d9f | ||
|
|
42f1a3f746 | ||
|
|
0ecef37b87 | ||
|
|
ca425d6d0a | ||
|
|
f06a2d974f | ||
|
|
8157e2f0bc | ||
|
|
081e934b8c | ||
|
|
8365b0e2e8 | ||
|
|
a2699819bf | ||
|
|
89518b8a1f | ||
|
|
b26ae3a17c | ||
|
|
eedf08647a | ||
|
|
b766c949f2 | ||
|
|
22abf3e62f | ||
|
|
a3264e4207 | ||
|
|
27fe30226a | ||
|
|
a791f9fcbd | ||
|
|
de511c9ba4 | ||
|
|
2160fbf771 | ||
|
|
6fdd652fa4 | ||
|
|
891be1862b | ||
|
|
d47963acc2 | ||
|
|
b6318ae554 | ||
|
|
42457bc6d5 | ||
|
|
b1b713eecd | ||
|
|
161b32d830 | ||
|
|
e5b8cb2be7 | ||
|
|
33faae70a6 | ||
|
|
ce19cf5b7b | ||
|
|
cebd668629 | ||
|
|
eddaf899d9 | ||
|
|
1e1f20da5e | ||
|
|
9b8a3f3597 | ||
|
|
69d06fc4ec | ||
|
|
7beeb69abd | ||
|
|
f223bbb1ed | ||
|
|
9a60a4f707 | ||
|
|
2209553e25 | ||
|
|
e57366cd31 | ||
|
|
8479b9e08b | ||
|
|
32ef4887fa | ||
|
|
b365432c57 | ||
|
|
28cfa48117 | ||
|
|
6cdd6a06c8 | ||
|
|
43e34e2f37 |
No files matched your search
@@ -0,0 +1,21 @@
|
||||
root = true
|
||||
|
||||
[*]
|
||||
charset = utf-8
|
||||
end_of_line = lf
|
||||
indent_size = 4
|
||||
indent_style = space
|
||||
insert_final_newline = true
|
||||
tab_width = 4
|
||||
|
||||
[{*.ats,*.cts,*.mts,*.ts,*.tsx}]
|
||||
ij_typescript_spaces_within_imports = true
|
||||
|
||||
[{*.cjs,*.js}]
|
||||
ij_javascript_spaces_within_imports = true
|
||||
|
||||
[{*.yaml,*.yml}]
|
||||
indent_size = 2
|
||||
|
||||
[*.json]
|
||||
indent_size = 2
|
||||
@@ -1,5 +1,10 @@
|
||||
# Copy this file and rename .env, then place your api credentials in here
|
||||
API_KEY=ABC
|
||||
API_SECRET=ABC
|
||||
# separate key for add action
|
||||
API_ADD_KEY=ABC
|
||||
API_ADD_SECRET=ABC
|
||||
# This is the port that the UI server starts on
|
||||
SERVER_PORT=5001
|
||||
PORT=5001
|
||||
# this can be 'development' or 'production'
|
||||
NODE_ENV=development
|
||||
@@ -0,0 +1 @@
|
||||
.env.*
|
||||
@@ -0,0 +1,21 @@
|
||||
name: CI
|
||||
on:
|
||||
push:
|
||||
branches: [ master ]
|
||||
pull_request:
|
||||
branches: [ master ]
|
||||
workflow_dispatch:
|
||||
jobs:
|
||||
test:
|
||||
runs-on: ubuntu-latest
|
||||
|
||||
steps:
|
||||
- uses: actions/checkout@v2
|
||||
|
||||
- name: Validate JSON
|
||||
uses: nhalstead/[email protected]
|
||||
with:
|
||||
# Relative file path under the repository of a JSON schema file to validate the other JSON files with.
|
||||
schema: server/data/apps-schema.json
|
||||
# One or more relative file paths under the repository (separated by comma) of the JSON files to validate with the schema provided.
|
||||
jsons: server/data/apps.json
|
||||
@@ -11,4 +11,19 @@ venv.bak/
|
||||
|
||||
.DS_Store
|
||||
.vscode
|
||||
.idea
|
||||
.idea
|
||||
|
||||
*.log
|
||||
www
|
||||
|
||||
package-lock.json
|
||||
|
||||
# https://yarnpkg.com/getting-started/qa#which-files-should-be-gitignored
|
||||
# We are not using Zero-installs
|
||||
.pnp.*
|
||||
.yarn/*
|
||||
!.yarn/patches
|
||||
!.yarn/plugins
|
||||
!.yarn/releases
|
||||
!.yarn/sdks
|
||||
!.yarn/versions
|
||||
@@ -0,0 +1 @@
|
||||
nodeLinker: node-modules
|
||||
@@ -0,0 +1,21 @@
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2020 Podcastindex.org
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
@@ -1,42 +1,84 @@
|
||||
# PodcastIndex web and dev UI
|
||||
# PodcastIndex Web UI
|
||||
|
||||
This is the UI for the public and dev portal
|
||||
Podcast Web UI is a project that houses the code for the React app and express server for [podcastindex.org](https://podcastindex.org/).
|
||||
|
||||
- Landing page for PodcastIndex.
|
||||
- Search for podcasts in index.
|
||||
- Simple podcast player for listening
|
||||
- List of apps using the PodcastIndex
|
||||
- Documentation and developer login for credential management
|
||||
|
||||
## Project Structure
|
||||
|
||||
The project is split into two folders, `ui`, and `server`.
|
||||
|
||||
.
|
||||
├── ...
|
||||
├── ui
|
||||
│ ├── public # Static files for index.html and favicon
|
||||
│ ├── fonts # Fonts used in the UI
|
||||
│ ├── images # Images and icons that are part of the UI
|
||||
│ └── src # All React and client code
|
||||
├── server
|
||||
│ ├── assets # static files that are dynamically updated
|
||||
│ ├── data # static data files (ie. json) that are dynamically updated
|
||||
│ └── index.js # express app that serves the UI and is a reverse proxy (replaces need for NGINX)
|
||||
└── ...
|
||||
|
||||
The folder `ui` houses all the React and client based code and assets.
|
||||
|
||||
The folder `server` houses all of the API, static server data, and the reverse proxy to the PodcastIndex API using [`comster/podcast-index-api`](https://github.com/comster/podcast-index-api).
|
||||
|
||||
### Server `data` and `assets`
|
||||
|
||||
The reason to build a custom express server for serving React and other data is due to the need for script updated `.json` files and dynamically adding apps to the `/apps` page. This data should not be bundled with the client compiled code.
|
||||
|
||||
### CORS
|
||||
|
||||
The custom express server also is used to [reverse proxy](https://en.wikipedia.org/wiki/Reverse_proxy#:~:text=In%20computer%20networks%2C%20a%20reverse,the%20reverse%20proxy%20server%20itself.) requests through the same domain to prevent [CORS](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) issues. Using the same domain to server up the UI content and to send api requests prevents CORS issues in modern browsers.
|
||||
|
||||
## Getting Started
|
||||
|
||||
### Set .env
|
||||
|
||||
You should see a `.env-example` file. Copy this and remove the `-example`. The file `.env` is ignored by GIT and is needed to set the `API_KEY` and `API_SECRET` variables
|
||||
You should see a `.env-example` file. Copy this and remove the `-example`. The file `.env` is ignored by GIT and is needed to set the `API_KEY`, `API_SECRET`, `API_ADD_KEY` and `API_ADD_SECRET` variables
|
||||
|
||||
### Starting the dev server
|
||||
|
||||
In order to have the UI hot reload for development, we utilized `webpack-dev-server` this allows for easier debugging, etc. In order for the dev-server to connect to the API, you must first have set the `.env` file variables and have started the server with `yarn start`
|
||||
|
||||
```zsh
|
||||
# Install dependencies
|
||||
yarn
|
||||
yarn install
|
||||
|
||||
# Start app
|
||||
# Start dev server
|
||||
yarn dev
|
||||
|
||||
# Start the node server in another terminal window.
|
||||
yarn start
|
||||
```
|
||||
|
||||
## Building for production
|
||||
|
||||
To build the app for production use the following script.
|
||||
|
||||
```zsh
|
||||
yarn build
|
||||
```
|
||||
|
||||
This will compile the React code into static files in the `www` folder
|
||||
|
||||
## Running production
|
||||
|
||||
To start the server, simply run after setting the `.env` file
|
||||
|
||||
**Note**: Make sure to set `NODE_ENV=production` in the `.env` file
|
||||
|
||||
The below script will compile the code and then start the node server.
|
||||
|
||||
```zsh
|
||||
node server.js
|
||||
npm run build
|
||||
npm start
|
||||
```
|
||||
|
||||
## Tech List
|
||||
|
||||
- [Express](https://expressjs.com/)
|
||||
- [React](https://reactjs.org/)
|
||||
- [Webpack](https://webpack.js.org/)
|
||||
|
||||
## TODO
|
||||
|
||||
- Font should load through webpack properly
|
||||
- Better image loading handling in the search results page.
|
||||
- Developers page and login
|
||||
@@ -450,7 +450,7 @@
|
||||
href="https://podcastindex-org.github.io/docs-api/">here</a>.
|
||||
</div>
|
||||
<div class="justify-content-center">We build in the open. Get active in the <a
|
||||
href="https://github.com/Podcastindex-org">Github repos</a>.
|
||||
href="https://github.com/Podcastindex-org">GitHub repos</a>.
|
||||
</div>
|
||||
<div class="justify-content-center">
|
||||
We have a Mastodon server for collaboration. Join it here: <a
|
||||
|
||||
@@ -1,11 +0,0 @@
|
||||
|
||||
<svg width="31px" height="30px" viewBox="0 0 31 30" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
|
||||
<g transform="translate(-1176.000000, -742.000000)">
|
||||
<g transform="translate(1176.000000, 742.000000)">
|
||||
<rect fill="#B1B1B1" x="0" y="0" width="31" height="30" rx="7"></rect>
|
||||
<path d="M7.82692308,20.3461538 C6.26646154,20.3461538 5,21.6126154 5,23.1730769 C5,24.7335385 6.26646154,26 7.82692308,26 C9.38738462,26 10.6538462,24.7335385 10.6538462,23.1730769 C10.6538462,21.6126154 9.38738462,20.3461538 7.82692308,20.3461538 Z M9.24038462,14.6923077 C8.68509615,14.6923077 8.23076923,15.1466346 8.23076923,15.7019231 C8.23076923,16.2572115 8.68509615,16.7115385 9.24038462,16.7115385 C12.0269231,16.7115385 14.2884615,18.9730769 14.2884615,21.7596154 C14.2884615,22.3149038 14.7427885,22.7692308 15.2980769,22.7692308 C15.8533654,22.7692308 16.3076923,22.3149038 16.3076923,21.7596154 C16.3076923,17.8524038 13.1475962,14.6923077 9.24038462,14.6923077 Z M9.21794872,5 C8.675,5 8.23076923,5.44423077 8.23076923,5.98717949 C8.23076923,6.53012821 8.675,6.97435897 9.21794872,6.97435897 C17.3917949,6.97435897 24.025641,13.6082051 24.025641,21.7820513 C24.025641,22.325 24.4698718,22.7692308 25.0128205,22.7692308 C25.5557692,22.7692308 26,22.325 26,21.7820513 C26,12.5124359 18.4875641,5 9.21794872,5 Z M9.22485207,9.84615385 C8.67810651,9.84615385 8.23076923,10.2934911 8.23076923,10.8402367 C8.23076923,11.3869822 8.67810651,11.8343195 9.22485207,11.8343195 C14.7121893,11.8343195 19.1656805,16.2878107 19.1656805,21.7751479 C19.1656805,22.3218935 19.6130178,22.7692308 20.1597633,22.7692308 C20.7065089,22.7692308 21.1538462,22.3218935 21.1538462,21.7751479 C21.1538462,15.1843787 15.8156213,9.84615385 9.22485207,9.84615385 Z" id="Shape" fill="#FFFFFF"></path>
|
||||
</g>
|
||||
</g>
|
||||
</g>
|
||||
</svg>
|
||||
|
Before Width: | Height: | Size: 1.9 KiB |
@@ -1,12 +0,0 @@
|
||||
|
||||
<svg width="28px" height="29px" viewBox="0 0 28 29" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
<g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
|
||||
<g transform="translate(-25.000000, -24.000000)" fill="#F90000">
|
||||
<g transform="translate(25.000000, 23.000000)">
|
||||
<rect id="Rectangle" x="12.5" y="11" width="3" height="19" rx="1.5"></rect>
|
||||
<path d="M7.59979894,16.3285714 C4.35694178,13.2428571 4.62837035,8.45714282 7.61408465,5.67142852 C8.18551323,5.14285709 9.09979895,5.17142852 9.61408466,5.75714281 C10.1569418,6.32857138 10.1140847,7.22857138 9.54265609,7.77142853 C7.72837037,9.47142854 7.5569418,12.3571428 9.55694181,14.2571428 C10.1283704,14.8 10.1569418,15.7 9.61408466,16.2714286 C9.07122752,16.8428571 8.17122751,16.8714286 7.59979894,16.3285714 Z M6.59911452,18.4285714 C7.31340024,18.8571429 7.45625738,19.7142857 6.88482881,20.4285715 C6.59911452,20.8571429 6.17054309,21 5.74197166,21 C5.45625737,21 5.17054308,20.8571429 4.8848288,20.7142857 C2.02768593,18.5714286 0.170543059,14.8571429 0.0276859151,11 C-0.115171228,6.99999996 1.74197164,3.71428565 4.8848288,1.28571421 C5.45625737,0.857142781 6.45625738,0.857142781 6.88482881,1.5714285 C7.31340024,2.14285707 7.31340024,3.14285708 6.59911452,3.57142851 C4.17054308,5.42857138 2.88482879,7.99999996 2.88482879,11 C2.88482879,13.8571428 4.31340022,16.8571429 6.59911452,18.4285714 Z M18.3975265,16.2714286 C17.8546694,15.7 17.8832408,14.8 18.4403837,14.2428571 C20.4403837,12.3428571 20.2832408,9.45714282 18.4546694,7.75714282 C17.8832408,7.22857138 17.8403837,6.31428567 18.3832408,5.74285709 C18.9118122,5.17142852 19.8260979,5.12857137 20.3975265,5.67142852 C23.3832408,8.45714282 23.6546694,13.2428571 20.4118122,16.3285714 C19.8403837,16.8714286 18.9403837,16.8428571 18.3975265,16.2714286 Z M23.132597,1.28571421 C26.2754542,3.71428565 28.1183113,6.99999996 27.9897399,11 C27.9897399,14.8571429 26.1325971,18.5714286 23.132597,20.7142857 C22.8468828,20.8571429 22.5611685,21 22.2754542,21 C21.8468827,21 21.4183113,20.8571429 21.132597,20.4285715 C20.5611685,19.7142857 20.7040256,18.8571429 21.4183113,18.4285714 C23.7040256,16.8571429 25.132597,13.8571428 25.132597,11 C25.132597,7.99999996 23.8468828,5.42857138 21.4183113,3.57142851 C20.7040256,3.14285708 20.7040256,2.14285707 21.132597,1.5714285 C21.5611685,0.857142781 22.5611685,0.857142781 23.132597,1.28571421 Z" id="Shape"></path>
|
||||
<circle id="Oval" cx="14" cy="11" r="3"></circle>
|
||||
</g>
|
||||
</g>
|
||||
</g>
|
||||
</svg>
|
||||
|
Before Width: | Height: | Size: 2.5 KiB |
@@ -1,74 +1,91 @@
|
||||
{
|
||||
"name": "podcastindex",
|
||||
"version": "0.1.0",
|
||||
"private": true,
|
||||
"dependencies": {
|
||||
"@types/history": "^4.7.5",
|
||||
"@types/react": "^16.9.20",
|
||||
"@types/react-dom": "^16.9.5",
|
||||
"@types/react-redux": "^7.1.7",
|
||||
"@types/react-router-dom": "^5.1.3",
|
||||
"@types/redux": "^3.6.0",
|
||||
"@types/redux-actions": "^2.6.1",
|
||||
"@types/redux-thunk": "^2.1.0",
|
||||
"apexcharts": "^3.20.0",
|
||||
"connected-react-router": "^6.7.0",
|
||||
"dotenv": "^8.2.0",
|
||||
"express": "^4.17.1",
|
||||
"history": "^4.10.1",
|
||||
"moment": "^2.29.0",
|
||||
"pluralize": "^8.0.0",
|
||||
"podcast-index-api": "^1.1.6",
|
||||
"react": "^16.12.0",
|
||||
"react-dom": "^16.12.0",
|
||||
"react-h5-audio-player": "^3.4.1",
|
||||
"react-list": "^0.8.15",
|
||||
"react-loading": "^2.0.3",
|
||||
"react-redux": "^7.2.0",
|
||||
"react-router-dom": "^5.1.2",
|
||||
"redux": "^4.0.5",
|
||||
"redux-actions": "^2.6.5",
|
||||
"redux-devtools-extension": "^2.13.8",
|
||||
"redux-thunk": "^2.3.0",
|
||||
"reduxsauce": "^1.1.2",
|
||||
"shortid": "^2.2.15",
|
||||
"typesafe-actions": "^5.1.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@babel/core": "^7.11.6",
|
||||
"@storybook/addon-actions": "^6.0.21",
|
||||
"@storybook/addon-essentials": "^6.0.21",
|
||||
"@storybook/addon-links": "^6.0.21",
|
||||
"@storybook/node-logger": "^6.0.21",
|
||||
"@storybook/preset-create-react-app": "^3.1.4",
|
||||
"@storybook/react": "^6.0.21",
|
||||
"babel-loader": "^8.1.0",
|
||||
"css-loader": "^3.4.2",
|
||||
"favicons-webpack-plugin": "^4.2.0",
|
||||
"file-loader": "^6.1.0",
|
||||
"html-loader": "^0.5.5",
|
||||
"html-webpack-plugin": "^4.5.0",
|
||||
"prettier": "^2.1.1",
|
||||
"react-is": "^16.13.1",
|
||||
"react-scripts": "3.2.0",
|
||||
"sass": "^1.26.10",
|
||||
"sass-loader": "^9.0.3",
|
||||
"style-loader": "^1.1.3",
|
||||
"ts-loader": "^6.2.1",
|
||||
"typescript": "^3.7.5",
|
||||
"url-loader": "^4.1.0",
|
||||
"webpack": "^4.41.6",
|
||||
"webpack-cli": "^3.3.11",
|
||||
"webpack-dev-server": "^3.10.3"
|
||||
},
|
||||
"scripts": {
|
||||
"start": "webpack-dev-server",
|
||||
"build": "webpack",
|
||||
"test": "react-scripts test --env=jsdom",
|
||||
"eject": "react-scripts eject",
|
||||
"flow": "flow",
|
||||
"format": "prettier --write 'src/**/*.js'",
|
||||
"storybook": "start-storybook -p 6006 -s public",
|
||||
"build-storybook": "build-storybook -s public"
|
||||
}
|
||||
"name": "podcastindex",
|
||||
"version": "0.2.1",
|
||||
"user-agent-org": "Podcastindex.org/",
|
||||
"user-agent-app": "www",
|
||||
"license": "MIT",
|
||||
"private": true,
|
||||
"dependencies": {
|
||||
"@hcaptcha/react-hcaptcha": "^0.3.9",
|
||||
"@types/dompurify": "^2.4.0",
|
||||
"@types/history": "^4.7.5",
|
||||
"@types/react": "^16.9.20",
|
||||
"@types/react-dom": "^16.9.5",
|
||||
"@types/react-redux": "^7.1.7",
|
||||
"@types/react-router-dom": "^5.1.3",
|
||||
"@types/redux": "^3.6.0",
|
||||
"@types/redux-actions": "^2.6.1",
|
||||
"@types/redux-thunk": "^2.1.0",
|
||||
"apexcharts": "^3.20.0",
|
||||
"canvas-confetti": "^1.5.1",
|
||||
"connected-react-router": "^6.7.0",
|
||||
"crypto-js": "^4.0.0",
|
||||
"dompurify": "^2.4.3",
|
||||
"dotenv": "^8.2.0",
|
||||
"dotenv-webpack": "^8.0.1",
|
||||
"express": "^4.17.1",
|
||||
"history": "^4.10.1",
|
||||
"moment": "^2.29.0",
|
||||
"node-fetch": "^2.6.8",
|
||||
"pluralize": "^8.0.0",
|
||||
"podcast-index-api": "^1.1.9",
|
||||
"query-string": "^6.13.5",
|
||||
"react": "^16.12.0",
|
||||
"react-dom": "^16.12.0",
|
||||
"react-h5-audio-player": "^3.8.2",
|
||||
"react-infinite-scroll-component": "^6.1.0",
|
||||
"react-loading": "^2.0.3",
|
||||
"react-redux": "^7.2.0",
|
||||
"react-router-dom": "^5.1.2",
|
||||
"redux": "^4.0.5",
|
||||
"redux-actions": "^2.6.5",
|
||||
"redux-devtools-extension": "^2.13.8",
|
||||
"redux-thunk": "^2.3.0",
|
||||
"reduxsauce": "^1.1.2",
|
||||
"shortid": "^2.2.15",
|
||||
"threadcap": "^0.1.9",
|
||||
"typesafe-actions": "^5.1.0",
|
||||
"uuid": "^8.3.2",
|
||||
"webln": "^0.3.0"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@babel/core": "^7.11.6",
|
||||
"@storybook/addon-actions": "^6.0.21",
|
||||
"@storybook/addon-essentials": "^6.0.21",
|
||||
"@storybook/addon-links": "^6.0.21",
|
||||
"@storybook/node-logger": "^6.0.21",
|
||||
"@storybook/preset-create-react-app": "^3.1.4",
|
||||
"@storybook/react": "^6.0.21",
|
||||
"babel-loader": "^8.1.0",
|
||||
"copy-webpack-plugin": "^6.3.2",
|
||||
"css-loader": "^3.4.2",
|
||||
"favicons-webpack-plugin": "^4.2.0",
|
||||
"file-loader": "^6.1.0",
|
||||
"html-loader": "^0.5.5",
|
||||
"html-webpack-plugin": "^4.5.0",
|
||||
"prettier": "^2.1.1",
|
||||
"react-is": "^16.13.1",
|
||||
"react-scripts": "3.2.0",
|
||||
"sass": "^1.26.10",
|
||||
"sass-loader": "^9.0.3",
|
||||
"style-loader": "^1.1.3",
|
||||
"ts-loader": "^6.2.1",
|
||||
"typescript": "^3.7.5",
|
||||
"url-loader": "^4.1.0",
|
||||
"webpack": "^4.41.6",
|
||||
"webpack-cli": "^3.3.11",
|
||||
"webpack-dev-server": "^3.10.3"
|
||||
},
|
||||
"scripts": {
|
||||
"dev": "webpack-dev-server --env.file=development --mode development --devtool inline-source-map",
|
||||
"build": "webpack",
|
||||
"production": "NODE_ENV='production' && webpack --env.file=production --mode production && node server",
|
||||
"start": "node server",
|
||||
"test": "react-scripts test --env=jsdom",
|
||||
"eject": "react-scripts eject",
|
||||
"flow": "flow",
|
||||
"format": "prettier --write 'src/**/*.js'",
|
||||
"storybook": "start-storybook -p 6006 -s public",
|
||||
"build-storybook": "build-storybook -s public"
|
||||
}
|
||||
}
|
||||
|
Before Width: | Height: | Size: 894 B |
@@ -1,27 +0,0 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8" />
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
<link rel="shortcut icon" href="favicon.ico" />
|
||||
<link rel="alternate icon" href="/favicon.ico" />
|
||||
<link rel="mask-icon" href="/safari-pinned-tab.svg" color="#ff8a01" />
|
||||
<!-- Style dependencies -->
|
||||
<!-- <link href="https://unpkg.com/normalize.css@^7.0.0" rel="stylesheet" /> -->
|
||||
<title>Podcastindex.org</title>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<div id="root"></div>
|
||||
<!--
|
||||
This HTML file is a template.
|
||||
If you open it directly in the browser, you will see an empty page.
|
||||
|
||||
You can add webfonts, meta tags, or analytics to this file.
|
||||
The build step will place the bundled scripts into the <body> tag.
|
||||
|
||||
To begin the development, run `npm start`.
|
||||
To create a production bundle, use `npm run build`.
|
||||
--></body>
|
||||
<!-- <script src="bundle.js"></script> -->
|
||||
</html>
|
||||
@@ -1,33 +0,0 @@
|
||||
const path = require('path')
|
||||
const express = require('express')
|
||||
const app = express() // create express app
|
||||
// Gets the .env variables
|
||||
require('dotenv').config()
|
||||
|
||||
// Utilizing the node repo from comster/podcast-index-api :)
|
||||
// NOTE: This server will work as a reverse proxy.
|
||||
const api = require('podcast-index-api')(
|
||||
process.env.API_KEY,
|
||||
process.env.API_SECRET
|
||||
)
|
||||
|
||||
app.use(express.static('www'))
|
||||
|
||||
app.use('/api/search/byterm', async (req, res) => {
|
||||
let term = req.query.q
|
||||
const response = await api.searchByTerm(term)
|
||||
res.send(response)
|
||||
})
|
||||
|
||||
app.use('/api/recent/episodes', async (req, res) => {
|
||||
let max = req.query.max
|
||||
const response = await api.recentEpisodes(max)
|
||||
res.send(response)
|
||||
})
|
||||
|
||||
app.get('*', (req, res) => res.sendFile(path.resolve('www', 'index.html')))
|
||||
|
||||
// start express server on port 5001 (default)
|
||||
app.listen(process.env.SERVER_PORT, () => {
|
||||
console.log(`server started on port ${process.env.SERVER_PORT}`)
|
||||
})
|
||||
|
After Width: | Height: | Size: 24 KiB |
|
After Width: | Height: | Size: 25 KiB |
|
After Width: | Height: | Size: 23 KiB |
|
After Width: | Height: | Size: 86 KiB |
|
After Width: | Height: | Size: 25 KiB |
|
After Width: | Height: | Size: 655 KiB |
|
After Width: | Height: | Size: 239 KiB |
|
After Width: | Height: | Size: 23 KiB |
|
After Width: | Height: | Size: 24 KiB |
|
After Width: | Height: | Size: 8.1 KiB |
|
After Width: | Height: | Size: 69 KiB |
|
After Width: | Height: | Size: 23 KiB |
|
After Width: | Height: | Size: 58 KiB |
|
After Width: | Height: | Size: 103 KiB |
|
After Width: | Height: | Size: 138 KiB |
|
After Width: | Height: | Size: 10 KiB |
|
After Width: | Height: | Size: 73 KiB |
|
After Width: | Height: | Size: 18 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 22 KiB |
|
After Width: | Height: | Size: 22 KiB |
|
After Width: | Height: | Size: 67 KiB |
|
After Width: | Height: | Size: 26 KiB |
|
After Width: | Height: | Size: 3.7 KiB |
|
After Width: | Height: | Size: 10 KiB |
|
After Width: | Height: | Size: 72 KiB |
|
After Width: | Height: | Size: 5.2 KiB |
|
After Width: | Height: | Size: 29 KiB |
|
After Width: | Height: | Size: 19 KiB |
|
After Width: | Height: | Size: 30 KiB |
|
After Width: | Height: | Size: 33 KiB |
|
After Width: | Height: | Size: 10 KiB |
|
After Width: | Height: | Size: 3.6 KiB |
|
After Width: | Height: | Size: 15 KiB |
|
After Width: | Height: | Size: 6.1 KiB |
|
After Width: | Height: | Size: 53 KiB |
|
After Width: | Height: | Size: 41 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 35 KiB |
|
After Width: | Height: | Size: 23 KiB |
|
After Width: | Height: | Size: 156 KiB |
|
After Width: | Height: | Size: 12 KiB |
|
After Width: | Height: | Size: 39 KiB |
|
After Width: | Height: | Size: 27 KiB |
|
After Width: | Height: | Size: 67 KiB |
|
After Width: | Height: | Size: 35 KiB |
|
After Width: | Height: | Size: 42 KiB |
|
After Width: | Height: | Size: 12 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 37 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 16 KiB |
|
After Width: | Height: | Size: 14 KiB |
|
After Width: | Height: | Size: 20 KiB |
|
After Width: | Height: | Size: 93 KiB |
|
After Width: | Height: | Size: 8.3 KiB |
|
After Width: | Height: | Size: 9.2 KiB |
|
After Width: | Height: | Size: 9.9 KiB |
|
After Width: | Height: | Size: 19 KiB |
|
After Width: | Height: | Size: 10 KiB |
|
After Width: | Height: | Size: 216 KiB |
|
After Width: | Height: | Size: 64 KiB |
|
After Width: | Height: | Size: 1.7 KiB |
|
After Width: | Height: | Size: 15 KiB |
|
After Width: | Height: | Size: 7.7 KiB |
|
After Width: | Height: | Size: 30 KiB |
|
After Width: | Height: | Size: 2.1 KiB |
|
After Width: | Height: | Size: 7.1 KiB |
|
After Width: | Height: | Size: 17 KiB |
|
After Width: | Height: | Size: 428 KiB |
|
After Width: | Height: | Size: 8.9 KiB |
|
After Width: | Height: | Size: 5.6 KiB |
|
After Width: | Height: | Size: 7.0 KiB |
|
After Width: | Height: | Size: 7.9 KiB |
@@ -0,0 +1,143 @@
|
||||
{
|
||||
"$schema": "http://json-schema.org/draft-07/schema#",
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/definitions/App"
|
||||
},
|
||||
"definitions": {
|
||||
"App": {
|
||||
"type": "object",
|
||||
"title": "App or Service",
|
||||
"additionalProperties": false,
|
||||
"required": [
|
||||
"appName",
|
||||
"appType",
|
||||
"appIconUrl",
|
||||
"appUrl",
|
||||
"platforms",
|
||||
"supportedElements"
|
||||
],
|
||||
"properties": {
|
||||
"appName": {
|
||||
"type": "string"
|
||||
},
|
||||
"appType": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"app",
|
||||
"hosting",
|
||||
"directory",
|
||||
"browser extension",
|
||||
"wordpress plugin",
|
||||
"website",
|
||||
"social links",
|
||||
"node hosting",
|
||||
"podcast player",
|
||||
"video",
|
||||
"sn-network",
|
||||
"blockchain",
|
||||
"podcaster wallet",
|
||||
"open source",
|
||||
"other",
|
||||
"chat bot"
|
||||
]
|
||||
}
|
||||
},
|
||||
"appUrl": {
|
||||
"type": "string",
|
||||
"format": "uri"
|
||||
},
|
||||
"appIconUrl": {
|
||||
"type": "string",
|
||||
"description": "Filename of png or jpg in assets folder"
|
||||
},
|
||||
"platforms": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"Web",
|
||||
"Mobile",
|
||||
"iOS",
|
||||
"iPad OS",
|
||||
"Android",
|
||||
"F-Droid",
|
||||
"macOS",
|
||||
"Windows",
|
||||
"Linux",
|
||||
"BSD",
|
||||
"KaiOS",
|
||||
"Chrome",
|
||||
"Wordpress",
|
||||
"N/A",
|
||||
"AmigaOS 4",
|
||||
"Sailfish OS",
|
||||
"Umbrel",
|
||||
"Citadel",
|
||||
"Hive",
|
||||
"Discord"
|
||||
]
|
||||
}
|
||||
},
|
||||
"supportedElements": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"$ref": "#/definitions/SupportedElement"
|
||||
}
|
||||
},
|
||||
"tagLine": {
|
||||
"type": "string"
|
||||
}
|
||||
}
|
||||
},
|
||||
"SupportedElement": {
|
||||
"type": "object",
|
||||
"title": "Supported Element",
|
||||
"additionalProperties": true,
|
||||
"properties": {
|
||||
"elementName": {
|
||||
"type": "string",
|
||||
"enum": [
|
||||
"Transcript",
|
||||
"Locked",
|
||||
"Funding",
|
||||
"Chapters",
|
||||
"Search",
|
||||
"Season",
|
||||
"Episode",
|
||||
"Soundbite",
|
||||
"Location",
|
||||
"Person",
|
||||
"Value",
|
||||
"Sn-Network",
|
||||
"Boostagrams",
|
||||
"Sat Streaming",
|
||||
"Video",
|
||||
"Synchronize",
|
||||
"Podping",
|
||||
"Alternate Enclosure",
|
||||
"Trailer",
|
||||
"GUID",
|
||||
"Medium",
|
||||
"Live",
|
||||
"Block",
|
||||
"Social Interact",
|
||||
"OP3",
|
||||
"Images",
|
||||
"License",
|
||||
"Txt"
|
||||
]
|
||||
},
|
||||
"elementURL": {
|
||||
"type": "string",
|
||||
"format": "uri"
|
||||
}
|
||||
},
|
||||
"required": [
|
||||
"elementName"
|
||||
]
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,627 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width,initial-scale=1">
|
||||
|
||||
|
||||
<title>Podcastindex.org</title>
|
||||
<link rel="shortcut icon" href="/favicon.ico"><link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png"><link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png"><link rel="icon" type="image/png" sizes="48x48" href="/favicon-48x48.png"><link rel="manifest" href="/manifest.json"><meta name="mobile-web-app-capable" content="yes"><meta name="theme-color" content="#e90000"><meta name="application-name" content="Podcastindex.org"><link rel="apple-touch-icon" sizes="57x57" href="/apple-touch-icon-57x57.png"><link rel="apple-touch-icon" sizes="60x60" href="/apple-touch-icon-60x60.png"><link rel="apple-touch-icon" sizes="72x72" href="/apple-touch-icon-72x72.png"><link rel="apple-touch-icon" sizes="76x76" href="/apple-touch-icon-76x76.png"><link rel="apple-touch-icon" sizes="114x114" href="/apple-touch-icon-114x114.png"><link rel="apple-touch-icon" sizes="120x120" href="/apple-touch-icon-120x120.png"><link rel="apple-touch-icon" sizes="144x144" href="/apple-touch-icon-144x144.png"><link rel="apple-touch-icon" sizes="152x152" href="/apple-touch-icon-152x152.png"><link rel="apple-touch-icon" sizes="167x167" href="/apple-touch-icon-167x167.png"><link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon-180x180.png"><link rel="apple-touch-icon" sizes="1024x1024" href="/apple-touch-icon-1024x1024.png"><meta name="apple-mobile-web-app-capable" content="yes"><meta name="apple-mobile-web-app-status-bar-style" content="black-translucent"><meta name="apple-mobile-web-app-title" content="Podcastindex.org"><link rel="apple-touch-startup-image" media="(device-width: 320px) and (device-height: 568px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-640x1136.png"><link rel="apple-touch-startup-image" media="(device-width: 375px) and (device-height: 667px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-750x1334.png"><link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 896px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-828x1792.png"><link rel="apple-touch-startup-image" media="(device-width: 375px) and (device-height: 812px) and (-webkit-device-pixel-ratio: 3) and (orientation: portrait)" href="/apple-touch-startup-image-1125x2436.png"><link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 736px) and (-webkit-device-pixel-ratio: 3) and (orientation: portrait)" href="/apple-touch-startup-image-1242x2208.png"><link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 896px) and (-webkit-device-pixel-ratio: 3) and (orientation: portrait)" href="/apple-touch-startup-image-1242x2688.png"><link rel="apple-touch-startup-image" media="(device-width: 768px) and (device-height: 1024px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-1536x2048.png"><link rel="apple-touch-startup-image" media="(device-width: 834px) and (device-height: 1112px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-1668x2224.png"><link rel="apple-touch-startup-image" media="(device-width: 834px) and (device-height: 1194px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-1668x2388.png"><link rel="apple-touch-startup-image" media="(device-width: 1024px) and (device-height: 1366px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-2048x2732.png"><link rel="apple-touch-startup-image" media="(device-width: 810px) and (device-height: 1080px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-1620x2160.png"><link rel="apple-touch-startup-image" media="(device-width: 320px) and (device-height: 568px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-1136x640.png"><link rel="apple-touch-startup-image" media="(device-width: 375px) and (device-height: 667px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-1334x750.png"><link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 896px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-1792x828.png"><link rel="apple-touch-startup-image" media="(device-width: 375px) and (device-height: 812px) and (-webkit-device-pixel-ratio: 3) and (orientation: landscape)" href="/apple-touch-startup-image-2436x1125.png"><link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 736px) and (-webkit-device-pixel-ratio: 3) and (orientation: landscape)" href="/apple-touch-startup-image-2208x1242.png"><link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 896px) and (-webkit-device-pixel-ratioLine truncated
|
||||
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/github-markdown-css/4.0.0/github-markdown.min.css">
|
||||
<style>
|
||||
.markdown-body {
|
||||
box-sizing: border-box;
|
||||
min-width: 200px;
|
||||
max-width: 980px;
|
||||
margin: 0 auto;
|
||||
padding: 45px;
|
||||
}
|
||||
|
||||
@media (max-width: 767px) {
|
||||
.markdown-body {
|
||||
padding: 15px;
|
||||
}
|
||||
}
|
||||
</style>
|
||||
</head>
|
||||
|
||||
<body>
|
||||
<article class="markdown-body">
|
||||
<h1 id="rss-namespace-extension-for-podcasting-tag-specification">RSS Namespace Extension for Podcasting (Tag Specification)</h1>
|
||||
<p>A wholistic RSS namespace for podcasting that is meant to synthesize the fragmented world of podcast namespaces. As elements are canonized, they will be added to this document so developers can begin implementation. The specifications below are considered locked and the team will prioritize backward compatibility. We are operating under the <a href="http://scripting.com/2017/05/09/rulesForStandardsmakers.html">Rules for Standards-Makers</a>.</p>
|
||||
<p>The namespace for this extension is <code>https://podcastindex.org/namespace/1.0</code>. Clients which recognize this namespace must also recognize <code>https://github.com/Podcastindex-org/podcast-namespace/blob/main/docs/1.0.md</code> as identical. The suggested tag prefix for use in XML is <code>podcast</code>, but clients should support alternate prefixes for this namespace. If your application generates RSS feeds and you implement one or more elements below, you will need to link this document in your XML:</p>
|
||||
<pre><code class="language-xml"><rss version="2.0" xmlns:podcast="https://podcastindex.org/namespace/1.0"></code></pre>
|
||||
<h1 id="podcast-tags">Podcast Tags</h1>
|
||||
<p>Each tag below exists in the podcast namespace within the specified parent. All attributes are required unless explicitly specified as optional.</p>
|
||||
<p>Anywhere the url of a hyper-text based resource is specified, it must be given as <code>https:</code> and not <code>http:</code>.</p>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="transcript">Transcript</h2>
|
||||
<p><code><podcast:transcript></code><br><br>
|
||||
This tag is used to link to a transcript or closed captions file. Multiple tags can be present for multiple transcript formats.</p>
|
||||
<p>Detailed file format information and example files are <a href="../transcripts/transcripts.md">here</a>.</p>
|
||||
<h3 id="parent">Parent</h3>
|
||||
<p> <code><item></code></p>
|
||||
<h3 id="count">Count</h3>
|
||||
<p> Multiple</p>
|
||||
<h3>Attributes</h3>
|
||||
<ul>
|
||||
<li><p><strong>url (required):</strong> URL of the podcast transcript.</p>
|
||||
</li>
|
||||
<li><p><strong>type (required):</strong> Mime type of the file such as <code>text/plain</code>, <code>text/html</code>, <code>text/vtt</code>, <code>application/json</code>, <code>application/x-subrip</code></p>
|
||||
</li>
|
||||
<li><p><strong>language (optional):</strong> The language of the linked transcript. If there is no language attribute given, the linked file is assumed to be the same language that is specified by the RSS <code><language></code> element.</p>
|
||||
</li>
|
||||
<li><p><strong>rel (optional):</strong> If the rel="captions" attribute is present, the linked file is considered to be a closed captions file, regardless of what the mime type is. In that scenario, time codes are assumed to be present in the file in some capacity.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<h3 id="examples">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:transcript url="https://example.com/episode1/transcript.html" type="text/html" /></code></pre>
|
||||
<pre><code class="language-xml"><podcast:transcript url="https://example.com/episode1/transcript.vtt" type="text/vtt" /></code></pre>
|
||||
<pre><code class="language-xml"><podcast:transcript url="https://example.com/episode1/transcript.json" type="application/json" language="es" rel="captions" /></code></pre>
|
||||
<pre><code class="language-xml"><podcast:transcript url="https://example.com/episode1/transcript.srt" type="application/x-subrip" rel="captions" /></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="locked">Locked</h2>
|
||||
<p><code><podcast:locked></code><br><br>
|
||||
This tag may be set to <code>yes</code> or <code>no</code>. The purpose is to tell other podcast platforms whether they are allowed to import this feed. A value of <code>yes</code> means that any attempt to import this feed into a new platform should be rejected.</p>
|
||||
<h3 id="parent-1">Parent</h3>
|
||||
<p> <code><channel></code></p>
|
||||
<h3 id="count-1">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="node-value">Node value</h3>
|
||||
<p> The node value must be "yes" or "no".</p>
|
||||
<h3 id="attributes-1">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>owner (required):</strong> The owner attribute is an email address that can be used to verify ownership of this feed during move and import operations. This could be a public email or a virtual email address at the hosting provider that redirects to the owner's true email address. This is a critical element, and it is expected that podcast hosting providers (if not providing virtual addresses) will allow setting this element's value in their GUI with an emphasis to their users of how important it is to have this be a valid, working email address.</li>
|
||||
</ul>
|
||||
<h3 id="examples-1">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:locked owner="[email protected]">yes</podcast:locked></code></pre>
|
||||
<pre><code class="language-xml"><podcast:locked owner="[email protected]">no</podcast:locked></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="funding">Funding</h2>
|
||||
<p><code><podcast:funding></code><br><br>
|
||||
This tag lists possible donation/funding links for the podcast. The content of the tag is the recommended string to be used with the link.</p>
|
||||
<h3 id="parent-2">Parent</h3>
|
||||
<p> <code><channel></code></p>
|
||||
<h3 id="count-2">Count</h3>
|
||||
<p> Multiple</p>
|
||||
<h3 id="node-value-1">Node value</h3>
|
||||
<p> This is a free form string supplied by the creator which they expect to be displayed in the app next to the link. Please do not exceed <code>128 characters</code> for the node value or it may be
|
||||
truncated by aggregators.</p>
|
||||
<h3 id="attributes-2">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>url (required):</strong> The URL to be followed to fund the podcast.</li>
|
||||
</ul>
|
||||
<h3 id="examples-2">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:funding url="https://www.example.com/donations">Support the show!</podcast:funding></code></pre>
|
||||
<pre><code class="language-xml"><podcast:funding url="https://www.example.com/members">Become a member!</podcast:funding></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="chapters">Chapters</h2>
|
||||
<p><code><podcast:chapters></code><br><br>
|
||||
Links to an external file (see example file) containing chapter data for the episode. See the <a href="https://github.com/Podcastindex-org/podcast-namespace/blob/main/chapters/jsonChapters.md">jsonChapters.md</a> file for a description of the chapter file syntax. And, see the <a href="https://github.com/Podcastindex-org/podcast-namespace/blob/main/chapters/example.json">example.json</a> example file for a real world example.</p>
|
||||
<p>Benefits with this approach are that chapters do not require altering audio files, and the chapters can be edited after publishing, since they are a separate file that can be requested on playback (or cached with download). JSON chapter information also allows chapters to be displayed by a wider range of playback tools, including web browsers (which typically have no access to ID3 tags), thus greatly simplifying chapter support; and images can be retrieved on playback, rather than bloating the filesize of the audio. The data held is compatible with normal ID3 tags, thus requiring no additional work for the publisher.</p>
|
||||
<h3 id="parent-3">Parent</h3>
|
||||
<p> <code><item></code></p>
|
||||
<h3 id="count-3">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="attributes-3">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>url (required):</strong> The URL where the chapters file is located.</li>
|
||||
<li><strong>type (required):</strong> Mime type of file - JSON prefered, 'application/json+chapters'.</li>
|
||||
</ul>
|
||||
<h3 id="examples-3">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:chapters url="https://example.com/episode1/chapters.json" type="application/json+chapters" /></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="soundbite">Soundbite</h2>
|
||||
<p><code><podcast:soundbite></code><br><br>
|
||||
Points to one or more soundbites within a podcast episode. The intended use includes episodes previews, discoverability, audiogram generation, episode highlights, etc. It should be assumed that the
|
||||
audio/video source of the soundbite is the audio/video given in the item's <a href="https://cyber.harvard.edu/rss/rss.html#ltenclosuregtSubelementOfLtitemgt"><code><enclosure></code></a> element.</p>
|
||||
<h3 id="parent-4">Parent</h3>
|
||||
<p> <code><item></code></p>
|
||||
<h3 id="count-4">Count</h3>
|
||||
<p> Multiple</p>
|
||||
<h3 id="node-value-2">Node value</h3>
|
||||
<p> This is a free form string from the podcast creator to specify a title for the soundbite. If the podcaster does not provide a value for the soundbite title, then leave the value blank, and podcast apps can decide to use the episode title or some other placeholder value in its place. Please do not exceed <code>128 characters</code>
|
||||
for the node value or it may be truncated by aggregators.</p>
|
||||
<h3 id="attributes-4">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>startTime (required):</strong> The time where the soundbite begins</li>
|
||||
<li><strong>duration (required):</strong> How long is the soundbite (recommended between 15 and 120 seconds)</li>
|
||||
</ul>
|
||||
<h3 id="examples-4">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:soundbite startTime="73.0" duration="60.0" /></code></pre>
|
||||
<pre><code class="language-xml"><podcast:soundbite startTime="1234.5" duration="42.25">Why the Podcast Namespace Matters</podcast:soundbite></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="person">Person</h2>
|
||||
<p><code><podcast:person></code><br><br>
|
||||
This element specifies a person of interest to the podcast. It is primarily intended to identify people like hosts, co-hosts and guests. Although, it is flexible enough to allow fuller credits to be
|
||||
given using the roles and groups that are listed in the <a href="https://podcasttaxonomy.com/">Podcast Taxonomy Project</a></p>
|
||||
<h3 id="parent-5">Parent</h3>
|
||||
<p> <code><item></code> or <code><channel></code></p>
|
||||
<h3 id="count-5">Count</h3>
|
||||
<p> Multiple</p>
|
||||
<h3 id="node-value-3">Node value</h3>
|
||||
<p> This is the full name or alias of the person. This value cannot be blank. Please do not exceed <code>128 characters</code> for the node value or it may be truncated by aggregators.</p>
|
||||
<h3 id="attributes-5">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>role:</strong> (optional) Used to identify what role the person serves on the show or episode. This should be a reference to an official role within the Podcast Taxonomy Project list (see below). If <code>role</code> is missing then "host" is assumed.</li>
|
||||
<li><strong>group:</strong> (optional) This should be a reference to an official group within the Podcast Taxonomy Project list. If <code>group</code> is not present, then "cast" is assumed.</li>
|
||||
<li><strong>img:</strong> (optional) This is the url of a picture or avatar of the person.</li>
|
||||
<li><strong>href:</strong> (optional) The url to a relevant resource of information about the person, such as a homepage or third-party profile platform. Please see the <a href="https://github.com/Podcastindex-org/podcast-namespace/blob/main/example.xml">example feed</a> for possible choices of what to use here.</li>
|
||||
</ul>
|
||||
<p>The <code>role</code> and <code>group</code> attributes are case-insensitive. So, "Host" is the same as "host", and "Cover Art Designer" is the same as "cover art designer".</p>
|
||||
<p>The full taxonomy list is <a href="https://github.com/Podcastindex-org/podcast-namespace/blob/main/taxonomy.json">here</a> as a json file.</p>
|
||||
<h3 id="examples-5">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:person href="https://example.com/johnsmith/blog" img="http://example.com/images/johnsmith.jpg">John Smith</podcast:person></code></pre>
|
||||
<pre><code class="language-xml"><podcast:person role="guest" href="https://www.imdb.com/name/nm0427852888/" img="http://example.com/images/janedoe.jpg">Jane Doe</podcast:person></code></pre>
|
||||
<pre><code class="language-xml"><podcast:person role="guest" href="https://www.wikipedia/alicebrown" img="http://example.com/images/alicebrown.jpg">Alice Brown</podcast:person></code></pre>
|
||||
<pre><code class="language-xml"><podcast:person group="writing" role="guest" href="https://www.wikipedia/alicebrown" img="http://example.com/images/alicebrown.jpg">Alice Brown</podcast:person></code></pre>
|
||||
<pre><code class="language-xml"><podcast:person group="visuals" role="Cover Art Designer" href="https://example.com/artist/beckysmith">Becky Smith</podcast:person></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2>Location</h2>
|
||||
<p><code><podcast:location></code><br><br>
|
||||
This tag is intended to describe the location of editorial focus for a podcast's content (i.e. "what place is this podcast about?"). The tag has many use cases and is one of the more complex ones. You
|
||||
are <strong>highly encouraged</strong> to read the full <a href="https://github.com/Podcastindex-org/podcast-namespace/blob/main/location/location.md">implementation document</a> before starting to code for it.</p>
|
||||
<h3 id="parent-6">Parent</h3>
|
||||
<p> <code><item></code> or <code><channel></code></p>
|
||||
<h3 id="count-6">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="node-value-4">Node Value</h3>
|
||||
<p> This is a free-form string meant to be a human readable location. It may conform to conventional location verbiage (i.e. "Austin, TX"), but it shouldn't be depended on to be parseable in any specific
|
||||
way. This value cannot be blank. Please do not exceed <code>128 characters</code> for the node value or it may be truncated by aggregators.</p>
|
||||
<h3 id="attributes-6">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>geo:</strong> (recommended) This is a latitude and longitude given in "geo" notation (i.e. "geo:30.2672,97.7431").</li>
|
||||
<li><strong>osm:</strong> (recommended) The Open Street Map identifier of this place, given using the OSM notation (i.e. "R113314")</li>
|
||||
</ul>
|
||||
<h3 id="examples-6">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:location geo="geo:30.2672,97.7431" osm="R113314">Austin, TX</podcast:location></code></pre>
|
||||
<pre><code class="language-xml"><podcast:location geo="geo:33.51601,-86.81455" osm="R6930627">Birmingham Civil Rights Museum</podcast:location></code></pre>
|
||||
<pre><code class="language-xml"><podcast:location geo="geo:-27.86159,153.3169" osm="W43678282">Dreamworld (Queensland)</podcast:location></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="season">Season</h2>
|
||||
<p><code><podcast:season></code><br><br>
|
||||
This element allows for identifying which episodes in a podcast are part of a particular "season", with an optional season name attached.</p>
|
||||
<h3 id="parent-7">Parent</h3>
|
||||
<p> <code><item></code></p>
|
||||
<h3 id="count-7">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="node-value-5">Node Value</h3>
|
||||
<p> The node value is an integer, and represents the season "number". It is required.</p>
|
||||
<h3 id="attributes-7">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>name:</strong> (optional) - This is the "name" of the season. If this attribute is present, applications are free to <strong>not</strong> show the season number to the end user, and may use it simply for chronological sorting and grouping purposes.</li>
|
||||
</ul>
|
||||
<p>Please do not exceed <code>128 characters</code> for the name attribute.</p>
|
||||
<h3 id="examples-7">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:season>5</podcast:season></code></pre>
|
||||
<pre><code class="language-xml"><podcast:season name="Race for the Whitehouse 2020">3</podcast:season></code></pre>
|
||||
<pre><code class="language-xml"><podcast:season name="Egyptology: The 19th Century">1</podcast:season></code></pre>
|
||||
<pre><code class="language-xml"><podcast:season name="The Yearling - Chapter 3">3</podcast:season></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="episode">Episode</h2>
|
||||
<p><code><podcast:episode></code><br><br>
|
||||
This element exists largely for compatibility with the <code>season</code> tag. But, it also allows for a similar idea to what "name" functions as in that element.</p>
|
||||
<h3 id="parent-8">Parent</h3>
|
||||
<p> <code><item></code></p>
|
||||
<h3 id="count-8">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="node-value-6">Node Value</h3>
|
||||
<p> The node value is a decimal number. It is required.</p>
|
||||
<h3 id="attributes-8">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>display:</strong> (optional) - If this attribute is present, podcast apps and aggregators are encouraged to show its value instead of the purely numerical node value. This attribute is a string.</li>
|
||||
</ul>
|
||||
<p>The episode numbers are decimal, so numbering such as <code>100.5</code> is acceptable if there was a special mini-episode published between two other episodes. In that scenario, the number would help with proper
|
||||
chronological sorting, while the <code>display</code> attribute could specify an alternate special "number" (a moniker) to display for the episode in a podcast player app UI.</p>
|
||||
<p>Please do not exceed <code>32 characters</code> for the display attribute.</p>
|
||||
<h3 id="examples-8">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:episode>3</podcast:episode></code></pre>
|
||||
<pre><code class="language-xml"><podcast:episode>315.5</podcast:episode></code></pre>
|
||||
<pre><code class="language-xml"><podcast:episode display="Ch.3">204</podcast:episode></code></pre>
|
||||
<pre><code class="language-xml"><podcast:episode display="Day 5">9</podcast:episode></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="trailer">Trailer</h2>
|
||||
<p><code><podcast:trailer></code><br><br>
|
||||
This element is used to define the location of an audio or video file to be used as a trailer for the entire podcast or a specific season. There can be more than one trailer present in the channel of the
|
||||
feed. This element is basically just like an <a href="https://cyber.harvard.edu/rss/rss.html#ltenclosuregtSubelementOfLtitemgt"><code><enclosure></code></a> with the extra <code>pubdate</code> and <code>season</code> attributes added.</p>
|
||||
<p>If there is more than one trailer tag present in the channel, the most recent one (according to its <code>pubdate</code>) should be chosen as the preview by default within podcast apps.</p>
|
||||
<h3 id="parent-9">Parent</h3>
|
||||
<p> <code><channel></code></p>
|
||||
<h3 id="count-9">Count</h3>
|
||||
<p> Multiple</p>
|
||||
<h3 id="node-value-7">Node Value</h3>
|
||||
<p> The node value is a string, which is the title of the trailer. It is required. Please do not exceed <code>128 characters</code> for the node value or it may be truncated by aggregators.</p>
|
||||
<h3 id="attributes-9">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>url:</strong> (required) This is a url that points to the audio or video file to be played. This attribute is a string.</li>
|
||||
<li><strong>pubdate:</strong> (required) The date the trailer was published. This attribute is an RFC2822 formatted date string.</li>
|
||||
<li><strong>length:</strong> (recommended) The length of the file in bytes. This attribute is a number.</li>
|
||||
<li><strong>type:</strong> (recommended) The mime type of the file. This attribute is a string.</li>
|
||||
<li><strong>season:</strong> (optional) If this attribute is present it specifies that this trailer is for a particular season number. This attribute is a number.</li>
|
||||
</ul>
|
||||
<p>If the <code>season</code> attribute is present, it must be a number that matches the format of the <code><podcast:season></code> tag. So, for a podcast that has 3 published seasons, a new <code><podcast:trailer season="4"></code> tag can
|
||||
be put in the channel to later be matched up with a <code><podcast:season>4<podcast:season></code> tag when it is published within a new <code><item></code>.</p>
|
||||
<h4 id="examples-9">Examples</h4>
|
||||
<pre><code class="language-xml"><podcast:trailer pubdate="Thu, 01 Apr 2021 08:00:00 EST" url="https://example.org/trailers/teaser" length="12345678" type="audio/mp3">Coming April 1st, 2021</podcast:trailer></code></pre>
|
||||
<pre><code class="language-xml"><podcast:trailer pubdate="Thu, 01 Apr 2021 08:00:00 EST" url="https://example.org/trailers/season4teaser" length="12345678" type="video/mp4" season="4">Season 4: Race for the Whitehouse</podcast:trailer>
|
||||
|
||||
(later matches with)
|
||||
|
||||
<podcast:season name="Race for the Whitehouse">4</podcast:season></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="license">License</h2>
|
||||
<p><code><podcast:license></code><br><br>
|
||||
This element defines a license that is applied to the audio/video content of a single episode, or the audio/video of the podcast as a whole. Custom licenses must always include a url attribute. Implementors are encouraged
|
||||
to read the license tag companion <a href="https://github.com/Podcastindex-org/podcast-namespace/blob/main/proposal-docs/license/license.md">document</a> for a more complete picture of what this tag is intended to accomplish.</p>
|
||||
<h3 id="parent-10">Parent</h3>
|
||||
<p> <code><channel></code> or <code><item></code></p>
|
||||
<h3 id="count-10">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="node-value-8">Node Value</h3>
|
||||
<p> The node value must be a lower-cased reference to a license "identifier" defined in the <a href="https://spdx.org/licenses/">SPDX License List</a> file if the license being used is a well-known, public license. Or, if it is a custom license, it
|
||||
must be a free form abbreviation of the name of the license as you reference it publicly. Please do not exceed <code>128 characters</code> for the node value or it may be truncated by aggregators.</p>
|
||||
<h3 id="attributes-10">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>url:</strong> (optional) This is a url that points to the full, legal language of the license being referenced. This attribute is optional for well-known public licenses. For new, or custom licenses it is required.</li>
|
||||
</ul>
|
||||
<h3 id="examples-10">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:license>cc-by-4.0</podcast:license></code></pre>
|
||||
<pre><code class="language-xml"><podcast:license url="https://example.org/mypodcastlicense/full.pdf">my-podcast-license-v1</podcast:license></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="alternate-enclosure">Alternate Enclosure</h2>
|
||||
<p><code><podcast:alternateEnclosure></code><br><br>
|
||||
This element is meant to provide different versions of, or companion media to the main <a href="https://cyber.harvard.edu/rss/rss.html#ltenclosuregtSubelementOfLtitemgt"><code><enclosure></code></a> file. This could be an audio only version of a video podcast to allow apps to switch back and forth between audio/video,
|
||||
lower (or higher) bitrate versions for bandwidth constrained areas, alternative codecs for different device platforms, alternate URI schemes and download types such as IPFS or WebTorrent, commentary tracks or supporting source clips, etc.
|
||||
This is a complex tag, so implementors are highly encouraged to read the companion <a href="https://github.com/Podcastindex-org/podcast-namespace/blob/main/proposal-docs/alternateEnclosure/alternateEnclosure.md">document</a> for a fuller understanding of how
|
||||
this tag works and what it is capable of.</p>
|
||||
<h3 id="parent-11">Parent</h3>
|
||||
<p> <code><item></code></p>
|
||||
<h3 id="count-11">Count</h3>
|
||||
<p> Multiple</p>
|
||||
<h3 id="node-value-9">Node Value</h3>
|
||||
<p> The node value must be one or more <code><podcast:source></code> elements that each define a uri where the media file can be downloaded or streamed. A single, optional <code><podcast:integrity></code> element may also be included
|
||||
to allow for file integrity checking.</p>
|
||||
<h3 id="attributes-11">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>type:</strong> (required) Mime type of the media asset.</li>
|
||||
<li><strong>length:</strong> (required) Length of the file in bytes.</li>
|
||||
<li><strong>bitrate:</strong> (optional) Encoding bitrate of media asset.</li>
|
||||
<li><strong>height:</strong> (optional) Height of the media asset for video formats.</li>
|
||||
<li><strong>lang:</strong> (optional) An <a href="https://en.wikipedia.org/wiki/BCP_47">IETF language tag (BCP 47)</a> code identifying the language of this media.</li>
|
||||
<li><strong>title:</strong> (optional) A human-readable string identifying the name of the media asset. Should be limited to 32 characters for UX.</li>
|
||||
<li><strong>rel:</strong> (optional) Provides a method of offering and/or grouping together different media elements. If not set, or set to "default", the media will be grouped with the enclosure and assumed to be an alternative to the enclosure's encoding/transport. This attribute can and should be the same for items with the same content encoded by different means. Should be limited to 32 characters for UX.</li>
|
||||
<li><strong>codecs:</strong> (optional) An <a href="https://tools.ietf.org/html/rfc6381">RFC 6381</a> string specifying the codecs available in this media.</li>
|
||||
<li><strong>default:</strong> (optional) Boolean specifying whether or not the given media is the same as the file from the enclosure element and should be the preferred media element. The primary reason to set this is to offer alternative transports for the enclosure. If not set, this should be assumed to be false.</li>
|
||||
</ul>
|
||||
<h3 id="examples-11">Examples</h3>
|
||||
<pre><code class="language-xml"><enclosure url="https://example.com/file-0.mp3" length="43200000" type="audio/mpeg" />
|
||||
|
||||
<podcast:alternateEnclosure type="audio/mpeg" length="43200000" bitrate="128000" default="true" title="Standard">
|
||||
<podcast:source uri="https://example.com/file-0.mp3" />
|
||||
<podcast:source uri="ipfs://someRandomMpegFile" />
|
||||
</podcast:alternateEnclosure>
|
||||
|
||||
<podcast:alternateEnclosure type="audio/opus" length="32400000" bitrate="96000" title="High quality">
|
||||
<podcast:source uri="https://example.com/file-high.opus" />
|
||||
<podcast:source uri="ipfs://someRandomHighBitrateOpusFile" />
|
||||
</podcast:alternateEnclosure>
|
||||
|
||||
<podcast:alternateEnclosure type="audio/aac" length="54000000" bitrate="160000" title="High quality AAC">
|
||||
<podcast:source uri="https://example.com/file-proprietary.aac" />
|
||||
<podcast:source uri="ipfs://someRandomProprietaryAACFile" />
|
||||
</podcast:alternateEnclosure>
|
||||
|
||||
<podcast:alternateEnclosure type="audio/opus" length="5400000" bitrate="16000" title="Low bandwidth">
|
||||
<podcast:source uri="https://example.com/file-low.opus" />
|
||||
<podcast:source uri="ipfs://someRandomLowBitrateOpusFile" />
|
||||
</podcast:alternateEnclosure></code></pre>
|
||||
<pre><code class="language-xml"><podcast:alternateEnclosure type="audio/mpeg" length="2490970" bitrate="160707.74">
|
||||
<podcast:source uri="https://example.com/file-0.mp3" />
|
||||
<podcast:source uri="ipfs://QmdwGqd3d2gFPGeJNLLCshdiPert45fMu84552Y4XHTy4y" />
|
||||
<podcast:source uri="https://example.com/file-0.torrent" contentType="application/x-bittorrent" />
|
||||
<podcast:source uri="http://example.onion/file-0.mp3" />
|
||||
</podcast:alternateEnclosure>
|
||||
|
||||
<podcast:alternateEnclosure type="video/mp4" length="10562995" bitrate="681483.55" height="1080">
|
||||
<podcast:source uri="https://example.com/file-1080.mp4" />
|
||||
<podcast:source uri="ipfs://QmfQKJcp2xdByEt8mzWr1AJUhwvb9rdWPoacvdq2roDhgh" />
|
||||
<podcast:source uri="https://example.com/file-1080.torrent" contentType="application/x-bittorrent" />
|
||||
<podcast:source uri="http://example.onion/file-1080.mp4" />
|
||||
</podcast:alternateEnclosure></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="source">Source</h2>
|
||||
<p><code><podcast:source></code><br><br>
|
||||
This element defines a uri location for a <code><podcast:alternateEnclosure></code> media file. It is meant to be used as a child of the <code><podcast:alternateEnclosure></code> element. At least one <code><podcast:source></code> element must be
|
||||
present within every <code><podcast:alternateEnclosure></code> element.</p>
|
||||
<h3 id="parent-12">Parent</h3>
|
||||
<p> <code><podcast:alternateEnclosure></code></p>
|
||||
<h3 id="count-12">Count</h3>
|
||||
<p> Multiple</p>
|
||||
<h3 id="attributes-12">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>uri:</strong> (required) This is the uri where the media file resides.</li>
|
||||
<li><strong>contentType:</strong> (optional) This is a string that declares the mime-type of the file. It is useful if the transport mechanism is different than the file being delivered, as is the case with a torrents.</li>
|
||||
</ul>
|
||||
<h3 id="examples-12">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:alternateEnclosure type="video/mp4" length="7924786" bitrate="511276.52" height="720">
|
||||
<podcast:source uri="https://example.com/file-720.mp4" />
|
||||
<podcast:source uri="ipfs://QmX33FYehk6ckGQ6g1D9D3FqZPix5JpKstKQKbaS8quUFb" />
|
||||
<podcast:source uri="https://example.com/file-720.torrent" contentType="application/x-bittorrent" />
|
||||
<podcast:source uri="http://example.onion/file-720.mp4" />
|
||||
</podcast:alternateEnclosure></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="integrity">Integrity</h2>
|
||||
<p><code><podcast:integrity></code><br><br>
|
||||
This element defines a method of verifying integrity of the media given either an <a href="https://www.w3.org/TR/SRI/">SRI-compliant integrity string</a> (preferred) or a base64 encoded PGP signature. This element is optional within a
|
||||
<code><podcast:alternateEnclosure></code> element. It allows to ensure that the file has not been tampered with.</p>
|
||||
<h3 id="parent-13">Parent</h3>
|
||||
<p> <code><podcast:alternateEnclosure></code></p>
|
||||
<h3 id="count-13">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="attributes-13">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>type:</strong> (required) Type of integrity, either "sri" or "pgp-signature".</li>
|
||||
<li><strong>value:</strong> (required) Value of the sri string or base64 encoded pgp signature.</li>
|
||||
</ul>
|
||||
<h3 id="examples-13">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:alternateEnclosure type="video/mp4" length="7924786" bitrate="511276.52" height="720">
|
||||
<podcast:source uri="https://example.com/file-720.mp4" />
|
||||
<podcast:source uri="ipfs://QmX33FYehk6ckGQ6g1D9D3FqZPix5JpKstKQKbaS8quUFb" />
|
||||
<podcast:integrity type="sri" value="sha384-ExVqijgYHm15PqQqdXfW95x+Rs6C+d6E/ICxyQOeFevnxNLR/wtJNrNYTjIysUBo" />
|
||||
</podcast:alternateEnclosure></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="guid">Guid</h2>
|
||||
<p><code><podcast:guid></code><br><br>
|
||||
This element is used to declare a unique, global identifier for a podcast. The value is a UUIDv5, and is easily generated from the RSS feed url, with the <strong>protocol scheme and trailing slashes stripped off</strong>, combined with a unique "podcast" namespace which has a UUID of <code>ead4c236-bf58-58c6-a2c6-a6b28d128cb6</code>. Tools like <a href="https://www.uuidtools.com/v5">this one</a> can help generate these values by hand. Or, language libraries like <a href="https://github.com/sporkmonger/uuidtools">this one</a> in Ruby are widely available.</p>
|
||||
<p>A podcast gets assigned a podcast:guid once in its lifetime using its current feed url (at the time of assignment) as the seed value. That GUID is then meant to follow the podcast from then on, for the duration of its life, even if the feed url changes. This means that when a podcast moves from one hosting platform to another, its podcast:guid should be discovered by the new host and imported into the new platform for inclusion into the feed.</p>
|
||||
<p>Using this pattern, podcasts can maintain a consistent identity across the open RSS ecosystem without a central authority.</p>
|
||||
<p><strong>Tips:</strong></p>
|
||||
<ul>
|
||||
<li>All podcasts in the Podcast Index have already been assigned a GUID; but if one exists in the RSS feed, that value is canonical.</li>
|
||||
<li>You can programmatically spot a GUID: it is 36 characters long, and contains four hyphen characters.</li>
|
||||
<li>Be aware that Amazon Music also uses separate UUIDv5 identifiers within their podcast directory, which are calculated differently and unrelated to this specification. </li>
|
||||
<li>The following regular expression (regex) will match a GUID:<pre><code class="language-re">[0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}`</code></pre>
|
||||
</li>
|
||||
</ul>
|
||||
<h3 id="parent-14">Parent</h3>
|
||||
<p> <code><channel></code></p>
|
||||
<h3 id="count-14">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="node-value-10">Node Value</h3>
|
||||
<p> The node value is a UUIDv5 string.</p>
|
||||
<h3 id="attributes-14">Attributes</h3>
|
||||
<p> There are no attributes for this tag.</p>
|
||||
<h3 id="examples-14">Examples</h3>
|
||||
<p>Example GUID for feed url <code>mp3s.nashownotes.com/pc20rss.xml</code>:</p>
|
||||
<pre><code class="language-xml"><podcast:guid>917393e3-1b1e-5cef-ace4-edaa54e1f810</podcast:guid></code></pre>
|
||||
<p>Example GUID for feed url <code>podnews.net/rss</code>:</p>
|
||||
<pre><code class="language-xml"><podcast:guid>9b024349-ccf0-5f69-a609-6b82873eab3c</podcast:guid></code></pre>
|
||||
<h3 id="guid-enabled-fast-follow-share-links">Guid-enabled fast-follow share links</h3>
|
||||
<p> The <code>podcast:guid</code> value above enables podcasters to produce a link that can share a podcast on a variety of different platforms.</p>
|
||||
<p> The format of the link is <code>https://(a podcast website link)#fastfollow-(type):(a podcast guid)</code></p>
|
||||
<p> <code>type</code> is currently <code>podcast</code>, but may be extended in future.</p>
|
||||
<p> A working example is <a href="https://podnews.net/podcast/i8xe9/listen#fastfollow-podcast:9b024349-ccf0-5f69-a609-6b82873eab3c">https://podnews.net/podcast/i8xe9/listen#fastfollow-podcast:9b024349-ccf0-5f69-a609-6b82873eab3c</a> or the QR code given below.</p>
|
||||
<p> <img alt="podnews-qr" src="https://user-images.githubusercontent.com/231941/127796108-d819de43-6c0e-4c7b-9579-ed1f19989443.png"></p>
|
||||
<p> When scanned on a mobile phone's camera app, this link will go to the specified podcast website. Behavior of this website is up to the creator: some may use a default homepage, others may sniff the useragent and open a default podcast app on a device. In the working example, above, an iPhone user may be taken to Apple Podcasts; an Android user may be taken to Google Podcasts; and another device will be given a page with a player.</p>
|
||||
<p> When scanned on a QR code reader inside a podcast app, like <a href="https://curiocaster.com/">CurioCaster</a>, the app can parse the <code>podcast:guid</code> value from the URL, allowing the podcast to be opened within the application.</p>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="value">Value</h2>
|
||||
<p><code><podcast:value></code><br><br>
|
||||
This element designates the cryptocurrency or payment layer that will be used, the transport method for transacting the payments, and a suggested amount denominated in the given cryptocurrency.</p>
|
||||
<p>This element can exist at either the <code><channel></code> or <code><item></code> level. When it exists at the <code><item></code> level, it should be treated as an "override" of whatever is defined at the <code><channel></code> level.</p>
|
||||
<p>This is a complex tag, so implementors are HIGHLY encouraged to read the companion <a href="https://github.com/Podcastindex-org/podcast-namespace/blob/main/value/value.md">document</a> for a complete understanding of how
|
||||
this tag works and what it is capable of.</p>
|
||||
<h3 id="parent-15">Parent</h3>
|
||||
<p> <code><channel></code> or <code><item></code></p>
|
||||
<h3 id="count-15">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="node-value-11">Node Value</h3>
|
||||
<p> The node value must be one or more <code><podcast:valueRecipient></code> elements.</p>
|
||||
<h3 id="attributes-15">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>type:</strong> (required) This is the service slug of the cryptocurrency or protocol layer.</li>
|
||||
<li><strong>method:</strong> (required) This is the transport mechanism that will be used.</li>
|
||||
<li><strong>suggested:</strong> (optional) This is an optional suggestion on how much cryptocurrency to send with each payment.</li>
|
||||
</ul>
|
||||
<h3 id="examples-15">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:value
|
||||
type="lightning"
|
||||
method="keysend"
|
||||
suggested="0.00000005000"
|
||||
></podcast:value></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="value-recipient">Value Recipient</h2>
|
||||
<p><code><podcast:valueRecipient></code><br><br>
|
||||
The <code>valueRecipient</code> tag designates various destinations for payments to be sent to during consumption of the enclosed media. Each recipient is considered to receive a "split" of the total payment according to the number of shares given
|
||||
in the <code>split</code> attribute.</p>
|
||||
<p>This element may only exist within a parent <code><podcast:value></code> element.</p>
|
||||
<p>There is no limit on how many <code>valueRecipient</code> elements can be present in a given <code><podcast:value></code> element.</p>
|
||||
<p>This is a complex tag, so implementors are HIGHLY encouraged to read the companion <a href="https://github.com/Podcastindex-org/podcast-namespace/blob/main/value/value.md">document</a> for a complete understanding of how
|
||||
this tag works and what it is capable of.</p>
|
||||
<h3 id="parent-16">Parent</h3>
|
||||
<p> <code><podcast:value></code></p>
|
||||
<h3 id="count-16">Count</h3>
|
||||
<p> Multiple</p>
|
||||
<h3 id="attributes-16">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>name</strong> (recommended) A free-form string that designates who or what this recipient is.</li>
|
||||
<li><strong>customKey</strong> (optional) The name of a custom record key to send along with the payment.</li>
|
||||
<li><strong>customValue</strong> (optional) A custom value to pass along with the payment. This is considered the value that belongs to the <code>customKey</code>.</li>
|
||||
<li><strong>type</strong> (required) A slug that represents the type of receiving address that will receive the payment.</li>
|
||||
<li><strong>address</strong> (required) This denotes the receiving address of the payee.</li>
|
||||
<li><strong>split</strong> (required) The number of shares of the payment this recipient will receive.</li>
|
||||
<li><strong>fee</strong> (optional) If this attribute is not specified, it is assumed to be false.</li>
|
||||
</ul>
|
||||
<h3 id="examples-16">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:value type="lightning" method="keysend" suggested="0.00000015000">
|
||||
<podcast:valueRecipient
|
||||
name="Alice (Podcaster)"
|
||||
type="node"
|
||||
address="02d5c1bf8b940dc9cadca86d1b0a3c37fbe39cee4c7e839e33bef9174531d27f52"
|
||||
split="40"
|
||||
/>
|
||||
<podcast:valueRecipient
|
||||
name="Bob (Podcaster)"
|
||||
type="node"
|
||||
address="032f4ffbbafffbe51726ad3c164a3d0d37ec27bc67b29a159b0f49ae8ac21b8508"
|
||||
split="40"
|
||||
/>
|
||||
<podcast:valueRecipient
|
||||
name="Carol (Producer)"
|
||||
type="node"
|
||||
address="02dd306e68c46681aa21d88a436fb35355a8579dd30201581cefa17cb179fc4c15"
|
||||
split="15"
|
||||
/>
|
||||
<podcast:valueRecipient
|
||||
name="Hosting Provider"
|
||||
type="node"
|
||||
address="03ae9f91a0cb8ff43840e3c322c4c61f019d8c1c3cea15a25cfc425ac605e61a4a"
|
||||
split="5"
|
||||
fee="true"
|
||||
/>
|
||||
</podcast:value></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="medium">Medium</h2>
|
||||
<p><code><podcast:medium></code><br><br>
|
||||
The <code>medium</code> tag tells the an application what the content contained within the feed IS, as opposed to what the content is ABOUT in the case of a category. This allows a podcast app to
|
||||
modify it's behavior or UI to give a better experience to the user for this content. For example, if a podcast has <code><podcast:medium>music</podcast:medium></code> an app may choose to
|
||||
reset playback speed to 1x and adjust it's EQ settings to be better for music vs. spoken word.</p>
|
||||
<p>Accepted medium names are curated within a list maintained by the community as new mediums are discovered over time. Newly proposed mediums should require some level of
|
||||
justification to be added to this list. One may argue and/or prove use of a new medium even for only one application, should it prove different enough from existing mediums to have meaning.</p>
|
||||
<h3 id="parent-17">Parent</h3>
|
||||
<p> <code><channel></code></p>
|
||||
<h3 id="count-17">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="node-value-12">Node Value</h3>
|
||||
<p>The node value is a string denoting one of the following possible values:</p>
|
||||
<ul>
|
||||
<li><code>podcast</code> (default) - Describes a feed for a podcast show. If no <code>medium</code> tag is present in the channel, this medium is assumed.</li>
|
||||
<li><code>music</code> - A feed of music organized into an "album" with each item a song within the album.</li>
|
||||
<li><code>video</code> - Like a "podcast" but used in a more visual experience. Something akin to a dedicated video channel like would be found on YouTube.</li>
|
||||
<li><code>film</code> - Specific types of videos with one item per feed. This is different than a <code>video</code> medium because the content is considered to be cinematic; like a movie or documentary.</li>
|
||||
<li><code>audiobook</code> - Specific types of audio with one item per feed, or where items represent chapters within the book.</li>
|
||||
<li><code>newsletter</code> - Describes a feed of curated written articles. Newsletter articles now sometimes have an spoken version audio enclosure attached.</li>
|
||||
<li><code>blog</code> - Describes a feed of informally written articles. Similar to <code>newsletter</code> but more informal as in a traditional blog platform style.</li>
|
||||
</ul>
|
||||
<h3 id="examples-17">Examples</h3>
|
||||
<p>Example use for a "podcast":</p>
|
||||
<pre><code class="language-xml"><podcast:medium>podcast</podcast:medium></code></pre>
|
||||
<p>Example use for "music":</p>
|
||||
<pre><code class="language-xml"><podcast:medium>music</podcast:medium></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2>Images</h2>
|
||||
<p><code><podcast:images></code><br><br>
|
||||
This tag, when present, allows for specifying many different image sizes in a compact way at either the episode or channel level. The syntax is borrowed from
|
||||
the HTML5 <a href="https://html.spec.whatwg.org/multipage/images.html#srcset-attributes">srcset</a> syntax. It allows for describing multiple image sources with width and
|
||||
pixel hints directly in the attribute. Although the HTML5 <code>srcset</code> attribute allows relative urls, absolute urls are required in this tag - since the feed url may not represent an appropriate base url for relativization.</p>
|
||||
<h3 id="parent-18">Parent</h3>
|
||||
<p> <code><channel></code> or <code><item></code></p>
|
||||
<h3 id="count-18">Count</h3>
|
||||
<p> Single</p>
|
||||
<h3 id="attributes-17">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>srcset</strong> (required) A string that denotes each image url followed by a space and the pixel width, with each one separated by a comma. See the example<pre><code> for a clear view of the syntax.</code></pre>
|
||||
</li>
|
||||
</ul>
|
||||
<h3 id="examples-18">Examples</h3>
|
||||
<p>Example of specifying four different image sizes:</p>
|
||||
<pre><code class="language-xml"><podcast:images
|
||||
srcset="https://example.com/images/ep1/pci_avatar-massive.jpg 1500w,
|
||||
https://example.com/images/ep1/pci_avatar-middle.jpg 600w,
|
||||
https://example.com/images/ep1/pci_avatar-small.jpg 300w,
|
||||
https://example.com/images/ep1/pci_avatar-tiny.jpg 150w"
|
||||
/></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="live-item">Live Item</h2>
|
||||
<p><code><podcast:liveItem></code><br><br>
|
||||
The <code>liveItem</code> tag is used for a feed to deliver a live audio or video stream to podcast apps. It takes the same format as a standard <code><item></code> episode tag, and all tags that are
|
||||
allowed as children of a normal <code><item></code> are also allowed as children of <code><podcast:liveItem></code>. Note that "allowed" is not the same as "supported". So, just like a normal <code><item></code>,
|
||||
you cannot depend on all apps to support all tags within <code><podcast:liveItem></code>, especially when the function of the tag is not obvious. For instance, including an <code><itunes:duration></code>
|
||||
tag in a live item is probably a waste of time since apps will not know what to do with that value in the context of live media.</p>
|
||||
<p>This tag will also make use of the <a href="https://podping.cloud">podping</a> notification network. A podping notification SHOULD be sent out by the host when the live stream starts, to let
|
||||
apps know.</p>
|
||||
<h3 id="parent-19">Parent</h3>
|
||||
<p> <code><channel></code></p>
|
||||
<h3 id="count-19">Count</h3>
|
||||
<p> Multiple</p>
|
||||
<h3 id="node-value-13">Node Value</h3>
|
||||
<p>All tags that are valid as children of a standard <code><item></code> tag are also valid as children here.</p>
|
||||
<p>When specifying the audio/video source, the <a href="#alternate-enclosure"><code><podcast:alternateEnclosure></code></a> tag is highly encouraged since it gives the broadest coverage of possible stream types and is
|
||||
explicit in it's communication of what transport protocol and media codecs are being used. In addition to <a href="#alternate-enclosure"><code><podcast:alternateEnclosure></code></a>, a standard <a href="https://cyber.harvard.edu/rss/rss.html#ltenclosuregtSubelementOfLtitemgt"><code><enclosure></code></a> should also
|
||||
be given as a fallback to support podcast apps that don't yet implement <a href="#alternate-enclosure"><code><podcast:alternateEnclosure></code></a>. Regardless of which enclosure tag is used, feed owners must be conscious
|
||||
of the fact that choosing a non-mainstream streaming protocol/codec will limit the number of apps that can play the content. For that reason, it's highly recommended to use only the two most widely supported
|
||||
protocols (mp3 and mp4/h.264) to ensure compatibility with the broadest number of apps on various platforms. Choosing a streaming format that is outside of this narrow list might exclude many
|
||||
apps from playing your content. As broader adoption of HLS, Opus, etc. becomes apparent, this recommendation will change to include newer formats.</p>
|
||||
<p>The <a href="#content-link"><code><podcast:contentLink></code></a> tag is also required to be present, to ensure that listeners have a fallback option in case their chosen app cannot play the given content stream directly. In
|
||||
most instances this will just be a link to an HTML page that can play the live stream. Such a page can reside on the podcaster's own website, a page provided by their hosting company or a third party
|
||||
platform they have chosen to use. Podcasters who live stream to multiple platforms at once can also use the <a href="#content-link"><code><podcast:contentLink></code></a> tag to provide links to those other platforms.</p>
|
||||
<p>A robust, well-written <code><podcast:liveItem></code> tag will include all three of: <a href="#alternate-enclosure"><code><podcast:alternateEnclosure></code></a>, <a href="https://cyber.harvard.edu/rss/rss.html#ltenclosuregtSubelementOfLtitemgt"><code><enclosure></code></a>
|
||||
and <a href="#content-link"><code><podcast:contentLink></code></a> to ensure the broadest interopability with podcast apps.</p>
|
||||
<p>The function of <code><guid></code> within a live item tag is the same as it is within a regular item. If the <code><guid></code> of a <code><podcast:liveItem></code> changes, it MUST be considered a new stream by
|
||||
podcast apps.</p>
|
||||
<h3 id="attributes-18">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>status</strong> (required) A string that must be one of <code>pending</code>, <code>live</code> or <code>ended</code>.</li>
|
||||
<li><strong>start</strong> (required) A string representing an ISO8601 timestamp that denotes the time when the stream is intended to start.</li>
|
||||
<li><strong>end</strong> (required) A string representing an ISO8601 timestamp that denotes the time when the stream is intended to end.</li>
|
||||
</ul>
|
||||
<p>The <code>start</code> and <code>end</code> attributes denote when the live stream "should" start and end. But, real life dictates that those times might not be adhered to. Apps are therefore encouraged
|
||||
not to rely solely on those times as anything more than an approximation. The canonical way to know if a stream has started is with the <code>status</code> attribute. If <code>status</code> is "live" then
|
||||
the stream has started.</p>
|
||||
<h3 id="examples-19">Examples</h3>
|
||||
<p>A complete example:</p>
|
||||
<pre><code class="language-xml"><podcast:liveItem status="live" start="2021-09-26T07:30:00.000-0600" end="2021-09-26T09:30:00.000-0600">
|
||||
<title>Podcasting 2.0 Live Show</title>
|
||||
<description>A look into the future of podcasting and how we get to Podcasting 2.0!</description>
|
||||
<link>https://example.com/podcast/live</link>
|
||||
<guid isPermaLink="true">https://example.com/live</guid>
|
||||
<author>John Doe ([email protected])</author>
|
||||
<podcast:images srcset="https://example.com/images/live/pci_avatar-massive.jpg 1500w,
|
||||
https://example.com/images/live/pci_avatar-middle.jpg 600w,
|
||||
https://example.com/images/live/pci_avatar-small.jpg 300w,
|
||||
https://example.com/images/live/pci_avatar-tiny.jpg 150w"
|
||||
/>
|
||||
<podcast:person href="https://www.podchaser.com/creators/adam-curry-107ZzmWE5f" img="https://example.com/images/adamcurry.jpg">Adam Curry</podcast:person>
|
||||
<podcast:person role="guest" href="https://github.com/daveajones/" img="https://example.com/images/davejones.jpg">Dave Jones</podcast:person>
|
||||
<podcast:person group="visuals" role="cover art designer" href="https://example.com/artist/beckysmith">Becky Smith</podcast:person>
|
||||
<podcast:alternateEnclosure type="audio/mpeg" length="312" default="true">
|
||||
<podcast:source uri="https://example.com/pc20/livestream" />
|
||||
</podcast:alternateEnclosure>
|
||||
<enclosure url="https://example.com/pc20/livestream?format=.mp3" type="audio/mpeg" length="312" />
|
||||
<podcast:contentLink href="https://youtube.com/pc20/livestream">YouTube!</podcast:contentLink>
|
||||
<podcast:contentLink href="https://twitch.com/pc20/livestream">Twitch!</podcast:contentLink>
|
||||
<podcast:contentLink href="https://example.com/html/livestream">Listen Live!</podcast:contentLink>
|
||||
</podcast:liveItem></code></pre>
|
||||
<p>A bare bones example:</p>
|
||||
<pre><code class="language-xml"><podcast:liveItem status="live" start="2021-09-26T07:30:00.000-0600" end="2021-09-26T09:30:00.000-0600">
|
||||
<title>Podcasting 2.0 Live Stream</title>
|
||||
<guid>e32b4890-983b-4ce5-8b46-f2d6bc1d8819</guid>
|
||||
<enclosure url="https://example.com/pc20/livestream?format=.mp3" type="audio/mpeg" length="312" />
|
||||
<podcast:contentLink href="https://example.com/html/livestream">Listen Live!</podcast:contentLink>
|
||||
</podcast:liveItem></code></pre>
|
||||
<p><br><br><br><br></p>
|
||||
<h2 id="content-link">Content Link</h2>
|
||||
<p><code><podcast:contentLink></code><br><br>
|
||||
The <code>contentLink</code> tag is used to indicate that the content begin delivered by the parent element can be found at an external location
|
||||
instead of, or in addition to, being delivered directly to the tag itself within an app. In most instances it is used as a fallback link for the user
|
||||
to use when the app itself can't handle a certain content delivery directly.</p>
|
||||
<p>For instance, perhaps a podcast feed specifies a <code><podcast:liveItem></code> to deliver a live stream to apps. The feed may also give a <code><podcast:contentLink></code>
|
||||
pointing to YouTube and Twitch versions of the live stream as well, just in case the listener uses an app that doesn't fully support live streaming content.</p>
|
||||
<p>Currently this tag is only indicated for use in the <code><podcast:liveItem></code> tag. In the future, its use will be expanded.</p>
|
||||
<h3 id="parent-20">Parent</h3>
|
||||
<p> <code><podcast:liveItem></code></p>
|
||||
<h3 id="count-20">Count</h3>
|
||||
<p> Multiple</p>
|
||||
<h3 id="node-value-14">Node Value</h3>
|
||||
<p>The node value is a free form string meant to explain to the user where this content link points and/or the nature of it's purpose.</p>
|
||||
<h3 id="attributes-19">Attributes</h3>
|
||||
<ul>
|
||||
<li><strong>href</strong> (required) A string that is the uri pointing to content outside of the application.</li>
|
||||
</ul>
|
||||
<h3 id="examples-20">Examples</h3>
|
||||
<pre><code class="language-xml"><podcast:contentLink href="https://youtube.com/blahblah/livestream">Live on YouTube!</podcast:contentLink></code></pre>
|
||||
<pre><code class="language-xml"><podcast:contentLink href="https://twitter.com/statuses/somepost">Chat on Twitter!</podcast:contentLink></code></pre>
|
||||
|
||||
</article>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,19 @@
|
||||
{
|
||||
"top1name": "Buzzsprout",
|
||||
"top1count": 1870,
|
||||
"top2name": "RSS.com",
|
||||
"top2count": 967,
|
||||
"top3name": "Captivate",
|
||||
"top3count": 381,
|
||||
"top4name": "Transistor",
|
||||
"top4count": 376,
|
||||
"top5name": "Blubrry",
|
||||
"top5count": 96,
|
||||
"top6name": "Podserve",
|
||||
"top6count": 43,
|
||||
"top7name": "Fireside",
|
||||
"top7count": 38,
|
||||
"top8name": "Podiant",
|
||||
"top8count": 2,
|
||||
"totalCount": 3773
|
||||
}
|
||||
@@ -0,0 +1,8 @@
|
||||
{
|
||||
"feedCountTotal": "4,073,767",
|
||||
"feedCount3days": "110,972",
|
||||
"feedCount10days": "249,286",
|
||||
"feedCount30days": "384,458",
|
||||
"feedCount60days": "522,450",
|
||||
"feedCount90days": "618,924"
|
||||
}
|
||||
@@ -0,0 +1,238 @@
|
||||
const path = require('path')
|
||||
const fs = require('fs');
|
||||
const express = require('express')
|
||||
const app = express() // create express app
|
||||
const { makeThreadcap, InMemoryCache, updateThreadcap, makeRateLimitedFetcher } = require('threadcap');
|
||||
const fetch = require('node-fetch');
|
||||
const packageJson = require('../package.json');
|
||||
|
||||
// Gets the .env variables
|
||||
require('dotenv').config()
|
||||
|
||||
const USER_AGENT = `Podcastindex.org-web/${packageJson.version}`;
|
||||
|
||||
// Utilizing the node repo from comster/podcast-index-api :)
|
||||
// NOTE: This server will work as a reverse proxy.
|
||||
const api = require('podcast-index-api')(
|
||||
process.env.API_KEY,
|
||||
process.env.API_SECRET
|
||||
)
|
||||
|
||||
const apiAdd = require('podcast-index-api')(
|
||||
process.env.API_ADD_KEY,
|
||||
process.env.API_ADD_SECRET
|
||||
)
|
||||
|
||||
app.use((req, res, next) => {
|
||||
|
||||
const { rawHeaders, httpVersion, method, socket, url } = req;
|
||||
const { remoteAddress, remoteFamily } = socket;
|
||||
|
||||
// console.log(
|
||||
// JSON.stringify({
|
||||
// timestamp: Date.now(),
|
||||
// rawHeaders,
|
||||
// httpVersion,
|
||||
// method,
|
||||
// remoteAddress,
|
||||
// remoteFamily,
|
||||
// url
|
||||
// })
|
||||
// );
|
||||
|
||||
let userAgent = req.header('user-agent')
|
||||
let cfLocation = req.header('CF-IPCountry')
|
||||
let cfSourceIP = req.header('CF-Connecting-IP')
|
||||
let cfBotScore = req.header('Cf-Bot-Score')
|
||||
|
||||
var logString = "["+Date.now()+"] " + "["+remoteAddress+"] " + method +" ("+url+") - UA: ["+userAgent+"] - LOC: ["+cfLocation+"|"+cfSourceIP+"] - BOT: ["+cfBotScore+"]"
|
||||
|
||||
console.log(logString)
|
||||
|
||||
next();
|
||||
});
|
||||
|
||||
// ------------------------------------------------
|
||||
// ---------- Static files for namespace ----------
|
||||
// ------------------------------------------------
|
||||
|
||||
app.use('/namespace/1.0', async (req, res) => {
|
||||
fs.readFile('./server/data/namespace1.0.html', 'utf8', (err, data) => {
|
||||
// You should always specify the content type header,
|
||||
// when you don't use 'res.json' for sending JSON.
|
||||
res.set('Content-Type', 'text/html');
|
||||
res.send(data)
|
||||
})
|
||||
})
|
||||
|
||||
// ------------------------------------------------
|
||||
// ------------ Reverse proxy for API -------------
|
||||
// ------------------------------------------------
|
||||
|
||||
app.use('/api/search/byterm', async (req, res) => {
|
||||
let term = req.query.q
|
||||
const response = await api.searchByTerm(term)
|
||||
res.send(response)
|
||||
})
|
||||
|
||||
app.use('/api/search/bytitle', async (req, res) => {
|
||||
let term = req.query.q
|
||||
const response = await api.custom('search/bytitle', {q: term})
|
||||
res.send(response)
|
||||
})
|
||||
|
||||
app.use('/api/recent/episodes', async (req, res) => {
|
||||
let max = req.query.max
|
||||
const response = await api.recentEpisodes(max)
|
||||
res.send(response)
|
||||
})
|
||||
|
||||
app.use('/api/podcasts/bytag', async (req, res) => {
|
||||
let max = req.query.max
|
||||
let start_at = req.query.start_at
|
||||
const response = await api.custom('podcasts/bytag', {
|
||||
'podcast-value': '',
|
||||
'max': max,
|
||||
'start_at': start_at,
|
||||
})
|
||||
res.send(response)
|
||||
})
|
||||
|
||||
app.use('/api/podcasts/byfeedid', async (req, res) => {
|
||||
let feedId = req.query.id
|
||||
const response = await api.podcastsByFeedId(feedId)
|
||||
res.send(response)
|
||||
})
|
||||
|
||||
app.use('/api/podcasts/byfeedurl', async (req, res) => {
|
||||
let feedUrl = req.query.url
|
||||
const response = await api.podcastsByFeedUrl(feedUrl)
|
||||
res.send(response)
|
||||
})
|
||||
|
||||
|
||||
app.use('/api/episodes/byfeedid', async (req, res) => {
|
||||
let feedId = req.query.id
|
||||
let max = req.query.max
|
||||
const response = await api.episodesByFeedId(feedId, null, max)
|
||||
res.send(response)
|
||||
})
|
||||
|
||||
app.use('/api/add/byfeedurl', async (req, res) => {
|
||||
let feedUrl = req.query.url
|
||||
const response = await apiAdd.addByFeedUrl(feedUrl)
|
||||
res.send(response)
|
||||
})
|
||||
|
||||
// ------------------------------------------------
|
||||
// ------------ API to get comments for episode ---
|
||||
// ------------------------------------------------
|
||||
app.use('/api/comments/byepisodeid', async (req, res) => {
|
||||
let episodeId = req.query.id;
|
||||
const response = await api.episodesById(episodeId, false);
|
||||
|
||||
const socialInteract = response.episode.socialInteract && response.episode.socialInteract.filter((si) => si.protocol === 'activitypub');
|
||||
|
||||
if(!socialInteract && socialInteract.lenght >= 0) {
|
||||
// Bad requests sounds appropriate, as the client is only expected to call this API
|
||||
// when it validated upfront that the episode has a property socialInteract with activitypub protocol
|
||||
res.status(400).send('The episode does not contain a socialInteract property')
|
||||
}
|
||||
|
||||
const userAgent = USER_AGENT;
|
||||
const cache = new InMemoryCache();
|
||||
const fetcher = makeRateLimitedFetcher(fetch);
|
||||
|
||||
// Disable buffering in the nginx server so that the delivery of
|
||||
// chunks are not delayed
|
||||
res.setHeader('X-Accel-Buffering', 'no');
|
||||
|
||||
const sentCommenters = {};
|
||||
|
||||
const threadcap = await makeThreadcap(socialInteract[0].uri, { userAgent, cache, fetcher });
|
||||
|
||||
const callbacks = {
|
||||
onEvent: e => {
|
||||
if (e.kind === 'node-processed' && e.part === 'replies') {
|
||||
writeThreadcapChunk(e.nodeId, threadcap, sentCommenters, res);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
await updateThreadcap(threadcap, { updateTime: new Date().toISOString(), userAgent, cache, fetcher, callbacks });
|
||||
|
||||
res.end()
|
||||
})
|
||||
|
||||
function writeThreadcapChunk(processedNodeId, threadcap, sentCommenters, res) {
|
||||
const threadcapChunk = {};
|
||||
|
||||
threadcapChunk.roots = threadcap.roots.filter((root) => root === processedNodeId);
|
||||
threadcapChunk.nodes = {};
|
||||
threadcapChunk.nodes[processedNodeId] = threadcap.nodes[processedNodeId];
|
||||
|
||||
const comment = threadcapChunk.nodes[processedNodeId].comment;
|
||||
|
||||
// nodes are always new, but commenters can be repeated, we only include
|
||||
// them in th chunk if they have not been sent before, as there is no purpose
|
||||
// on sending them again.
|
||||
// this could be determines by inspecting previous nodes, but this way
|
||||
// is easier.
|
||||
if(comment && !sentCommenters[comment.attributedTo]) {
|
||||
sentCommenters[comment.attributedTo] = true;
|
||||
threadcapChunk.commenters = {};
|
||||
threadcapChunk.commenters[comment.attributedTo] = threadcap.commenters[comment.attributedTo];
|
||||
}
|
||||
|
||||
res.write(JSON.stringify(threadcapChunk) + '\n')
|
||||
}
|
||||
|
||||
// ------------------------------------------------
|
||||
// ---------- Static files for API data -----------
|
||||
// ------------------------------------------------
|
||||
|
||||
app.use('/api/stats', async (req, res) => {
|
||||
fs.readFile('./server/data/stats.json', 'utf8', (err, data) => {
|
||||
// You should always specify the content type header,
|
||||
// when you don't use 'res.json' for sending JSON.
|
||||
res.set('Content-Type', 'application/json');
|
||||
res.send(data)
|
||||
})
|
||||
})
|
||||
|
||||
app.use('/api/newfeedstats', async (req, res) => {
|
||||
fs.readFile('./server/data/newfeedstats.json', 'utf8', (err, data) => {
|
||||
// You should always specify the content type header,
|
||||
// when you don't use 'res.json' for sending JSON.
|
||||
res.set('Content-Type', 'application/json');
|
||||
res.send(data)
|
||||
})
|
||||
})
|
||||
|
||||
app.use('/api/apps', async (req, res) => {
|
||||
fs.readFile('./server/data/apps.json', 'utf8', (err, data) => {
|
||||
// You should always specify the content type header,
|
||||
// when you don't use 'res.json' for sending JSON.
|
||||
res.set('Content-Type', 'application/json');
|
||||
res.send(data)
|
||||
})
|
||||
})
|
||||
|
||||
app.use('/api/images', express.static('./server/assets'))
|
||||
|
||||
// ------------------------------------------------
|
||||
// ---------- Static content for client -----------
|
||||
// ------------------------------------------------
|
||||
|
||||
app.use(express.static('./server/www'))
|
||||
app.get('*', (req, res) => res.sendFile(path.resolve('server', 'www', 'index.html')))
|
||||
|
||||
// ------------------------------------------------
|
||||
|
||||
|
||||
const PORT = process.env.PORT || 333;
|
||||
|
||||
// start express server on port 5001 (default)
|
||||
app.listen(PORT, () => {
|
||||
console.log(`server started on port ${PORT}`)
|
||||
})
|
||||
@@ -1,39 +0,0 @@
|
||||
import * as React from 'react'
|
||||
import { Link } from 'react-router-dom'
|
||||
|
||||
import './styles.scss'
|
||||
|
||||
interface IProps {
|
||||
link?: boolean
|
||||
children?: any
|
||||
style?: string
|
||||
href?: string
|
||||
onClick?: () => void
|
||||
}
|
||||
|
||||
export default class Button extends React.PureComponent<IProps> {
|
||||
static defaultProps = {}
|
||||
|
||||
render() {
|
||||
const { children, href, onClick, link } = this.props
|
||||
return (
|
||||
<>
|
||||
{href && !link && (
|
||||
<a href={href} className="button">
|
||||
{children}
|
||||
</a>
|
||||
)}
|
||||
{href && link && (
|
||||
<Link className="button" to={href}>
|
||||
{children}
|
||||
</Link>
|
||||
)}
|
||||
{!href && (
|
||||
<div className="button" onClick={onClick}>
|
||||
{children}
|
||||
</div>
|
||||
)}
|
||||
</>
|
||||
)
|
||||
}
|
||||
}
|
||||
@@ -1,20 +0,0 @@
|
||||
.button {
|
||||
border-radius: 17px;
|
||||
transition: var(--transition-secs);
|
||||
font-family: var(--font-family-exp);
|
||||
font-size: 16px;
|
||||
color: #2d2d2d;
|
||||
padding: 8px 20px;
|
||||
text-align: center;
|
||||
&:hover {
|
||||
transition: var(--transition-secs);
|
||||
background: #f2f2f2;
|
||||
cursor: pointer;
|
||||
}
|
||||
}
|
||||
|
||||
a,
|
||||
.button {
|
||||
text-decoration: none !important;
|
||||
text-decoration-color: none !important;
|
||||
}
|
||||
@@ -1,164 +0,0 @@
|
||||
.player-card {
|
||||
background: #ffffff;
|
||||
width: 500px;
|
||||
height: 640px;
|
||||
border: 1px solid #d6d6d6;
|
||||
box-shadow: 0 0 9px 0 rgba(192, 192, 192, 0.5);
|
||||
border-radius: 12px;
|
||||
transition: var(--transition-secs);
|
||||
// &:hover {
|
||||
// transition: var(--transition-secs);
|
||||
// box-shadow: 0 0 9px 0 rgba(192, 192, 192, 0.8);
|
||||
// }
|
||||
}
|
||||
|
||||
.player {
|
||||
flex: 1;
|
||||
display: inline-flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
height: inherit;
|
||||
width: inherit;
|
||||
}
|
||||
|
||||
.player-nav-arrows {
|
||||
position: absolute;
|
||||
z-index: 0;
|
||||
width: inherit;
|
||||
height: 470px;
|
||||
button {
|
||||
outline: 0;
|
||||
border: 0;
|
||||
background: none;
|
||||
border-radius: 4px;
|
||||
&:hover {
|
||||
background: rgba(#d6d6d6, 0.4);
|
||||
}
|
||||
}
|
||||
.player-nav-arrows-left {
|
||||
top: 245px;
|
||||
position: absolute;
|
||||
left: 5px;
|
||||
cursor: pointer;
|
||||
img {
|
||||
margin-top: 3px;
|
||||
}
|
||||
}
|
||||
|
||||
.player-nav-arrows-right {
|
||||
top: 245px;
|
||||
position: absolute;
|
||||
right: 5px;
|
||||
cursor: pointer;
|
||||
img {
|
||||
margin-top: 3px;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
.player-carousel {
|
||||
display: inline-flex;
|
||||
flex-direction: row;
|
||||
justify-content: space-between;
|
||||
align-items: center;
|
||||
margin-top: 7px;
|
||||
margin-bottom: 5px;
|
||||
button {
|
||||
outline: 0;
|
||||
border: 0;
|
||||
}
|
||||
.player-carousel-item {
|
||||
margin: 0 5px;
|
||||
height: 5px;
|
||||
width: 15px;
|
||||
background: #d6d6d6;
|
||||
border-radius: 4px;
|
||||
cursor: pointer;
|
||||
&:hover {
|
||||
background: darken(#d6d6d6, 20);
|
||||
}
|
||||
&:active {
|
||||
background: darken(#d6d6d6, 40);
|
||||
}
|
||||
&.selected {
|
||||
background: darken(#d6d6d6, 40);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
.player-cover-art {
|
||||
display: inline-flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
padding: 25px 25px 0 25px;
|
||||
img {
|
||||
border-radius: 10px;
|
||||
border: 1px solid lighten(#d6d6d6, 0.2);
|
||||
}
|
||||
}
|
||||
|
||||
.player-info {
|
||||
display: inline-flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
.player-bottom {
|
||||
display: inline-flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
width: inherit;
|
||||
margin-top: 5px;
|
||||
padding: 0 10px;
|
||||
// width: calc100%;
|
||||
}
|
||||
|
||||
.player-media-controls {
|
||||
width: calc(100% - 20px);
|
||||
.player-show-title {
|
||||
font-size: 20px;
|
||||
font-family: var(--font-family);
|
||||
text-align: center;
|
||||
width: 450px;
|
||||
white-space: nowrap;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
}
|
||||
.player-feed-button {
|
||||
cursor: pointer;
|
||||
}
|
||||
p {
|
||||
margin: 0;
|
||||
margin-top: 5px;
|
||||
font-family: var(--font-family-exp);
|
||||
font-size: 14px;
|
||||
line-height: 14px;
|
||||
color: #868686;
|
||||
}
|
||||
.rhap_container {
|
||||
outline: none;
|
||||
box-shadow: none;
|
||||
button {
|
||||
outline: none;
|
||||
}
|
||||
.rhap_volume-bar-area {
|
||||
outline: none;
|
||||
}
|
||||
.rhap_progress-container {
|
||||
outline: none;
|
||||
}
|
||||
.rhap_progress-indicator {
|
||||
width: 15px;
|
||||
height: 15px;
|
||||
top: -5px;
|
||||
background: var(--color-primary);
|
||||
}
|
||||
.rhap_play-pause-button {
|
||||
svg path {
|
||||
fill: var(--color-primary);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -1,88 +0,0 @@
|
||||
.result {
|
||||
background: #ffffff;
|
||||
border: 1px solid #d6d6d6;
|
||||
border-radius: 6px;
|
||||
margin: 10px 20px;
|
||||
height: auto;
|
||||
padding: 5px;
|
||||
}
|
||||
|
||||
.result-row {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: flex-start;
|
||||
flex-direction: row;
|
||||
height: 170px;
|
||||
align-items: center;
|
||||
}
|
||||
|
||||
.result-cover-art {
|
||||
display: inline-flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
padding: 15px 15px 15px 15px;
|
||||
img {
|
||||
border-radius: 10px;
|
||||
border: 1px solid lighten(#d6d6d6, 0.2);
|
||||
}
|
||||
}
|
||||
|
||||
.result-info {
|
||||
margin-left: 10px;
|
||||
p {
|
||||
margin: 10px 0;
|
||||
}
|
||||
margin-right: 15px;
|
||||
}
|
||||
|
||||
.result-title {
|
||||
font-family: var(--font-family-exp);
|
||||
font-weight: bold;
|
||||
width: 100%;
|
||||
font-size: 26px;
|
||||
color: #2d2d2d;
|
||||
text-align: left;
|
||||
}
|
||||
|
||||
.result-categories {
|
||||
display: inline-flex;
|
||||
flex-direction: row;
|
||||
margin: -3px -3px; /* grid trick, has to match box margin */
|
||||
flex-wrap: wrap;
|
||||
justify-content: flex-start;
|
||||
align-items: flex-start;
|
||||
&::-webkit-scrollbar {
|
||||
visibility: hidden;
|
||||
}
|
||||
}
|
||||
.result-category {
|
||||
background: #f3f3f3;
|
||||
border: 1px solid #cecece;
|
||||
border-radius: 5px;
|
||||
margin: 3px;
|
||||
|
||||
padding: 4px 12px;
|
||||
}
|
||||
.no-category {
|
||||
opacity: 0.6;
|
||||
}
|
||||
.result-description {
|
||||
font-family: var(--font-family);
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
font-size: 18px;
|
||||
margin: 0 !important;
|
||||
padding: 10px;
|
||||
}
|
||||
|
||||
@media only screen and (max-width: 767px) {
|
||||
/* phones */
|
||||
.result {
|
||||
height: fit-content;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: flex-start;
|
||||
padding: 10px 10px;
|
||||
}
|
||||
}
|
||||
@@ -1,76 +0,0 @@
|
||||
import * as React from 'react'
|
||||
import { Link } from 'react-router-dom'
|
||||
import { history } from '../../state/store'
|
||||
|
||||
import Button from '../Button'
|
||||
import Searchbar from '../SearchBar'
|
||||
import Icon from '../../../images/icon.svg'
|
||||
import { cleanSearchQuery } from '../../utils'
|
||||
|
||||
import './styles.scss'
|
||||
|
||||
// Separate state props + dispatch props to their own interfaces.
|
||||
interface IProps {
|
||||
history?: any
|
||||
}
|
||||
|
||||
export default class Topbar extends React.PureComponent<IProps> {
|
||||
static defaultProps = {}
|
||||
state = {
|
||||
search: '',
|
||||
}
|
||||
|
||||
constructor(props: IProps) {
|
||||
super(props)
|
||||
|
||||
this.state = {
|
||||
search: cleanSearchQuery(props.history.location.search),
|
||||
}
|
||||
|
||||
this.onSearchChange = this.onSearchChange.bind(this)
|
||||
this.onSearchSubmit = this.onSearchSubmit.bind(this)
|
||||
}
|
||||
|
||||
onSearchChange(evt: React.ChangeEvent<HTMLInputElement>) {
|
||||
evt.preventDefault()
|
||||
this.setState({ search: evt.target.value })
|
||||
}
|
||||
|
||||
onSearchSubmit(evt: React.ChangeEvent<HTMLFormElement>) {
|
||||
if (!this.state.search) {
|
||||
history.push(`/search`)
|
||||
} else {
|
||||
history.push(`/search?q=${this.state.search}`)
|
||||
}
|
||||
evt.preventDefault()
|
||||
}
|
||||
|
||||
render() {
|
||||
const { history } = this.props
|
||||
const { search } = this.state
|
||||
return (
|
||||
<div className="topbar">
|
||||
<Link className="topbar-brand" to="/">
|
||||
<img height={30} width={28} src={Icon} alt="Sidebar logo" />
|
||||
<div className="topbar-title">Podcast Index</div>{' '}
|
||||
</Link>
|
||||
|
||||
<div className="topbar-span">
|
||||
<Searchbar
|
||||
search={search}
|
||||
onSearchChange={this.onSearchChange}
|
||||
onSearchSubmit={this.onSearchSubmit}
|
||||
/>
|
||||
|
||||
<Button link href="/stats">
|
||||
Stats
|
||||
</Button>
|
||||
<Button href="https://podcastindex.org/blog">Blog</Button>
|
||||
</div>
|
||||
<div className="topbar-right">
|
||||
<Button href="https://api.podcastindex.org">Login</Button>
|
||||
</div>
|
||||
</div>
|
||||
)
|
||||
}
|
||||
}
|
||||