Click here to watch the installation & usage video in Turkish.

• Purpose
• Key Features
• Tech Stack
• Installation
  • Installation With Docker - Automatic
  • Installation With Docker - Manual
• How To Start A Livestream?
  • Livestreaming With OBS
  • Streaming With FFmpeg
• Security
• License

Developing things and solving problems during a live-stream is fun, educational and also a good opportunity to meet new people.

Unfortunately; popular livestreaming platforms do not focus on developers. It's hard for the developer and the audience to find each other and come together on these platforms.

There are helpful platforms that inform you about live-streams on Youtube, Twitch etc., for example LaraStreamers. I got to know many Laravel streamers from there. But these platforms are sharing with you what you are already interested in. They're not good at creating new interests.

This is how the idea of FooBar.Live was born. It emerged as an attempt to solve the mentioned problems.

Also, it started to be created in a Hackathon, ÜçBüyücü Turnuvası, this means a lot for this kind of project :).

• Live-streaming without any remote dependencies like YouTube or Twitch. FooBar.Live includes an Nginx RTMP server for video streaming.
• Provides live updates by using a socket connection. When new messages are sent to chat or viewer count is changed, viewers will know that instantly. Not depend on third-party services like Pusher, FooBar.Live contains a socket server and uses Redis pub/sub to communicate.
• Supports tools that streamers already use. Thanks to RTMP support, OBS and a lot of streaming tools are supported. It is enough to just change the URL and the streaming key.

• Nginx RTMP to receive video streaming
• Node.Js / Socket.io for socket server needs
• Redis for pub/sub
• PostgreSQL as database
• PHP Laravel Framework / Jetstream with Livewire Stack for application
• Docker - Docker-Compose to run and orchestrate services.

FooBar.Live is completely dockerized. It is possible to run the project without Docker, but it is not recommended because of the effort that it will take.

Note: FooBar.Live uses these ports: 80, 5342, 6379, 1935, 1936, 4000. Before installation, it is recommended to ensure that these ports are not used by other processes.

There is a file in the project called setup.sh, which is a shell script that runs the necessary commands for installation.

If you don't want to run a shell script directly, you can follow the steps at Installation With Docker - Manual.

# Clone this repository
$ git clone https://github.com/emincanozcan/foobar.live.git

# Go into the repository
$ cd foobar.live

# Run the script
$ chmod  x ./setup.sh && ./setup.sh

After installation; open your browser and go to http://localhost to access FooBar.Live.

# Clone this repository
$ git clone https://github.com/emincanozcan/foobar.live.git

# Go into the repository
$ cd foobar.live

# Create the environment variables file. You can change the configuration in it, but it is recommended to keep it as it is, for the first installation
$ cp .env.example .env

# Install PHP dependencies using a docker container
$ docker run --rm --interactive --tty --volume $PWD:/app --user $(id -u):$(id -g) composer install

# Run the containers
$ ./vendor/bin/sail up -d

# Prepare the application
$ ./vendor/bin/sail artisan key:generate && ./vendor/bin/sail artisan storage:link && ./vendor/bin/sail artisan migrate --seed

After installation; open your browser and go to http://localhost to access FooBar.Live.

OBS (Open Broadcaster Software) is free and open source software for video recording and live-streaming.

• Copy FooBar.Live streaming key from the profile page.
• Open OBS
  • Click on Settings
  • Click on Stream
  • Change Service to "Custom..."
  • Write rtmp://localhost:1935/stream_receiver to server field.
  • Paste the stream key that you have copied to the Stream Key field.
  • Click on Apply and Okay
  • The last step; click on the Start Streaming button and your first live-stream vie FooBar.Live will be started.
• To watch, go to the http://localhost/u/{username} URL or click on My Live Stream button which is located on the header at the Dashboard.

Especially for development purposes, opening OBS and starting a new live-stream might be a little bit boring after a while. Using FFmpeg is a good alternative for this kind of situation, it allows you to stream a video file to an RTMP server. Because of FFmpeg is a feature-rich program, there are a lot of available configurations.

If you have interest, you can take a look FFmpeg Streaming Guide for detailed configurations, working with different data sources etc. Or, If you want to just test it, you can use the command below.

# Change videofilepath.mkv with your video file, $STREAM_KEY with your stream key.

$ ffmpeg -re -i videofilepath.mp4 -vcodec libx264 -vprofile baseline -g 30 -acodec aac -strict -2 -f flv rtmp://localhost:1935/stream_receiver/$STREAM_KEY

If you discover security-related issues, please email [email protected] instead of using the issue tracker.

The MIT License (MIT). Please see License File for more information.