tube/README.md

81 lines
3 KiB
Markdown
Raw Normal View History

2020-03-24 15:35:00 +03:00
# tube
2019-06-30 01:33:28 +03:00
2020-03-23 09:57:34 +03:00
`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
2020-03-23 15:44:42 +03:00
MP4 H.265 AAC, multiple collections and RSS feed.
2020-03-23 09:57:34 +03:00
## Features
2019-06-30 01:33:28 +03:00
- Easy to add videos (just move a file into the folder)
2020-03-23 09:57:34 +03:00
- 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
2019-06-30 01:33:28 +03:00
- No database (video info pulled from file metadata)
2020-03-23 09:57:34 +03:00
- No JavaScript (the player UI is entirely HTML, except for the uploader which degrades!))
2019-06-30 01:33:28 +03:00
- Easy to customize CSS and HTML template
2019-07-04 05:30:20 +03:00
- Automatically generates RSS feed (at `/feed.xml`)
2019-06-30 01:33:28 +03:00
- Clean, simple, familiar UI
Currently only supports MP4 video files so you may need to re-encode your media to MP4 using something like [ffmpeg](https://ffmpeg.org/).
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).
2020-03-25 02:35:29 +03:00
### Screenshots
2020-03-25 02:51:56 +03:00
![screenshot-1](screenshot-1.png?raw=true "Main Screen and Video Player")
![screenshot-2](screenshot-2.png?raw=true "Video Upload Screen")
2020-03-25 02:35:29 +03:00
2020-03-23 09:57:34 +03:00
## Getting Started
2019-06-30 01:33:28 +03:00
2020-03-23 09:57:34 +03:00
### From Source
2019-06-30 01:33:28 +03:00
2020-03-23 09:57:34 +03:00
```#!sh
$ git clone https://github.com/proogic/tube
$ cd tube
$ make
$ ./tube
```
2019-08-08 15:14:26 +03:00
2020-03-23 09:57:34 +03:00
Open http://127.0.0.1:8000/ in your Browser!
2019-08-08 15:14:26 +03:00
2020-03-23 09:57:34 +03:00
### Using Docker
2019-06-30 01:33:28 +03:00
2020-03-23 09:57:34 +03:00
```#!sh
$ docker pull prologic/tube
$ docker run -p 8000:8000 -v /path/to/data:/data
```
2020-03-23 09:51:03 +03:00
## Stargazers over time
[![Stargazers over time](https://starcharts.herokuapp.com/prologic/tube.svg)](https://starcharts.herokuapp.com/prologic/tube)
## Support
Support the ongoing development of Tube!
**Sponser**
- Become a [Sponsor](https://www.patreon.com/prologic)
## 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](/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](https://github.com/prologic/tube/graphs/contributors) statistics.
[![](https://sourcerer.io/fame/prologic/prologic/tube/images/0)](https://sourcerer.io/fame/prologic/prologic/tube/links/0)
[![](https://sourcerer.io/fame/prologic/prologic/tube/images/1)](https://sourcerer.io/fame/prologic/prologic/tube/links/1)
[![](https://sourcerer.io/fame/prologic/prologic/tube/images/2)](https://sourcerer.io/fame/prologic/prologic/tube/links/2)
[![](https://sourcerer.io/fame/prologic/prologic/tube/images/3)](https://sourcerer.io/fame/prologic/prologic/tube/links/3)
2020-03-23 09:51:03 +03:00
## License
tube source code is available under the MIT [License](/LICENSE).
Previously based off of [tube](https://github.com/wybiral/tube) by [davy wybiral
](https://github.com/wybiral). (See [LICENSE.old](/LICENSE.old))