Giter Club home page Giter Club logo

python-twitch-stream's Introduction

https://readthedocs.org/projects/python-twitch-stream/badge/

Python-Twitch-Stream

Python-twitch-stream is a simple lightweight library, which you can use to send your python video to twitch and react with the chat in real time. Its main features are:

  • Supports sending of audio and video in a thread safe way to your twitch channel.
  • Allows to interact with the chat of your channel by sending chat messages and reading what other users post.

Installation

In short, you can install a known compatible version of ffmpeg and the latest stable version over pip.

pip install python-twitch-stream

Make sure to also install a recent ffmpeg version:

sudo add-apt-repository ppa:mc3man/trusty-media
sudo apt-get update && sudo apt-get install ffmpeg

The ffmpeg library needs to be very recent (written in october 2015). There are plenty of bugs when running a stream using older versions of ffmpeg or avconv, including but not limited to 6GB of memory use, problems with the audio and synchronization of the audio and the video.

Or alternatively, install the latest python-twitch-stream development version via:

pip install git+https://github.com/317070/python-twitch-stream

Documentation

Documentation is available online: http://python-twitch-stream.readthedocs.org/

For support, please use the github issues on the repository.

Example

This is a small example which creates a twitch stream which changes the color of the video according to the colors provided in the chat.

from __future__ import print_function
from twitchstream.outputvideo import TwitchBufferedOutputStream
from twitchstream.chat import TwitchChatStream
import argparse
import time
import numpy as np

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description=__doc__)
    required = parser.add_argument_group('required arguments')
    required.add_argument('-u', '--username',
                          help='twitch username',
                          required=True)
    required.add_argument('-o', '--oauth',
                          help='twitch oauth '
                               '(visit https://twitchapps.com/tmi/ '
                               'to create one for your account)',
                          required=True)
    required.add_argument('-s', '--streamkey',
                          help='twitch streamkey',
                          required=True)
    args = parser.parse_args()

    # load two streams:
    # * one stream to send the video
    # * one stream to interact with the chat
    with TwitchBufferedOutputStream(
            twitch_stream_key=args.streamkey,
            width=640,
            height=480,
            fps=30.,
            enable_audio=True,
            verbose=False) as videostream, \
        TwitchChatStream(
            username=args.username.lower(),  # Must provide a lowercase username.
            oauth=args.oauth,
            verbose=False) as chatstream:

        # Send a chat message to let everybody know you've arrived
        chatstream.send_chat_message("Taking requests!")

        frame = np.zeros((480, 640, 3))
        frequency = 100
        last_phase = 0

        # The main loop to create videos
        while True:

            # Every loop, call to receive messages.
            # This is important, when it is not called,
            # Twitch will automatically log you out.
            # This call is non-blocking.
            received = chatstream.twitch_receive_messages()

            # process all the messages
            if received:
                for chat_message in received:
                    print("Got a message '%s' from %s" % (
                        chat_message['message'],
                        chat_message['username']
                    ))
                    if chat_message['message'] == "red":
                        frame[:, :, :] = np.array(
                            [1, 0, 0])[None, None, :]
                    elif chat_message['message'] == "green":
                        frame[:, :, :] = np.array(
                            [0, 1, 0])[None, None, :]
                    elif chat_message['message'] == "blue":
                        frame[:, :, :] = np.array(
                            [0, 0, 1])[None, None, :]
                    elif chat_message['message'].isdigit():
                        frequency = int(chat_message['message'])

            # If there are not enough video frames left,
            # add some more.
            if videostream.get_video_frame_buffer_state() < 30:
                videostream.send_video_frame(frame)

            # If there are not enough audio fragments left,
            # add some more, but take care to stay in sync with
            # the video! Audio and video buffer separately,
            # so they will go out of sync if the number of video
            # frames does not match the number of audio samples!
            elif videostream.get_audio_buffer_state() < 30:
                x = np.linspace(last_phase,
                                last_phase +
                                frequency*2*np.pi/videostream.fps,
                                int(44100 / videostream.fps) + 1)
                last_phase = x[-1]
                audio = np.sin(x[:-1])
                videostream.send_audio(audio, audio)

            # If nothing is happening, it is okay to sleep for a while
            # and take some pressure of the CPU. But not too long, if
            # the buffers run dry, audio and video will go out of sync.
            else:
                time.sleep(.001)

For a fully-functional example, see examples/color.py, and check the Tutorial for in-depth explanations of the same. More examples are maintained in the examples directory.

Development

Python-twitch-stream is a work in progress, but is stable. Feel free to ask for features or add pull-requests with updates on the code.

python-twitch-stream's People

Contributors

317070 avatar crackcraft avatar crizcraig avatar gachl avatar holdengreen avatar nhdaly avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

python-twitch-stream's Issues

Threading exceptions in Python 2.7

Hi, I am running the example code (exactly) provided in the README, and I am intermittently (like, once per 5-10 runs) getting this exception, and then the process stops working:

Unhandled exception in thread started by <bound method Thread.__bootstrap of <Thread(Thread-85, stopped daemon 4523905024)>>
Traceback (most recent call last):
  File "/usr/local/Cellar/python/2.7.11/Frameworks/Python.framework/Versions/2.7/lib/python2.7/threading.py", line 774, in __bootstrap
    self.__bootstrap_inner()
  File "/usr/local/Cellar/python/2.7.11/Frameworks/Python.framework/Versions/2.7/lib/python2.7/threading.py", line 789, in __bootstrap_inner
    del _limbo[self]
KeyError: <Thread(Thread-85, stopped daemon 4523905024)>

Any ideas?
Thanks!

Can't use mp3 for audio

So I'm trying to use an mp3 file as an audio source but I can't figure it out. Any help would be greatly appreciated, or better yet how to use pyttsx3 output as audio.

Many thanks for any help

Parameters for output stream

Make more parameters for the output stream modifiable

  • Maybe make the entire command line used changeable as well?

If username is not all lowercase, it is able to send chat messages but cannot receive them.

For TwitchChatStream, if username has capital letters in it, the chatstream.twitch_receive_messages() doesn't ever return messages.

It is able to send messages, but not receive them.

Here is a simple example:

with TwitchChatStream(
      username=twitch_username,
      oauth=twitch_oauth,
      verbose=False) as chatstream:

  chatstream.join_channel('<my_lowercase_username>')
  print('connected to: ', chatstream.current_channel)

  chatstream.send_chat_message('Hello!')

  # The main loop to poll the chat.
  while True:
      received = chatstream.twitch_receive_messages()

      # process all the messages
      if received:
          print("received")

If twitch_username has capitals in it, the send succeeds but never receives messages, whereas if it's all lowercase, everything works. This even happens if i manually force join_channel to the lowercase named channel.

0auth

Traceback (most recent call last):
File "/root/Desktop/python-twitch-stream-master/examples/color.py", line 34, in
with TwitchBufferedOutputStream(
File "/usr/local/lib/python3.9/dist-packages/twitchstream/chat.py", line 44, in enter
self.connect()
File "/usr/local/lib/python3.9/dist-packages/twitchstream/chat.py", line 132, in connect
s.send('PASS %s\r\n' % self.oauth)
TypeError: a bytes-like object is required, not 'str'

i am lost. can anyone help me set this up?

Stable, stutter-less ouput stream

Stabilize the output-stream. The code is already in zoomingstream, but a lot of code needs to be removed from that file in order to clean up that mess.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.