X-Git-Url: https://njoseph.me/gitweb/nimcoon.git/blobdiff_plain/763f653ff1183586ffad978b917f8deaa2d057c7..893b4f6cdfb995fc98d5edda42c847a4832a9ac0:/README.md diff --git a/README.md b/README.md index 3020333..18453ab 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,8 @@ Play videos from YouTube and PeerTube from the command line using your preferred desktop media player. +NewPipe app offers similar features for Android. + This application is implemented in [Nim language](https://nim-lang.org) using only the standard library. @@ -13,32 +15,70 @@ only the standard library. - [x] Search for videos using keywords - [x] Stream videos and music from YouTube - [x] Play direct links from YouTube and PeerTube -- [x] Stream video and music from magnet links +- [x] Stream video and music from magnet links and hyperlinks to torrent files - [x] Download music - [x] Download video +- [x] Play YouTube playlists (MPV only) +- [ ] Download YouTube playlists +- [x] Stream video from torrent file URLs +- [x] BitTorrent is preferred for PeerTube video links +- [ ] Search PeerTube (3.0 or later) +- [ ] YouTube Autoplay - [ ] Configuration options +| | YouTube | PeerTube (HTTP) | PeerTube (BitTorrent) | Direct Magnet Link | +| -------- | -------- | -------- | -------- | -------- | +| Music Streaming | ✅ | ✅ | ✅ | ✅ | +| Video Streaming | ✅ | ✅ | ✅ | ✅ | +| Music Download | ✅ | ✅ | | | +| Video Download | ✅ | ✅ | | | + ## Installation Nim Coon depends on the following: - youtube-dl - mpv (recommended) or vlc -- peerflix (for magnet links) +- peerflix and webtorrent (for magnet links) -Download the latest build from GitlabCI (amd64 GNU/Linux only). +Install MPV or VLC using your distribution's package manager. + +Install YouTube-dl +``` sh +pip3 install --user youtube-dl +``` +Install PeerFlix and WebTorrent ```sh -wget https://gitlab.com/njoseph/nimcoon/-/jobs/artifacts/master/download?job=compile -O artifacts.zip -unzip artifacts.zip +npm install --global peerflix webtorrent-cli ``` +(Optional) If you want your YouTube downloads to be faster, install `aria2` download manager. + +### Installing using Nimble -For other platforms, you can install from source by running the following command: +NimCoon can be installed from Nimble repositories: + +``` sh +nimble install nimcoon +``` + +You can also install from source by running the following command: ```sh nimble install ``` +### Installing binary + +Download the latest build from GitlabCI (amd64 GNU/Linux only). + +```sh +wget https://gitlab.com/njoseph/nimcoon/-/jobs/artifacts/master/download?job=compile -O artifacts.zip +unzip artifacts.zip +``` + +Copy the binary to somewhere on your path like /usr/local/bin + ## Usage ```sh @@ -86,3 +126,22 @@ One-liner for compiling and running ```sh nim c -d:ssl -r src/nimcoon.nim 'nim lang' ``` + +## Privacy + +To avoid storing your nimcoon searches in `zsh` history, run this command + +```sh +setopt histignorespace +``` + +Then, add a space before typing nimcoon in the shell, like " nimcoon" + +```sh + nimcoon "this is private" +``` + +The same can be achieved in `bash` by setting an environment variable +```sh +export HISTCONTROL=ignoreboth +```