X-Git-Url: https://njoseph.me/gitweb/nimcoon.git/blobdiff_plain/a000c39cc591c6bacc37ae5f4dcfc87e55e6cd5f..28a19d6598c3bf7e3c905e6f3d1f5d4559d76283:/README.md diff --git a/README.md b/README.md index 837ace4..6c2625c 100644 --- a/README.md +++ b/README.md @@ -3,38 +3,53 @@ 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 +- [ ] Download videos - [ ] Configuration options - [ ] Choice of video players - [ ] Show video URLs or not - [ ] Play audio only - [ ] Pagination of search results -## Usage +## Installation -### As a script +Download the latest build from GitlabCI (amd64 GNU/Linux only). -You must have nim installed locally for this to work. +```sh +wget https://gitlab.com/njoseph/cli-tube/-/jobs/artifacts/master/download?job=compile -O artifacts.zip +unzip artifacts.zip +``` + + +For other platforms, create a release artifact using the following command: ```sh -nim c -d:ssl -r cli_tube.nim emacs +nim c -d:ssl -d:release clitube.nim +``` + +Copy the binary to a directory on your PATH such as `/usr/local/bin` + +## Usage + +```sh +clitube emacs # If your search query has multiple words, use quotes -nim c -d:ssl -r cli_tube.nim 'nim lang' +clitube 'nim lang' ``` -### Using the binary +## Development -Please use the binary in the repository for now. -Will setup GitLab CI to publish proper binaries later. +One-liner for compiling and running ```sh -./cli_tube emacs - -./cli_tube 'nim lang' +nim c -d:ssl -r clitube.nim 'nim lang' ```