X-Git-Url: https://njoseph.me/gitweb/nimcoon.git/blobdiff_plain/3f6de5cb78a90bc516ff0eb63a0ea6beaa1e09d7..763f653ff1183586ffad978b917f8deaa2d057c7:/README.md diff --git a/README.md b/README.md index 6c2625c..3020333 100644 --- a/README.md +++ b/README.md @@ -1,55 +1,88 @@ -# CLI Tube +# NimCoon -Play videos from YouTube (and maybe other sources in the future) from the +Play videos from YouTube and PeerTube from the command line using your preferred desktop media player. This application is implemented in [Nim language](https://nim-lang.org) using only the standard library. -![clitube screenshot with search term 'baby yoda'](screenshot.png) +![nimcoon screenshot with search term 'baby yoda'](screenshot.png) ## Features - [x] Search for videos using keywords -- [x] Stream videos -- [ ] Download videos +- [x] Stream videos and music from YouTube +- [x] Play direct links from YouTube and PeerTube +- [x] Stream video and music from magnet links +- [x] Download music +- [x] Download video - [ ] Configuration options - - [ ] Choice of video players - - [ ] Show video URLs or not - - [ ] Play audio only -- [ ] Pagination of search results ## Installation +Nim Coon depends on the following: +- youtube-dl +- mpv (recommended) or vlc +- peerflix (for magnet links) + Download the latest build from GitlabCI (amd64 GNU/Linux only). ```sh -wget https://gitlab.com/njoseph/cli-tube/-/jobs/artifacts/master/download?job=compile -O artifacts.zip +wget https://gitlab.com/njoseph/nimcoon/-/jobs/artifacts/master/download?job=compile -O artifacts.zip unzip artifacts.zip ``` -For other platforms, create a release artifact using the following command: +For other platforms, you can install from source by running the following command: ```sh -nim c -d:ssl -d:release clitube.nim +nimble install ``` -Copy the binary to a directory on your PATH such as `/usr/local/bin` - ## Usage ```sh -clitube emacs +nimcoon "emacs" # If your search query has multiple words, use quotes -clitube 'nim lang' +nimcoon "nim lang" + +# Play audio of the first search result +nimcoon -m -l "counting stars" + +# Download audio of the first search result +nimcoon -mld "counting stars" + +# Play direct video link +nimcoon https://www.youtube.com/watch?v=QOEMv0S8AcA + +# Add -d to download or -m to select only audio or both +nimcoon -md https://www.youtube.com/watch?v=hT_nvWreIhg ``` +After the search results are displayed, you can enter a number to play one +result, "all" to play all the results or "q" to quit the program. + +If a number is entered, after the selected search result is played, the results +are redisplayed, so that you can play the other results without having to search +again. + +### Command line arguments + +| **Arguments** | **Explanation** | +|-------------------|--------------------------------------------| +| -m, --music | Play Music only, no video | +| -l, --lucky | Try your luck with the first search result | +| -f, --full-screen | Play video in full screen | +| -d, --download | Download video or music | + +Feel free to use these options in any combination. NimCoon will show a helpful +error message if you pick incompatible options. + ## Development One-liner for compiling and running ```sh -nim c -d:ssl -r clitube.nim 'nim lang' +nim c -d:ssl -r src/nimcoon.nim 'nim lang' ```