This is an old revision of the document!
Bunny Stream is an excellent service for storing your video files and letting people from all over the world to view your video.
As you may know by now, Geminars do NOT host any videos at all. Instead, authors of the videos can upload them to any website which either stores the actual video files and/or converts the uploaded file to other formats. Then you can use the link provided by that service to create your Geminar!
Bunny Stream is quite inexpensive. It uses pay-as-you-consume payment model, so you are sure that your money is going to be utilized properly. Moreover; it does an excellent job of transcoding your videos into the HLS format. We have provided a simple uploader that you can use in order to upload to your own account at Bunny Stream.
There are two ways by which you can upload your video to Bunny Stream. Let me describe the simplest method here:
We have given a HTML page which you can use to upload to your own account at Bunny Stream. It's a simple form where you need to give 3 values: The Video Library ID, The CDN Hostname and the API Key. Just use this link to upload.
All the three values can be found in the “API” section of the Video library you create at your account at Bunny.
But what is a “Video Library”?
Think of it like a folder for all videos collected together under one classification. For e.g. You can create a library for all your lectures. Another one for your fun stuff and so on. Each Video Library will have its own Video Library ID, The CDN Hostname and the API Key.
Here is the full explanation on how to use that form:
But there is another way to upload to Bunny too! That uses a a command-line program to upload to Bunny Stream. Read this page here to understand how to use that program.
IMPORTANT
After the video is uploaded (using either of the above two methods), Bunny will process it and that can take even a few minutes – depends on the size of the video file you had uploaded.
If you are on a slow Internet connection and/or if your video is quite large; it is possible that you may not be able to upload the video in one sitting. Not to worry: Just give the same command as before, and our uploadBunny.exe program will intelligently resume from where it had last left off.
Normally, the both the upload processes we explained earlier would show the HLS link (.m3u8) at the end of the upload. You can directly copy that link and use that. If you did not get to see that…no worries. Read below on how to obtain it from your dashboard at Bunny:
Once Bunny Stream tells you that the video has been completely processed, then click on that video at your Bunny Stream account. On the right hand side you will see a box to copy the HLS link of that file. Click that copy button and come back to your Geminars account and create a fresh Geminar using that Link.
It is quite simple!
The HLS would NOT become live till Bunny Stream processes it further after you upload it. Depending on the size of the uploaded video, it can take more than a few minutes – sometimes, even half an hour or so – to do the final processing on their website.
So if you create a Geminar using the HLS link, do not expect the video to be shown immediately after the uploader did its work on your computer.
Not to worry. The same zip file actually has the BUN source code for uploadBunny.exe You can install BUN (A Javascript interpreter) in your computer (Say Mac or Linux) and ask BUN to run that uploadBunny.ts script But before that you need to install a couple of additional modules into the installed BUN environment by giving this command:
bun add tus-js-client yaml