Update README.md

This commit is contained in:
ByteDream 2021-07-19 02:27:32 +02:00
parent 627ac8a4d1
commit d6694be927

View File

@ -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.