X-Git-Url: https://njoseph.me/gitweb/nimcoon.git/blobdiff_plain/68fd8100bc36465b29ae76b9f41d9eb7fa052e7a..4827df7ac6cc2b6cbc55894f95509c2c6a26c095:/README.md diff --git a/README.md b/README.md index ef2efcf..d0fdffa 100644 --- a/README.md +++ b/README.md @@ -3,48 +3,62 @@ Play videos from YouTube (and maybe other sources in the future) from the command line using your preferred desktop media player. -This application is implemented in [Nim language](https://nim-lang.org). +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) ## Features - [x] Search for videos using keywords -- [ ] Download or watch videos +- [x] Stream videos +- [x] Stream music +- [ ] Download videos - [ ] Configuration options - [ ] Choice of video players - [ ] Show video URLs or not - [ ] Play audio only - [ ] Pagination of search results -## Usage +## Installation -Download the latest build from GitlabCI +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 unzip artifacts.zip ``` -Run the binary -```sh -./clitube emacs +For other platforms, create a release artifact using the following command: -./clitube 'nim lang' +```sh +nim c -d:ssl -d:release clitube.nim ``` -## Development +Copy the binary to a directory on your PATH such as `/usr/local/bin` -### Compiling and Running +## Usage ```sh -nim c -d:ssl -r clitube.nim emacs +clitube emacs # If your search query has multiple words, use quotes -nim c -d:ssl -r clitube.nim 'nim lang' +clitube 'nim lang' ``` -### Creating a release artifact +### Commandline arguments + +|----------------|---------------------------| +| ***Arguments** | **Explanation** | +|----------------|---------------------------| +| -m, --music | Play Music only, no video | +|----------------|---------------------------| + +## Development + +One-liner for compiling and running ```sh -nim c -d:ssl -d:release clitube.nim +nim c -d:ssl -r clitube.nim 'nim lang' ```