You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+8-8
Original file line number
Diff line number
Diff line change
@@ -3,7 +3,7 @@
3
3
4
4
## Overview
5
5
This package uses the **[FFmpeg](https://ffmpeg.org)** to package media content for online streaming such as DASH and HLS. You can also use **[DRM](https://en.wikipedia.org/wiki/Digital_rights_management)** for HLS packaging. There are several options to open a file from a cloud and save files to clouds as well.
6
-
-**[Full Documentation](https://https://www.hadronepoch.org/op/python/ffmpeg-streaming/)** is available describing all features and components.
6
+
-**[Full Documentation](https://www.hadronepoch.org/op/python/ffmpeg-streaming/)** is available describing all features and components.
7
7
-**Your support is crucial to our ongoing work on open-source projects**. We kindly request that you consider exploring the **[available options](#support-us)** to assist us in this endeavor. Your encouragement and assistance will help us continue to deliver high-quality results in this important area. Thank you for your consideration and support.
video = ffmpeg_streaming.input(s3, bucket_name="bucket-name", key="video.mp4")
73
73
```
74
-
Visit **[this page](https://https://www.hadronepoch.org/op/python/ffmpeg-streaming/start/clouds?r=open)** to see some examples of opening a file from **[Amazon S3](https://aws.amazon.com/s3)**, **[Google Cloud Storage](https://console.cloud.google.com/storage)**, **[Microsoft Azure Storage](https://azure.microsoft.com/en-us/features/storage-explorer/)**, and a custom cloud.
74
+
Visit **[this page](https://www.hadronepoch.org/op/python/ffmpeg-streaming/start/clouds?r=open)** to see some examples of opening a file from **[Amazon S3](https://aws.amazon.com/s3)**, **[Google Cloud Storage](https://console.cloud.google.com/storage)**, **[Microsoft Azure Storage](https://azure.microsoft.com/en-us/features/storage-explorer/)**, and a custom cloud.
75
75
76
76
#### 3. Capture Webcam or Screen (Live Streaming)
77
77
You can pass the name of a supported, connected capture device(i.e. the name of a webcam, camera, screen and etc) to the `input` method to stream a live media over the network from your connected device.
See **[DASH section](https://https://www.hadronepoch.org/op/python/ffmpeg-streaming/start?r=dash#dash)** in the documentation, for more examples.
113
+
See **[DASH section](https://www.hadronepoch.org/op/python/ffmpeg-streaming/start?r=dash#dash)** in the documentation, for more examples.
114
114
### HLS
115
115
**[HTTP Live Streaming (also known as HLS)](https://developer.apple.com/streaming/)** is an HTTP-based adaptive bitrate streaming communications protocol implemented by Apple Inc. as part of its QuickTime, Safari, OS X, and iOS software. Client implementations are also available in Microsoft Edge, Firefox, and some versions of Google Chrome. Support is widespread in streaming media servers. [Learn more](https://en.wikipedia.org/wiki/HTTP_Live_Streaming)
See **[HLS section](https://https://www.hadronepoch.org/op/python/ffmpeg-streaming/start?r=hls#hls)** in the documentation, for more examples such as Fragmented MP4, live from camera/screen and so on.
137
+
See **[HLS section](https://www.hadronepoch.org/op/python/ffmpeg-streaming/start?r=hls#hls)** in the documentation, for more examples such as Fragmented MP4, live from camera/screen and so on.
138
138
139
139
#### Encryption(DRM)
140
140
The encryption process requires some kind of secret (key) together with an encryption algorithm. HLS uses AES in cipher block chaining (CBC) mode. This means each block is encrypted using the ciphertext of the preceding block. [Learn more](https://en.wikipedia.org/wiki/Block_cipher_mode_of_operation)
An integer as a "key rotation period" can also be passed to the `encryption` method (i.e. `encryption(save_to, url, 10)`) to use a different key for each set of segments, rotating to a new key after this many segments. For example, if 10 segment files have been generated then it will generate a new key. If you set this value to **`1`**, each segment file will be encrypted with a new encryption key. This can improve security and allows for more flexibility.
165
165
166
-
See **[the example](https://https://www.hadronepoch.org/op/python/ffmpeg-streaming/start?r=enc-hls#hls-encryption)** for more information.
166
+
See **[the example](https://www.hadronepoch.org/op/python/ffmpeg-streaming/start?r=enc-hls#hls-encryption)** for more information.
167
167
168
168
**IMPORTANT:** It is very important to protect your key(s) on your website. For example, you can use a token(using a Get/Post HTTP method or add a token to authorization header) to check if the user is eligible to access the key or not. You can also use a session(or cookie) on your website to restrict access to the key(s)(**It is highly recommended**).
169
169
@@ -273,7 +273,7 @@ A path can also be passed to save a copy of files to your local machine.
Visit **[this page](https://https://www.hadronepoch.org/op/python/ffmpeg-streaming/start/clouds?r=save)** to see some examples of saving files to **[Amazon S3](https://aws.amazon.com/s3)**, **[Google Cloud Storage](https://console.cloud.google.com/storage)**, **[Microsoft Azure Storage](https://azure.microsoft.com/en-us/features/storage-explorer/)**, and a custom cloud.
276
+
Visit **[this page](https://www.hadronepoch.org/op/python/ffmpeg-streaming/start/clouds?r=save)** to see some examples of saving files to **[Amazon S3](https://aws.amazon.com/s3)**, **[Google Cloud Storage](https://console.cloud.google.com/storage)**, **[Microsoft Azure Storage](https://azure.microsoft.com/en-us/features/storage-explorer/)**, and a custom cloud.
277
277
278
278
**NOTE:** This option is only valid for **[VOD](https://en.wikipedia.org/wiki/Video_on_demand)** (it does not support live streaming).
279
279
@@ -303,7 +303,7 @@ from ffmpeg_streaming import FFProbe
303
303
ffprobe = FFProbe('/var/media/video.mp4')
304
304
```
305
305
306
-
See **[the example](https://https://www.hadronepoch.org/op/python/ffmpeg-streaming/start?r=metadata#metadata)** for more information.
306
+
See **[the example](https://www.hadronepoch.org/op/python/ffmpeg-streaming/start?r=metadata#metadata)** for more information.
307
307
308
308
### Conversion
309
309
You can convert your stream to a file or to another stream protocol. You should pass a manifest of the stream to the `input` method:
@@ -384,7 +384,7 @@ If you save your stream content to a cloud(i.e. **[Amazon S3](https://aws.amazon
384
384
**Does [IOS](https://www.apple.com/ios) support the DASH stream?**
385
385
No, IOS does not have native support for DASH. Although there are some libraries such as **[Viblast](https://github.com/Viblast/ios-player-sdk)** and **[MPEGDASH-iOS-Player](https://github.com/MPEGDASHPlayer/MPEGDASH-iOS-Player)** to support this technique, I have never tested them. So maybe some of them will not work properly.
386
386
387
-
See [this page](https://https://www.hadronepoch.org/op/python/ffmpeg-streaming/start?r=faq#faq) for more FAQs.
387
+
See [this page](https://www.hadronepoch.org/op/python/ffmpeg-streaming/start?r=faq#faq) for more FAQs.
388
388
389
389
## Support Us
390
390
We greatly appreciate your support in our efforts to contribute to open-source projects. If you're able to, we kindly ask that you take a moment to check out the available options for assisting us. Your help would enable us to maintain our commitment to producing exceptional results. Thank you for your support.
0 commit comments