Updated docs
This commit is contained in:
parent
3d66d22d91
commit
d148283d8c
1 changed files with 24 additions and 19 deletions
43
README.md
43
README.md
|
@ -1,11 +1,17 @@
|
|||
# tube [![GoDoc](https://godoc.org/github.com/wybiral/tube?status.svg)](https://godoc.org/github.com/wybiral/tube)
|
||||
# tube
|
||||
|
||||
This is a Golang project to build a self hosted "tube"-style video player for watching your own video collection over HTTP or hosting your own channel for others to watch.
|
||||
`tube` is a Youtube-like (_without censorship and features you don't need!_)
|
||||
Video Sharing App written in Go which also supports automatic transcoding to
|
||||
MP4 H.265 AAC and multiple collections and RSS feed.
|
||||
|
||||
## Features
|
||||
|
||||
Some of the key features include:
|
||||
- Easy to add videos (just move a file into the folder)
|
||||
- Easy to upload videos (just use the builtin uploader and automatic transcoder!)
|
||||
- Builtin ffmpeg-based Transcoder that automatically converts your uploaded content to MP4 H.264 / AAC
|
||||
- Builtin automatic thumbnail generator
|
||||
- No database (video info pulled from file metadata)
|
||||
- No JavaScript (the player UI is entirely HTML)
|
||||
- No JavaScript (the player UI is entirely HTML, except for the uploader which degrades!))
|
||||
- Easy to customize CSS and HTML template
|
||||
- Automatically generates RSS feed (at `/feed.xml`)
|
||||
- Clean, simple, familiar UI
|
||||
|
@ -14,26 +20,25 @@ Currently only supports MP4 video files so you may need to re-encode your media
|
|||
|
||||
Since all of the video info comes from metadata it's also useful to have a metadata editor such as [EasyTAG](https://github.com/GNOME/easytag) (which supports attaching images as thumbnails too).
|
||||
|
||||
By default the server is configured to run on 127.0.0.1:0 which will assign a random port every time you run it. This is to avoid conflicting with other applications and to ensure privacy. You can configure this to be any specific host:port by editing `config.json` before running the server. You can also change the RSS feed details and library path from `config.json`.
|
||||
## Getting Started
|
||||
|
||||
# installation
|
||||
### From Source
|
||||
|
||||
## from release
|
||||
```#!sh
|
||||
$ git clone https://github.com/proogic/tube
|
||||
$ cd tube
|
||||
$ make
|
||||
$ ./tube
|
||||
```
|
||||
|
||||
1. Download [release](https://github.com/wybiral/tube/releases) for your platform
|
||||
2. Extract zip archive
|
||||
3. Run `tube` executable to start server (this will output the URL for accessing from a browser)
|
||||
4. Move videos to `videos` directory
|
||||
5. Open the URL from step 3 and enjoy!
|
||||
Open http://127.0.0.1:8000/ in your Browser!
|
||||
|
||||
## from source
|
||||
### Using Docker
|
||||
|
||||
1. [Install Golang](https://golang.org/doc/install) if you don't already have it
|
||||
2. `go get github.com/wybiral/tube`
|
||||
3. `cd $GOPATH/src/github.com/wybiral/tube`
|
||||
4. `go run main.go` (this will output the URL for accessing from a browser)
|
||||
5. Move videos to `$GOPATH/src/github.com/wybiral/tube/videos`
|
||||
6. Open the URL from step 4 and enjoy!
|
||||
```#!sh
|
||||
$ docker pull prologic/tube
|
||||
$ docker run -p 8000:8000 -v /path/to/data:/data
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
|
|
Loading…
Reference in a new issue