From d6694be92702ba05356ba34630cbb9f3ed8fea35 Mon Sep 17 00:00:00 2001 From: ByteDream Date: Mon, 19 Jul 2021 02:27:32 +0200 Subject: [PATCH] Update README.md --- README.md | 85 ++++++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 75 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 91bf3f1..03723a0 100644 --- a/README.md +++ b/README.md @@ -2,38 +2,103 @@ A very simple tool to get the video url and some other stuff from a [vivo.sx](https://vivo.sx) video. The alternative domain [vivo.st](https://vivo.st) is also supported. +This package can be used as a **[CLI](#cli-usage)** and as **[library](#library-usage)**. -Only tested on linux, but should work on Mac and Windows too. +Only tested on Linux, but should work on Mac and Windows too. -## Install +## Installation -```bash -go get github.com/bytedream/vivo +### Binary + +Get the [latest binaries](https://github.com/ByteDream/vivo/releases/latest) if you just want the command line version. +- [Linux (amd64)](https://github.com/ByteDream/vivo/releases/download/v1.0/vivo-1.0_linux) +- [Windows (amd64)](https://github.com/ByteDream/vivo/releases/download/v1.0/vivo-1.0_windows) +- [Mac (amd64)](https://github.com/ByteDream/vivo/releases/download/v1.0/vivo-1.0_darwin) + +Or install and run it directly from source +``` +$ git clone https://github.com/bytedream/vivo +$ cd vivo +$ go run ./cmd/vivo ``` -## Usage +##### For help how to use the cli, see [here](#cli-usage) -Get infos about a video: +### Library + +If you want to install this package as library, use +``` +$ go get github.com/bytedream/vivo +``` + +##### For a example how to use the libary, see [here](#library-usage). + +## CLI usage + +For general help, use the `-h` flag when executing the binary. +The cli has multi video support, so you can safely specify multiple urls when executing it. + +#### Download a video +Multiple video download is supported, so you can safely specify more than one url / video to download. +``` +$ vivo https://vivo.sx/1234567890 +``` + +#### Get only infos about a video without downloading it +The `-i` flag shows only information about the video +``` +$ vivo -i https://vivo.sx/1234567890 +``` + +#### Specify output +With the `-o` flag, a custom output path / file can be specified. By default the file will be downloaded in the current path. +``` +$ vivo -o OwO.mp4 https://vivo.sx/1234567890 +``` + +#### Use a proxy +If you want to hide your real location or something other which requires a proxy, you can use the `-q` flag to specify it. +``` +$ vivo -p https://0.0.0.0:0000 +``` + +##### Other useful options / flags: +- `-c` - **clean** + + *Disable colors and the separator between multiple video downloads.* +- `-s` - **source** + + *Shows only the source video url.* +- `-q` - **quiet** + + *Disable the complete output.* + + +## Library usage + +Get infos about a video ```go package main import ( "fmt" + "github.com/bytedream/vivo" ) func main() { - vivoVideo, err := vivo.GetVideo("https://vivo.sx/1234567890") - // this extract all the infos about the video + // this extract all the infos about the video + vivoVideo, err := vivo.GetVideo("https://vivo.sx/cf2137f496") if err != nil { panic(err) } - fmt.Println(vivoVideo.VideoURL) // url of the video + // url of the video + fmt.Println(vivoVideo.VideoURL) } ``` ## License -This project is licensed under the Mozilla Public Licence 2.0 (MPL-2.0) licence - see the [LICENSE](LICENCE) file for more details +This project is licensed under the Mozilla Public License 2.0 (MPL-2.0) - see the [LICENSE](LICENCE) file for more details.