Streamlib
Streamlib is a meta-player for media streams. The streamlib CLI works against a curated library of video and audio streams, and enables querying and playback through a standard media player, defaulting to mpv which is the recommended player.
The most important feature Streamlib provides is the ability to generate timestamped authentication tokens on streams that require some basic level of authentication to them. See the Queries section for more details.
Usage
Streamlib is still moving fast and has yet to been officially packaged, but the basic functionality works!
Running it requires checking out the git repository and then calling:
$ cargo run -- groove
The single argument will run a case-insensitive match against all known metadata and pick the first matching stream. Upcoming versions will include a console-based interactive interface.
Entire library can be dumped with the -L flag:
$ cargo run -- -L
Or filtered to show a specific query:
$ cargo run -- -L somafm
An alternate player can be set with the -p/--player flag:
$ cargo run -- -p vlc groove
But note that some features critical for playing streams (such as customizing HTTP headers) are unavailable and will cause some streams to fail.
Use the -l/--library flag to point streamlib to a local library directory for testing new additions:
$ cargo run -- --library /path/to/local/library groove
Testing
$ cargo test
Library
To add new content and test it you'll need to clone both repositories:
$ git clone https://github.com/streamlib/streamlib
$ git clone https://github.com/streamlib/library
# add any files you want to the library
$ cd streamlib
$ cargo run -- --library ../library groove
See https://github.com/streamlib/library for more details.
602 Jan 2, 2023
0 Mar 11, 2022
21 Mar 22, 2023
7 Feb 23, 2022
3.9k Jan 5, 2023
50 Apr 26, 2023
12 Nov 5, 2022
10 Nov 4, 2023
18 Nov 30, 2022
9 Dec 7, 2022
4.8k Jan 5, 2023
2 Sep 8, 2022
639 Jan 4, 2023
4 Dec 31, 2022
4 Feb 19, 2024
25 Apr 16, 2023
46 May 6, 2023
5 Aug 20, 2022
310 Dec 23, 2022
782 Dec 30, 2022