diff --git a/README.md b/README.md index 0e5f7e0..66ded3c 100644 --- a/README.md +++ b/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