docs/raw-videos.md

   1 # Raw Videos / Audio #
   2
   3 Want to host your own video/audio files for use on CyTube?  For servers with the
   4 ffprobe module enabled, CyTube supports this!  However, in order to provide a
   5 consistent experience, there are limitations.
   6
   7 ## Hosting the File ##
   8
   9 CyTube requires a direct link to the file in order to query it for metadata such
  10 as duration and encoding.  The website where you host the file needs to be able
  11 to serve the video directly (rather than embedding it in a flash
  12 player/iframe/etc.).  It also needs to serve the correct MIME type for the video
  13 in the `Content-Type` HTTP header, e.g. `video/mp4`.
  14
  15 I don't recommend hosting videos on Dropbox-type services, as they aren't built
  16 to distribute video to many users at a time and often have strict bandwidth
  17 limits.  File hosting sites such as Putlocker also cause problems due to being
  18 unable to serve the file directly, or due to binding the link to the IP address
  19 of the user who retrieved it.  For best results when using raw video, host the
  20 video yourself on a VPS or dedicated server with plenty of bandwidth.
  21
  22 Note that CyTube only queries the file for metadata, it does not proxy it for
  23 users!  Every user watching the video will be downloading it individually.
  24
  25 ## Encoding the Video ##
  26
  27 Current internet browsers are very limited in what codecs they can play
  28 natively.  Accordingly, CyTube only supports a few codecs:
  29
  30 **Video**
  31
  32   * MP4 (H.264)
  33   * WebM (VP8)
  34   * WebM (VP9)
  35   * Ogg/Theora
  36
  37 **Audio**
  38
  39   * MP3
  40   * Ogg/Vorbis
  41
  42 If your video is in some other format (such as MKV or AVI), then it will need to
  43 be re-encoded.  There are plenty of free programs available to re-encode video
  44 files, such as [ffmpeg](http://ffmpeg.org/) and
  45 [handbrake](http://handbrake.fr/).
  46
  47 For best results, encode as an MP4 using H.264.  This is natively supported by
  48 many browsers, and can also be played using a fallback flash player for older
  49 browsers that don't support it natively.  Always encode with the
  50 [faststart](https://trac.ffmpeg.org/wiki/Encode/H.264#faststartforwebvideo)
  51 flag.
  52
  53 ### Subtitles ###
  54
  55 Unfortunately, soft-subtitles are not supported right now.  This is something
  56 that may be supported in the future, but currently if you need subtitles, they
  57 will have to be hardsubbed onto the video itself.