X-Git-Url: https://njoseph.me/gitweb/nimcoon.git/blobdiff_plain/726cf1a72986f856629f70a59990e15589ff2780..6cd451ca8feb3c050587dc80b2f11699c0fbc532:/README.md diff --git a/README.md b/README.md index de431e3..ef2efcf 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,50 @@ # CLI Tube -Play videos from YouTube from the command line. -This application is currently implemented in Nim language. +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). + +## Features + +- [x] Search for videos using keywords +- [ ] Download or watch videos +- [ ] Configuration options + - [ ] Choice of video players + - [ ] Show video URLs or not + - [ ] Play audio only +- [ ] Pagination of search results + +## Usage + +Download the latest build from GitlabCI + +```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 + +./clitube 'nim lang' +``` + +## Development + +### Compiling and Running + +```sh +nim c -d:ssl -r clitube.nim emacs + +# If your search query has multiple words, use quotes +nim c -d:ssl -r clitube.nim 'nim lang' +``` + +### Creating a release artifact + +```sh +nim c -d:ssl -d:release clitube.nim +```