• Stars
    star
    293
  • Rank 141,274 (Top 3 %)
  • Language
    PHP
  • License
    MIT License
  • Created almost 8 years ago
  • Updated almost 8 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

The easiest way to create interactive Facebook live streams. Displays reaction count and live shoutouts :)

Facebook Live Reactions

Facebook Live Reactions is a Linux script for creating Facebook Live Streams that contains interactive reaction counts. It also includes an interactive shoutout feature that gives live shoutouts to users who typed "shared" into the comment box.

Like this ...

Facebook Live Reactions

Dependencies

  • Linux or OSX
  • PHP (Built with 7, should work with 5.6)
  • PHP GD or ImageMagik
  • FFMPEG (must be compiled with aac and rtmp)
  • Photoshop (if you plan to modify the image)

Installing

It's best to install the script on a server. Get $10 free from Digital Ocean!

Clone the repo:

git clone http://github.com/JamesTheHacker/facebook-live-reactions
cd facebook-live-reactions

Install PHP dependencies (Composer must be installed):

composer install

Configuration

A few things need to be configured to make Facebook Live Reactions work.

Adding an audio file

Facebook Live requires an audio stream. I haven't included any audio with the repo as it would increase the size. The audio file must be at least 4 hours in length (Facebook Live streams can only last 4 hours). If the audio file is shorter then this the live stream will stop when the audio ends.

Download an audio stream from YouTube using youtube-dl:

youtube-dl --extract-audio --audio-format mp3 https://www.youtube.com/watch?v=15uF7r2rCQk

Rename the download to audio.mp3

mv "Vintage Christmas Songs from the 20's & 30's Playlist-15uF7r2rCQk.mp3" audio.mp3

This will download the .mp3 of the video. In this case it's a playlist of classic 1920's and 1930's Christmas songs.

The audio file above is 20 minutes long. It needs to be looped so it's at least 4 hours in length. Lets use SoX to loop the audio file.

sox audio.mp3 audio-loop.mp3 repeat 15

This will take a while to run. Once complete a single audio-loop.mp3 file will be produced. Copy audio-loop.mp3 to the data directory.

Edit Settings

Before modifying the settings you need to create a Facebook application. If you don't already have one create one here. The application is used to connect to the Graph API to fetch the reactions and comments from the video. When setting up the application you only need to provide basic information.

All settings are stored in the settings.php file. To get things working you only need to modify the settings below:

'POST_ID'       => '',
'ACCESS_TOKEN'  => '',
'APP_ID'        => '',
'APP_SECRET'    => ''

Once you've got your app setup get the apps access token using the Access Token Tool. Copy the access token into the settings. Also copy the app ID and app secret.

Ignore POST_ID for the moment. We'll move onto that.

Create The Live Stream

After you've modified the settings next you need to create a new live stream on Facebook. Go to a page you own, press the "Publishing Tools" tab, and then click "Videos". Press the "Live" button and wait for the popup to load.

Next you should see "Server or stream URL". Copy this URL and paste it to the bottom of fblive.sh. Paste it between the "..." (keeping the quotes!). Like this:

ffmpeg \
-re -y \
-loop 1 \
-f image2 \
-i images/stream.jpg \
-i data/audio-loop.mp3 \
-acodec libfdk_aac \
-ac 1 \
-ar 44100 \
-b:a 128k \
-vcodec libx264 \
-pix_fmt yuv420p \
-vf scale=640:480 \
-r 30 \
-g 60 \
-f flv \
"rtmp://rtmp-api.facebook.com:80/rtmp/1343774358979842?ds=1&s_l=1&a=AaaWtwcn05wdmMCp"

Open a new terminal, navigate to the root directory and run (you may need to run chmod +x fblive.sh:

./fblive.sh

This will start streaming. Press the "next" button and wait for Facebook to acknowledge the live stream.

By default a blank image will be streamed. You won't see the reactions or shoutouts just yet. This is because we haven't yet started the other script to update the image. We'll move onto that now.

Once the stream loads in preview press "Go Live". Another box should pop up that contains video stats. On this page there is a "view permalink" link. Click that and you will be navigated to the Facebook post that contains the live stream.

In the URL there's a unique ID that conists of a bunch of numbers. Grab this ID and paste it into settings.php. Like so:

'POST_ID' => '90823402348502302894',

Nearly done!

Updating Reactions and Shoutouts

Open another terminal, navigate to the root directory and run the following command:

php fblive.php

This will run silently. Do not quit the process! Every 5 seconds it will grab the reactions count and update the live stream. It will also grab the latest comment that contains the word "share" and give a random shoutout to that user.

All done. Your stream should now be live. Leave a reaction, or type the word "shared" into the comment and wait for the video to update.

FAQ

How do I modify the image?

I've include the .psd file in images/background.psd. Open this file and change the text, or background image. DO NOT MOVE THE REACTIONS IMAGES! Always save the image as images/background.jpg

What if I want to move the reactions images?

If you move the reactions images you also need to update the XPOS and YPOS for each reaction in settings.php. This is because the script uses these values to draw the reaction counts in the correct place.

What is the stream.jpg file?

Do not touch this file. The PHP script will modify this file to include the updated stats and shoutouts. This file is passed directly to ffmpeg and is used to generate the live stream.

How do I add my own shoutout messages?

To edit the shoutouts modify the shoutouts.php file. Keep them short, otherwise they will not render correctly on the live stream.

Contributions

If the documentation is unclear, or you have any issues please file a new issue. If you want to contribute submit a pull request.

More Repositories

1

Neuron

Neuron - Electron, ES6, React, PouchDB, Sass, Webpack
JavaScript
967
star
2

nodejs-server-ansible-playbook

NodeJS server provisioning and application deployment using Ansible: HAProxy, Let's Encrypt, HTTPS, Secure Firewall ...
40
star
3

passman

PassMan is a secure, and easy to use password manager that runs on the terminal! Written in bash.
Shell
38
star
4

meme-maker

NodeJS module for creating meme images
JavaScript
26
star
5

JakePHP

JakePHP is a boilerplate created for modern web application development on Linux platforms. Simply clone, and start developing!
PHP
11
star
6

80Probe

Brute force subdomains and probe domains for a webserver
Python
7
star
7

northumberland-planning-application-scraper

Harvest data from Northumberland's public planning application database and convert to CSV
JavaScript
6
star
8

Yarn-Downloader

A terminal script developed in PHP to download movie clips from Yarn.
PHP
4
star
9

speeed

Style CSS based on the users Internet speed
3
star
10

profanity-bash

Filter profanity from a string of text using standard linux tools
Shell
2
star
11

Simplex

A Simple NPM based PostCSS build tool
CSS
2
star
12

80Scan

Port 80/443 Scanner on Steroids
JavaScript
2
star
13

spacecake

React, Mobx, Styled-Components, Styled-Grid boilerplate. Deploy to S3 and Digital Ocean Spaces.
JavaScript
2
star
14

RageRacer

πŸš— 🏁 A simple and easy to use race condition testing tool for web applications
JavaScript
1
star
15

Hofstadter-Q-sequence

Hofstadter Q-sequence Code Golf Solution
JavaScript
1
star
16

cmake-c-tutorial

Just a test repo I created while learning CMake from https://cliutils.gitlab.io/modern-cmake/
C
1
star
17

Slack-Linkit

A slack bot that hooks up to Wordpress. Invite the bot into a channel and use the !linkit command to share a URL to a Wordpress page
PHP
1
star
18

nodebox-testapp

A simple test application for NodeBox. Feel free to completely ignore this repo.
JavaScript
1
star