florian/srs-s3-upload
2
1
Fork 0
Code Issues 2 Pull Requests Packages Projects Releases Wiki Activity

docs: Updated README

Browse Source
This commit is contained in:
florian 2023-07-08 09:34:31 +02:00
parent a285860281
commit 3626e5f933
3 changed files with 6 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
README.md
View File

@ -3,6 +3,11 @@
This project allows upload of HLS based streaming data from the SRS (Simple Realtime Server, https://ossrs.io/) to an S3 based storage. The purpose is to publish a stream in HLS format to a cloud based data store to leverage CDN distribution.
Why would you use this over other solutions?
* For a single streamer you can operate within the free tier of Cloudflare.
* You can leverage a CDN and can potentially reach many viewers (not tested much)
* If you run the docker (srs + upload tool) on your local machine, there is no external compute resources needed.
This project implements a NodeJs based webserver that provides a web hook that can be registered with SRS's `on_hls` webhook. Whenever a new video segment is created, this web hook is called and the implementation in this project uploads the `.ts` video segment as well as the `.m3u8` playlist information
to the storage bucket.

2
docs/setup.drawio
View File

@ -1 +1 @@
<mxfile host="Electron" modified="2023-07-07T22:07:16.173Z" agent="5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/20.3.0 Chrome/104.0.5112.114 Electron/20.1.3 Safari/537.36" etag="0c1s4yGP-lnRvC8uBEkT" version="20.3.0" type="device"><diagram id="AyLf_R-D394qqAjLlRm3" name="Seite-1">5VnbbuM2EP0aA20BG7rbfvQlaR+y3WCNYJOnBS1RMhtKdClqbefrO5Qo60I5djd2LrsI4JAjDkWemTMzpHr2LN7+ydF69YkFmPYsI9j27HnPskbuCH6lYFcIPMcrBBEnQSEyK8GCPGElNJQ0IwFOGwMFY1SQdVPosyTBvmjIEOds0xwWMtp86xpFWBMsfER16VcSiJXaljWs5H9hEq3KN5veuHgSo3Kw2km6QgHb1ET2Vc+eccZE0Yq3M0wldiUuhd71gaf7hXGciFMU7j5vJt+i+7V5+4h2sXgaBpNJ31Tm+Y5opnasVit2JQScZUmA5SxGz55uVkTgxRr58ukGbA6ylYgp9ExohiwRM0YZz3XtkSH/QK5eg7nA24MbMPewgDthFmPBdzBEKXgKSOVJI9Xd1MxSDlnVTOIMlRApV4j2M1doQUMB9n/AMzTwZpRlwTWFPT0Do3kcRgkUAS+cUBIlIBNsfR4QHaOJoj3UYdzL6jCa7qVg9DQU58x/xBxkM/AmRBLZ9igsZLqUrUjkWBQS6XA5/0uf8/7NWDGg9L6aqND9zWcZxAHL4FkCvyzJLcUxikkSQft2JqVyAXgrME8QpbvfyxfCHot3luv4EHY2rRPtvI9X56eLZudFjrm0bgtDiJVr2cxiOvGFNOweqRu0xPSWpUQQJhFbMiFYfBDKGtYsExR8abbPFGeKS2Yb6o7IZHcg7V0KaD2mcxEDGBM5rXUd5Ozqr1gqdFqxDqo1tCkDjAvdltFwAJlTdRkXKxYxYM5VJZ02M0k15oZJW+VG+gcLsVNlAMoEa5oQLMJ390o/7zzIzsAtu/Nt/eF817CyXODzNob9sIz7+BlwVX4UiEdYPDPOftZn+sbAchte4yhv4JgiQb43F9rlImruW0byAFgOYWGYYqH50H4JP+5W1gH+VjGz7Tifp4uXhceQUFqrJgIXjwIH5BCs2SOu1xnW0va8M/HZbfF5rPN5H05fhdBDDfkNXjL22EHf5NuKpm9BzTNSzD6RYs4xipmONW6Y0nr3JLN1kn05L4nCMLR8v4tEgbf03DORyLHfG4nGGrJ3a8qQLANZqDMptjPIo8Y1Acy1hyiRan8MRKqGpIcL1EoyxxQLLN+XF59hofeWWbRKnA+NvHnxLOqcSHH3GMVd07UajtZ//4nU0Twx5Wk/tfuZcsizsh17B9g+HC+Ncx3NrffGdlfD+IvsTzOoffXS9SUIYxPKkmEXwmNvaKMzxdM2wo7pvjHCpl4PfvC6wywvGH8wKp0ccV6Gu36Ons3/hhyD5CltmizTdWf2KS44BvEuYDEiycCHU/PH40G7rujkgfuqPNBLtqsk6N+lP9u9hmO+8b1Gaepf7s7BPLVcMg9Y9JUik17YTOUXmK7rWzyIBjD0Ca0HRWA6aywKEB6FnVWP54/wMrzMRcE7yMn6XfoCwow8ZhgsoXLtaAnxAv7D1oyYJFlxIAmlEgkw61ny7huo/2kqschv4Q8YqAxmPuLBcQshFb4oDvNsVNDNkkxJQYkk0U3+ZO681ZF11P400hHvxh3WNC93Y65f/OgRMAkm8jsn9BKWyIgXoHS1503NAs1IeOhD3T7cmc1wZx2Ld3hLxH2t/VBrVyqyIzWGZe8WcwJoYX6BsOm9rJ6r2b2ronBfeNAs3a5d2Y9a7lTsU2lVHqVNNBw2J3LHrYkKHLSJjh9roVt9py6GVx/77av/AA==</diagram></mxfile>
<mxfile host="Electron" modified="2023-07-08T07:31:42.299Z" agent="5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/20.3.0 Chrome/104.0.5112.114 Electron/20.1.3 Safari/537.36" etag="CEUqfDq7yaUl9i5JQDai" version="20.3.0" type="device"><diagram id="AyLf_R-D394qqAjLlRm3" name="Seite-1">3Vldb+I4FP01SLsrgfINPPLRzj50dqpBs9s+jUziBG+dXNZxCvTXr504JMGh0Gk6paNK1L6xHfvce46vnZ49i7efGFqvPkOAac8ygm3Pnvcsa+SOxK807AqD53iFIWIkKExmZViQJ6yMhrJmJMBpoyEHoJysm0YfkgT7vGFDjMGm2SwE2nzrGkVYMyx8RHXrPyTgK7Usa1jZ/8QkWpVvNr1x8SRGZWO1knSFAtjUTPZVz54xAF6U4u0MU4ldiUvR7/rI0/3EGE74OR2+fdlMvkd3a/P2Ae1i/jQMJpO+qdzziGimVqxmy3clBAyyJMByFKNnTzcrwvFijXz5dCN8LmwrHlNRM0UxhITPgALL+9ojQ/4Juz5btYBHzDje1kxq9p8wxJiznWiinnoKSBVJI1Xd1NxSNlnVXOIMlRGpUIj2I1doiYIC7CXgGRp4MwpZcE3FMp+B0TwNo0SFiCicUBIlwsZh3Q2IjtFE0R7qMO5tdRhN961g9DQU5+A/YCZsMxFNiCSy7FExkelSliKeY1FYZMDl/C9jzvsvg6JBGX01U9H3Nx8yoQOWwbJE/EKSe4phFJMkEuXbmbTKCeAtxyxBlO5+L18o1li8s5zHh/CzaZ3p571edU8Xzc+LHHPp3QMMhVauZTGL6cTn0rF7pG7QEtNbSAknIBFbAucQH4WyhjVknIpYmu13io50yTyEukWZ7BakvbcCWtd0xmMBxkQOa10HObv6K0i5TitooVqjNwWBcdH3wGk4EDunqgLjK4hAMOeqsk6bO0nV5gakr3In/Ys536k0AGUcmi4UTmK7O9U/r9zLysAtq/Nt/eF8d8rLKWTMx89gqbZDjliE+TPt7KKdxOCcmOkbA8ttRI2jooFhijh5bKYfbSGixr4Fkgtg2QTCMMVci6H9FH48rKwj/K008zBwvkwXr5PHkFBayyYCF48CR9iFWMMDrucZ1tL2vI747B7weazzeS+nP4XQQw35DV4CPLTQN/m+oul7UPPHKWafSTHnxRQzHWvccKV18SSzdZJ97ZZEYRhavt9GosBbem5HJHLsSyPRWEP225oCkmkghDqTYjsT+6hxTQTm2kOUyG5/DHiqmqTHE9TKMscUcyzflyefYdHvPXfRauO8b+ybXe+izpkUd19Mcdd0rUag9S9/I3W0SExZ2k/tfqYCslO2Y+8I24fjpdHV0dy6NLa7GsZfZX2aidxXT11fgzA2RVoybEN47A1t1JGeHiLsmO47I2zq+eDHyjvM8j6xK1U6W3Feh7t+jp7N/xJ7DJKntGmyTNetu09xwTGIdwHEiCQDX5yaPx4PDvOKVh64P5UHesr2N8GbX+1WwzHf+VajdPSvfuNgnpsslUJwKbqkpzVT+f2l7fIWD6KBaPqE1oNCljpVogDhUdia83j+CC/Dt7kmuIAdWb9JXwiZkYcMAxIq546WQi/Ef7E0IyZJVhxHQtmJBBh6lrz5FtT/PJXw5HfwRxxUipmPWHDaQ0jJF8VhvhcVdLMkU1LRiSTRTf5k7rzXgXV0+GGkRe/GLd403+6+XL/20RUwCSbyK6eoJZBIxQtQutrzpuaBphIe+0y3lzuzKXfWKb3DW8LvauX7WrnqIiuyx7Cs3WJGBFqYvV42vY6zuZrf2/IJ95XHzDLsDvP60UE4FQtXvaqI0gYaDpsDueODgQpgtIFOH2pFtfpKXTSvPvXbV/8D</diagram></mxfile>

BIN
docs/setup.drawio.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 97 KiB

After

Width:  |  Height:  |  Size: 97 KiB