|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | - | - |
| cast_core/api/ | | 23-Nov-2023 | - | 1,134 | 927 |
| common/ | | 23-Nov-2023 | - | 7,932 | 5,530 |
| protocol/ | | 23-Nov-2023 | - | 928 | 823 |
| receiver/ | | 23-Nov-2023 | - | 2,370 | 1,823 |
| sender/ | | 23-Nov-2023 | - | 3,400 | 2,532 |
| standalone_receiver/ | | 23-Nov-2023 | - | 2,471 | 1,720 |
| standalone_sender/ | | 23-Nov-2023 | - | 3,234 | 2,148 |
| streaming/ | | 23-Nov-2023 | - | 21,560 | 14,536 |
| test/ | | 23-Nov-2023 | - | 843 | 691 |
| third_party/ | | 23-Nov-2023 | - | 14 | 9 |
| .gitignore | D | 23-Nov-2023 | 30 | 3 | 2 |
| DEPS | D | 23-Nov-2023 | 279 | 18 | 14 |
| README.md | D | 23-Nov-2023 | 2.3 KiB | 51 | 39 |
README.md
1# libcast
2
3libcast is an open source implementation of the Cast protocol supporting Cast
4applications and streaming to Cast-compatible devices.
5
6## Using the standalone implementations
7
8To run the standalone sender and receivers together, first you need to install
9the following dependencies: FFMPEG, LibVPX, LibOpus, LibSDL2, as well as their
10headers (frequently in a separate -dev package). From here, you just need a
11video to use with the cast_sender, as the cast_receiver can generate a
12self-signed certificate and private key for each session. You can also generate
13your own RSA private key and either create or have the receiver automatically
14create a self signed certificate with that key. If the receiver generates a root
15certificate, it will print out the location of that certificate to stdout.
16
17Note that we assume that the private key is a PEM-encoded RSA private key,
18and the certificate is X509 PEM-encoded. The certificate must also have
19the CA bit set in the basic constraints. The easiest way to test with a key
20and certificate is to use ones generated by the cast_receiver standalone
21application.
22
23## Developer certificate generation and use
24
25The easiest way to generate a private key and certificate is to just run
26the cast_receiver with `-g`, and both should be written out to files:
27
28```
29 $ /path/to/out/Default/cast_receiver -g
30 [INFO:../../cast/receiver/channel/static_credentials.cc(161):T0] Generated new private key for session: ./generated_root_cast_receiver.key
31 [INFO:../../cast/receiver/channel/static_credentials.cc(169):T0] Generated new root certificate for session: ./generated_root_cast_receiver.crt
32```
33
34These generated credentials can be passed in to start a session, e.g.
35```
36./out/Default/cast_receiver -d generated_root_cast_receiver.crt -p generated_root_cast_receiver.key lo0 -x
37```
38
39And then passed to the cast sender to connect and start a streaming session:
40```
41 $ ./out/Default/cast_sender -d generated_root_cast_receiver.crt ~/video-1080-mp4.mp4
42```
43
44When running on Mac OS X, also pass the `-x` flag to the cast receiver to
45disable DNS-SD/mDNS, since Open Screen does not currently integrate with
46Bonjour.
47
48When connecting to a receiver that's not running on the loopback interface
49(typically `lo` or `lo0`), pass the `-r <receiver IP endpoint>` flag to the
50`cast_sender` binary.
51