No description
Find a file
James Mills 6eef473551
Fix CI
2022-11-08 08:20:23 +10:00
.chglog Add support for multi-arch binary and docker image releases (#20) 2022-08-01 03:22:17 +00:00
.dockerfiles Add support for multi-arch binary and docker image releases (#20) 2022-08-01 03:22:17 +00:00
.sandstorm Remove external FontAwesome dependency (#30) 2022-10-01 05:21:40 +00:00
app Add Sandstorm packaging files (#26) 2022-09-24 05:29:27 +00:00
importers Fix CI 2022-11-08 08:20:23 +10:00
media Add support for multi-arch binary and docker image releases (#20) 2022-08-01 03:22:17 +00:00
static Add Sandstorm packaging files (#26) 2022-09-24 05:29:27 +00:00
templates Remove external FontAwesome dependency (#30) 2022-10-01 05:21:40 +00:00
tools Add support for multi-arch binary and docker image releases (#20) 2022-08-01 03:22:17 +00:00
uploads Refactor video uploading in preparation for async transcoding 2020-03-21 22:58:14 +10:00
utils Add support for unlimited timeouts for transcoding and thumbnail generation 2020-03-29 21:11:32 +10:00
videos import code 2019-06-26 14:02:31 -05:00
.dockerignore Symlink .dockerignore to .gitignore 2020-03-29 10:19:58 +10:00
.drone.yml Add Drone CI 2022-11-08 08:06:55 +10:00
.gitignore Add Sandstorm packaging files (#26) 2022-09-24 05:29:27 +00:00
.goreleaser.yml Remove deprecated netgo build tag (Fixes #4) 2022-08-01 14:28:03 +10:00
.yamllint.yml Migrate to Go111Modules, Add Dockerfile and GoRelaser support 2020-03-21 08:20:16 +10:00
_config.yml Set theme jekyll-theme-architect 2020-03-23 11:16:49 +10:00
AUTHORS Add Sandstorm packaging files (#26) 2022-09-24 05:29:27 +00:00
CHANGELOG.md Update CHANGELOG for v1.1.13 2022-08-01 13:25:18 +10:00
config.json Supply the seconds position where a thumbnail is generated (#22) 2022-08-25 23:15:27 +00:00
docker-compose.yml Added docker-compose reference stack using Traefik as LB 2020-03-23 16:58:37 +10:00
Dockerfile Add support for multi-arch binary and docker image releases (#20) 2022-08-01 03:22:17 +00:00
Dockerfile.goreleaser Add support for multi-arch binary and docker image releases (#20) 2022-08-01 03:22:17 +00:00
go.mod Replace rice box with go embed (#25) 2022-08-30 01:17:08 +00:00
go.sum Replace rice box with go embed (#25) 2022-08-30 01:17:08 +00:00
LICENSE Re-licensed 2020-03-23 16:58:37 +10:00
LICENSE.old Re-licensed 2020-03-23 16:58:37 +10:00
main.go Add support for multi-arch binary and docker image releases (#20) 2022-08-01 03:22:17 +00:00
Makefile Remove deprecated netgo build tag (Fixes #4) 2022-08-01 14:28:03 +10:00
preflight.sh Add support for multi-arch binary and docker image releases (#20) 2022-08-01 03:22:17 +00:00
README.md Add Drone CI 2022-11-08 08:06:55 +10:00
screenshot-1.png Add Sandstorm packaging files (#26) 2022-09-24 05:29:27 +00:00
screenshot-2.png Add Sandstorm packaging files (#26) 2022-09-24 05:29:27 +00:00
version.go Migrate to Go111Modules, Add Dockerfile and GoRelaser support 2020-03-21 08:20:16 +10:00

tube

Build Status

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, multiple collections and RSS feed.

Features

  • 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, except for the uploader which degrades!))
  • Easy to customize CSS and HTML template
  • Automatically generates RSS feed (at /feed.xml)
  • Clean, simple, familiar UI

Screenshots

screenshot-1 screenshot-2

Getting Started

Prebuilt Release Binaries

  1. Go grab the latest binary from the Releases page for your platform / operating system.
  2. Extract the archive.
  3. Run ./tube

Open http://127.0.0.1:8000/ in your Browser!

Published Docker Images

$ docker pull prologic/tube
$ docker run -p 8000:8000 -v /path/to/data:/data

Open http://DOCKER_MACHINE_IP:8000/ in your Browser!

Where DOCKER_MACHINE_IP is the IP Address of your Docker Node.

Building From Source

$ git clone https://git.mills.io/prologic/tube
$ cd tube
$ make build
$ ./tube

Open http://127.0.0.1:8000/ in your Browser!

A Production Deployment

A Production Deployment can be found at https://tube.mills.io/ -- This is run and managed via a Docker Swarm cluster with a Docker-Compose / Stack very similiar to the one you can find in the repo: docker-compose.yml

Beyond this a "Production Deployment" is out-of-scope at this time for the documentation being provided here. Please don't hesitate to file an Issue however for ask for help or advice or contact the author directly!

Configuration

tube can be configured to suit your particular needs and comes by default with a sensbile set of defaults. There is also a default configuration at the top-level config.json that you can use as a start point and modify to suite your needs.

To Run tube with a provided configuration just pass the -c /path/to/config option; for example:

$ tube -c config.json

Everything in the configuration is optional as the builtin defaults are used if you do not supply anything, omit some sections or values or the configuration is invalid. Refer to the default config.json for the builtin defaults (this files matches the builtin defaults).

Here are some documentation on key configuration items:

Library Options and Upload / Video Paths(s)

{
    "library": [
        {
            "path": "videos",
            "prefix": ""
        }
    ],
}

Set path to the value of the path where you want to store videos and where tube will look for new videos.

Server Options / Upload Path and Max Upload Size

{
    "server": {
        "host": "0.0.0.0",
        "port": 8000,
        "store_path": "tube.db",
        "upload_path": "uploads",
        "max_upload_size": 104857600
    }
}
  • Set host to the interface you wish to bind to. If you want to only bind your local machine (ie: localhost) set this to 127.0.0.1.
  • Set port to any port you wish to bind the listening socket of the server to. It doesn't matter what it is as long as there it doesn't collide with a port already in use on your system.
  • Set store_path to a directory where tube will store statistics on videos viewed.
  • Set upload_path to a directory that you wish to use as a temporary working space for tube to store uploaded videos and process them. This can be a tmpfs file system for example for faster I/O.
  • Set max_upload_size to the maximum number of bytes you wish to impose on uploaded and imported videos. Upload(s)/Import(s) that exceed this size will by denied by the server. This is a saftey measure so as to not DoS the Tube server instance. Set it to a sensible value you see fit.

Thumbnailer / Transcoder Timeouts

{
    "thumbnailer": {
        "timeout": 60
    },
    "transcoder": {
        "timeout": 300,
        "sizes": null
    }
}
  • Set timeout to the no. of seconds to permit for thumbnail generation and video transcoding. This value has to be large enough for thumbnail generation and transcoding to take place depending on the max_upload_size permitted. These values also depend on the underlying performance of the machine Tube runs on. Use sensible values for your max_upload_size + system performance. This is a safety measure to ensure background processed do not run away and/or hog system resources. The thumbnailer and transcoder processes will be killed if their execution time exceeds these values.

  • Set sizes to an map of size => suffix that you wish to support for transcoding videos to lower quality on Upload/Import. This is especially useful for serving up videos to users that have poor bandwidth or where data charges are high for them. The following is a valid map:

{
    "transcoder": {
        "sizes": {
          "hd720": "720p",
          "hd480": "480p",
          "nhd":   "360p",
          "film":  "240p"
        }
    }
}

Optionally Require Password for Uploading

You might be hosting a page where the public can view video, but you don't want others to be able to upload and add content.

By specifying a password as an environment variable when running tube you can require this password to be provided when you access /upload. The username will always be uploader.

$ auth_password=upload123 tube -c config.json

Feed (RSS) Configuration

{
    "feed": {
        "external_url": "",
        "title": "Feed Title",
        "link": "http://your-url.example/about",
        "description": "Feed Description",
        "author": {
            "name": "Author Name",
            "email": "author@somewhere.example"
        },
        "copyright": "Copyright Text"
    }
}
  • Fill these values out as you see fit. If you are familiar with RSS these should be straight forward :)

Content Proprietary Notices Configuration

{ "copyright": { "content": "All Content herein Public Domain and User Contributed." } }

Contributors

Thank you to all those that have contributed to this project, battle-tested it, used it in their own projects or products, fixed bugs, improved performance and even fix tiny typos in documentation! Thank you and keep contributing!

You can find an AUTHORS file where we keep a list of contributors to the project. If you contriibute a PR please consider adding your name there. There is also Github's own Contributors statistics.

License

tube source code is available under the MIT License.

Previously based off of tube by davy wybiral . (See LICENSE.old)

App icon is licensed under the Apache license from Google Noto Emoji.