开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

Twitch Streamer For Linux

This is a script dedicated to stream to Twitch.tv. it also has Webcam support! AVCONV script is DEPRECATED, due libav drama, etc...

Tested on:

• Linux: Ubuntu 13.04
• CPU: AMD Athlon(tm) 64 X2 Dual Core Processor 4200+ × 2
• Ram: 2 GB
• Arch: 64bit
• GPU: Radeon X1300 PCI (ATI RV515)
• Bandwith: ~70 byte/s
• Mem Used: ~192 MB (2 Threads)

Authors:

• Giovanni Dante Grazioli

Contributors

• İlteriş Eroğlu (linuxgemini)
• yofreke
• Vilsol

How to

• Go to http://www.twitch.tv/broadcast/ , click on the Show Key button and copy and paste the key inside the twitch_key file or inside the ~/.twitch_key

• To save the Streaming, go to http://twitch.tv/settings/videos and check Archive Broadcasts - Automatically archive my broadcasts

• Open now the twitch.sh and edit the settings

    Value              Example                  Description
    ------------------ ------------------------ ---------------------------------------------------------------------------------------------------------
    OUTRES             "1280x720"               Twitch Output Resolution ("1920x1080" should be the maximum resolution)
    FPS                "24"                     Frame per Seconds (Suggested 24, 25, 30 or 60)
    THREADS            "4"                      Change this if you have a good CPU (Suggested 4 threads, Max 6 threads)
    QUALITY            "medium" or "veryfast"   Streaming Quality (ultrafast, superfast, veryfast, faster, fast, medium, slow, slower, veryslow, placebo)
    WEBCAM             "/dev/video1"            WebCam chardevice under /dev
    WEBCAM_WH          "320:240"                WebCam Width end Height in the Output
    WEBCAM_XY          "10:10"                  WebCam Position if empty then it will set the standard position
    SERVER             "live" or "live-fra"     Twitch Server list at http://bashtech.net/twitch/ingest.php
    CBR                "1000k" to "3000k"       Constant bitrate. Increase this to get a better pixel quality (Twitch suggest between 1000k to 3000k)
    ALWAYS_FULLSCREEN  "false" or "true"        Change this to 'true' if you want to go always on FULLSCREEN, this will disable the output.
    SUPPRESS_OUTPUT    "false" or "true"        Change this to 'true' if you want to hide your STREAM_KEY, for security purpose. This will not affect
                                                the ALWAYS_FULLSCREEN option. ALWAYS_FULLSCREEN will always disable the output.
    FILE_VIDEO         "My_stream.flv"          File name to redirect the stream if there's the -save arg (go to the How To to see how it works)
    SET_XY             "10,100"                 Position of the Window on the screen (X,Y) and will be used only if the -coords option is called.
    SET_INRES          "1024x600"               Window size (WxH) and will be used only if the -coords option is called.
    AUDIO_RATE         "44100"                  Twitch Audio Rate. Twitch itself, says must be 2 channels with 44100 as rate; so DO NOT CHANGE IT!
    KEY_FRAME          "2"                      Twitch Video Key Frame. Twitch itself, says must be 2, so DO NOT CHANGE IT!
  

• Open the game that you want to stream and set window mode.

• Open a terminal, browse to the twitch script directory and run the script

    $ ./twitch_ffmpeg.sh
  

• Avconv script is deprecated. It can give you errors

• Click with your Mouse on the game window

• Now you should be live (check on your channel).

• You can set the Audio settings (select the Null Output on pavucontrol)

• To stop the stream, click on the terminal and press CTRL+C

• BE CAREFUL ON SHOWING THE TERMINAL SINCE FFMPEG PRINTS ON THE TERMINAL THE KEY

• For suggestion or bugfix, please write to me on github. (I love suggestions! <3 )

• Please do NOT write for support on my BLOG. post bug reports on http://github.com/wargio/Twitch-Streamer-Linux !

Additional How to

• You can run the scripts with some arguments (you can use a combination of these):

    Value              Description
    ------------------ -------------------------------------------------------------------------------
     -h                Display the usage screen
     -fullscreen       Run the script in FULLSCREEN mode
     -window           Run the script in WINDOW mode
     -coords           Set the screen resolution, by using SET_XY SET_INRES defined inside the script
     -save             Save the video to the file FILE_VIDEO instead of streaming it
     -quiet            Disables most of the outputs (The Twitch KEY will be hided)
  

Setup Audio (with pavucontrol):

• My microphone is Turtle Beach PLa Headset and my game is Syobon Action (Cat Mario)
• Open the game you want to stream and exec the script
• Now open pavucontrol
• Under Playback:
• Under Recording:
• Done (For ffmpeg/avconv setting, Monitor of MicAudio or Monitor of GameAudio. it's the same).
• If you don't see any Monitor of MicAudio or Monitor of GameAudio, but only Monitor of null output, use it, don't worry.

Dependencies:

These dependencies are the name of the packages that you need. The libs names can change from distro to distro!.

     x11-utils  pulseaudio-utils libfaac-dev libmp3lame-dev libv4l-dev libx264-dev libpulse-dev librtmp-dev libasound2-dev X11proto-xext-dev libxext-dev

Grab the latest ffmpeg from:

git clone git://source.ffmpeg.org/ffmpeg.git ffmpeg

Build it with the following build options:

./configure --disable-ffplay --disable-ffprobe --disable-ffserver --enable-libfaac --enable-libmp3lame --enable-libv4l2 --enable-libx264 --enable-x11grab --enable-libpulse --enable-librtmp --enable-gpl --enable-nonfree --disable-yasm  --extra-libs="-lasound" && make

Suggested:

    pavucontrol

FAQ

• How do i choose the bitrate?

  The optimal bitrate can be calculated in this way: bitrate = Width*Height/144, an example 720*480/144 = 2400 (k) but if you get a bitrate above 5000(k) like 1920*1080/144=2073456(k = ~2073 M) choose 5000k, because 6000k is DVD quality.

• I see some errors after Stopping Audio (Don't worry if you see errors here), should i worry about this?

  No, you don't. They are supposed to show up.

• Which is the Webcam standard position on the screen?

  The standard position is: (ScreenWidth - WebcamWidth - 10):10 (Upper Right corner) Keep in mind that the coordinates start from 0:0 (Upper Left corner) to Width:Height (Bottom Right corner)

• How i can test the output before going to livestream?

  Use the -save arg for the script: ./twitch_ffmpeg -save or ./twitch_avconv -save in this way you can see how it looks like and change things if they are not ok.

• How i can save the output instead of livestreaming? Use the -save arg for the script: ./twitch_ffmpeg -save or ./twitch_avconv -save

• Why the avconv script is deprecated? It's deprecated due libav drama. Please use ffmpeg.

Screenshot: