.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" ======================================================================== .\" .IX Title "GET_FLASH_VIDEOS 1p" .TH GET_FLASH_VIDEOS 1p "2018-07-27" "perl v5.26.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" get_flash_videos \- Video downloader for various Flash\-based video hosting sites .SH "SYNOPSIS" .IX Header "SYNOPSIS" get_flash_videos [\s-1OPTION\s0]... \s-1URL...\s0 .PP get_flash_videos [\s-1OPTION\s0]... \s-1SEARCH\s0 .SH "DESCRIPTION" .IX Header "DESCRIPTION" Download the Flash video from the web pages given in \f(CW\*(C`URL\*(C'\fR, choosing suitable filenames for each. .PP Alternatively if \f(CW\*(C`SEARCH\*(C'\fR is specified (either quoted or unquoted), \&\fBget_flash_videos\fR will search Google Video for \f(CW\*(C`SEARCH\*(C'\fR, and present a list of videos to download. .PP \&\fBget-flash-videos\fR attempts to support many video sites, therefore there is no list of supported sites in this manual page as it frequently changes, see the website for a list. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fI\-d\fR, \fI\-\-debug\fR" 4 .IX Item "-d, --debug" Print extra debugging information. .IP "\fI\-f\fR, \fI\-\-filename\fR" 4 .IX Item "-f, --filename" Save downloaded file to the specified filename. Usually this shouldn't be necessary, as \f(CW\*(C`get_flash_videos\*(C'\fR tries to use a meaningful name for the video. .IP "\fI\-r\fR, \fI\-\-quality\fR" 4 .IX Item "-r, --quality" The quality of the video to attempt to download. Some sites offer videos in multiple qualities; this will let you specify which quality to prefer. \&\f(CW\*(C`get_flash_videos\*(C'\fR will aim to download a video at the specified quality or lower, if no video is available at that quality it will download the next highest quality video available. .Sp You can specify a quality as either: .RS 4 .IP "\(bu" 4 high .IP "\(bu" 4 medium .IP "\(bu" 4 low .RE .RS 4 .Sp or a target resolution: .IP "\(bu" 4 1080p (1920x1080) .IP "\(bu" 4 720p (1280x720) .IP "\(bu" 4 576p (720x576) .IP "\(bu" 4 480w (854x480) .IP "\(bu" 4 480p (640x480) .IP "\(bu" 4 240w (427x240) .IP "\(bu" 4 240p (320x240) .RE .RS 4 .Sp High corresponds to 1080p or 720p, medium to 576p, 480w and 480p and low to 240w and 240p. .Sp The default is \fBhigh\fR. .RE .IP "\fI\-p\fR, \fI\-\-play\fR" 4 .IX Item "-p, --play" Begin playing the video once enough of the file has been downloaded. .ie n .IP "\fI\-\-player=\f(CI""CMD""\fI\fR" 4 .el .IP "\fI\-\-player=\f(CICMD\fI\fR" 4 .IX Item "--player=CMD" Specify the player to use for the \f(CW\*(C`\-\-play\*(C'\fR option. Any occurrence of \f(CW%s\fR in this string will be replaced with the filename of the video (appropriately shell escaped). .Sp The default on *nix operating systems is to use mplayer: .Sp .Vb 1 \& mplayer \-really\-quiet %s .Ve .Sp You may wish to automatically delete the video after you have viewed it: .Sp .Vb 1 \& mplayer \-really\-quiet %s; rm %s .Ve .Sp On Windows, if \f(CW\*(C`\-p\*(C'\fR or \f(CW\*(C`\-\-play\*(C'\fR is specified but no player is specified, \&\s-1VLC\s0 (if installed) will be used to play the video. There is no need to specify where you have installed \s-1VLC\s0 \- this will be automatically retrieved from the registry. .IP "\fI\-\-proxy\fR" 4 .IX Item "--proxy" Proxy to use, a \s-1SOCKS\s0 proxy or \s-1HTTP\s0 proxy can be specified. .Sp To specify a \s-1SOCKS\s0 proxy, simply provide the host and port in host:port format. If port is not specified, 1080 is assumed. \f(CW\*(C`LWP::Protocol::socks\*(C'\fR is required for \&\s-1SOCKS\s0 support. .Sp To specify an \s-1HTTP\s0 proxy, provide the proxy \s-1URL,\s0 for example \f(CW\*(C`http://host:port\*(C'\fR. .Sp For proxying \s-1RTMP\s0 downloads, \s-1SOCKS\s0 is required along with a version of \&\f(CW\*(C`rtmpdump\*(C'\fR which supports \s-1SOCKS\s0 proxying. .Sp If no proxy is specified on the command line or the config file the \&\f(CW$HTTP_PROXY\fR environment variable will be used. .IP "\fI\-\-subtitles\fR" 4 .IX Item "--subtitles" Download subtitles for the video, if available. Subtitles are converted to SubRip format and saved to a file of the same name as the video file, but with an extension of 'srt'. .IP "\fI\-\-raw\fR" 4 .IX Item "--raw" \&\s-1HLS\s0 downloads are run through ffmpeg/avconv to cleanup audio by default, this options turn it off. .IP "\fI\-t\fR, \fI\-\-type\fR" 4 .IX Item "-t, --type" For sites that have multiple download type force selected type, \&'hls' or 'rtmp'. .IP "\fI\-q\fR, \fI\-\-quiet\fR" 4 .IX Item "-q, --quiet" Be quiet, only print errors. .IP "\fI\-v\fR, \fI\-\-version\fR" 4 .IX Item "-v, --version" Print the version of \fBget_flash_videos\fR. .IP "\fI\-y\fR, \fI\-\-yes\fR" 4 .IX Item "-y, --yes" Do not prompt with any questions, just say 'yes'. This means either literally yes, or the default or first option if choosing from a list. .ie n .IP "\fI\-\-add\-plugin=\f(CI""URL""\fI\fR" 4 .el .IP "\fI\-\-add\-plugin=\f(CIURL\fI\fR" 4 .IX Item "--add-plugin=URL" Add an external plugin from a specified \s-1URL\s0 or local file. .SH "CONFIGURATION" .IX Header "CONFIGURATION" On startup \fBget_flash_videos\fR will read the configuration files located at \&\fI/etc/get_flash_videosrc\fR and then \fI~/.get_flash_videosrc\fR. .PP The files follow a simple \f(CW\*(C`name = value\*(C'\fR convention where the name matches the long version of the command line options. For example if you want to specify the default player, to always say yes and to always run the player the file might look like: .PP .Vb 2 \& player = my\-video\-player %s 2>/dev/null; rm \-f %s \& yes \& \& # Always play the video \& play .Ve .PP Options given on the command line will override these options, with the exception that it is not currently possible to disable an option enabled in the configuration file from the command line. .SH "EXAMPLES" .IX Header "EXAMPLES" Play a video (may prompt for filename still, override with \fI\-y\fR): .PP .Vb 1 \& get_flash_videos \-p http://some.site/video .Ve .PP Download a video (note quotes are required for URLs with special characters like \f(CW\*(C`&\*(C'\fR in): .PP .Vb 1 \& get_flash_videos "http://some.site/video?f=1&v=1234" .Ve .PP Play the \s-1URL\s0 on the clipboard (\s-1UNIX\s0): .PP .Vb 1 \& xclip \-o | xargs get_flash_videos \-y \-p .Ve .PP Play the \s-1URL\s0 on the clipboard (\s-1OSX\s0): .PP .Vb 1 \& pbpaste | xargs get_flash_videos \-y \-p .Ve .PP (Note if there is text on the clipboard rather than a \s-1URL\s0 above then get_flash_videos will search for it). .PP Play the first video matching \*(L"Open Source\*(R": .PP .Vb 1 \& get_flash_videos \-y \-p Open Source .Ve .SH "BUGS" .IX Header "BUGS" Third party sites are a moving target therefore it is possible support for some of the sites may not work correctly. First check that you are using the latest version. .PP If you wish to see open bugs or report a bug visit . .SH "HACKING" .IX Header "HACKING" If you'd like to change or improve \fBget-flash-videos\fR (for example adding support for another site), please see the project wiki where there's an overview to help you get started, and a detailed tutorial on adding support for a new site: . .SH "COPYRIGHT" .IX Header "COPYRIGHT" Copyright 2009, zakflash and MonsieurVideo .PP Licensed under the Apache License, Version 2.0 (the \*(L"License\*(R"); you may not use this file except in compliance with the License. You may obtain a copy of the License at .PP Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \*(L"\s-1AS IS\*(R" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,\s0 either express or implied. See the License for the specific language governing permissions and limitations under the License. .PP Contributions are welcome and encouraged, but please take care to maintain the JustWorks(tm) nature of the program.