https://github.com/dasskelett/sapl
Stream and play music from YouTube!
https://github.com/dasskelett/sapl
audio-streaming bash gnu-linux shell vlc youtube youtube-dl
Last synced: 2 months ago
JSON representation
Stream and play music from YouTube!
- Host: GitHub
- URL: https://github.com/dasskelett/sapl
- Owner: DasSkelett
- License: other
- Created: 2019-02-28T11:14:31.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-08-05T12:38:58.000Z (almost 7 years ago)
- Last Synced: 2025-04-09T07:15:13.319Z (about 1 year ago)
- Topics: audio-streaming, bash, gnu-linux, shell, vlc, youtube, youtube-dl
- Language: Shell
- Size: 9.77 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
## What is sapl?
Sapl stands for "Stream and Play List".
It started as "sap" (for "Stream and Play"), as the function to create a playlist was added, the command was renamed to `sapl`.
## What are the prerequisites?
You need the [VLC Media Player by VideoLAN](http://www.videolan.org/vlc/) installed, especially the `cvlc` command is used here. Try `cvlc --version` to see if it is available on your system. You need [youtube-dl](http://ytdl-org.github.io/youtube-dl/) installed. Make sure you are running the latest version (`youtube-dl -u`), it's really important!
## How does it work?
1) `sapl add ""`
**sapl** passes this command to **youtube-dl** which searches YouTube with this term.
Then it adds *the* top result to the playlist.
2) `sapl` or `sapl start`
Start playing the playlist, via **vlc media player**.
3) `sapl stop`
Stop after the end of the currently playing song.
4) `sapl remove`
Removes the last item of the playlist`
5) `sapl list`
List the scheduled songs.
6) `sapl help`
Get additional help and usage informations.
Run any of those commands in your console.
## How to install?
Just download the `sapl` file and put it in a folder included in your `PATH` and make it executable.
E.g.
```
mkdir ~/bin/
cd ~/bin/
curl -O "https://raw.githubusercontent.com/DasSkelett/sapl/master/sapl"
chmod +x "./sapl"
```