<br /> <p align="center"> <a href="https://github.com/ShaneIsrael/fireshare"> <img src="app/client/src/assets/logo.png" alt="Logo" width="120" height="160"> </a> <h1 align="center">Fireshare</h1> <p align="center"> Share your game clips, videos, or other media via unique links. <br /> <br /> <a href="https://github.com/shaneisrael/fireshare/actions"> <img alt="Docker Build" src="https://github.com/shaneisrael/fireshare/actions/workflows/docker-publish-main.yml/badge.svg" /> </a> <a href="https://hub.docker.com/r/shaneisrael/fireshare"> <img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/shaneisrael/fireshare?label=docker%20pulls"> </a> <a href="https://hub.docker.com/r/shaneisrael/fireshare/tags?page=1&ordering=last_updated"> <img alt="GitHub tag (latest SemVer)" src="https://img.shields.io/github/v/tag/shaneisrael/fireshare?label=version"> </a> <a href="https://github.com/shaneisrael/fireshare/stargazers"> <img alt="GitHub stars" src="https://img.shields.io/github/stars/shaneisrael/fireshare"> </a> <br /> <br /> <a href="https://v.fireshare.net">Live Demo</a> · <a href="https://github.com/ShaneIsrael/fireshare/issues">Report a Bug</a> · <a href="https://www.paypal.com/paypalme/shaneisrael">Buy us a Coffee!</a> </p> </p>

Key Features

Share videos through unique links
Public / Private feeds (private is link only)
Game-based organization with cover art
Mobile Device Support
Uploads (optional, can be restricted)
Video view counting
Video Cropping
Video Tags for improved search and categorization
Open Graph metadata for rich link previews
RSS feed for new public videos
LDAP support
Optional video transcoding with CPU or NVIDIA GPU

<h3 align="center">Dashboard</h3>

card-view

<h3 align="center">Automatic Game Organization</h3>

folders

folders-game

<h3 align="center">Video Details</h3>

edit

<h3 align="center">Open Graph Support</h3>

Installation

Fireshare is designed to run in Docker.

Required mounts:

/data - internal database
/processed - generated metadata (posters, metadata files)
/videos - source video directory to scan

If your clips are in /path/to/my_game_clips/, mount that path to /videos in the container.

Docker Compose

Edit docker-compose.yml for your host paths and admin credentials, then run:

docker-compose up -d

Then open http://localhost:8080.

Docker Run

docker run --name fireshare \
  -v $(pwd)/fireshare:/data:rw \
  -v $(pwd)/fireshare_processed:/processed:rw \
  -v /path/to/my_game_clips:/videos:rw \
  -p 8080:80 \
  -e ADMIN_PASSWORD=your-admin-password \
  -d shaneisrael/fireshare:latest

Open http://localhost:8080.

Configuration

LDAP setup: LDAP.md

Transcoding (Optional)

Transcoding is off by default.

ENABLE_TRANSCODING=true
TRANSCODE_GPU=true # optional, NVIDIA only

CPU transcoding works out of the box. For NVIDIA GPU setup with the Docker image, you only need an NVIDIA GPU on the host—the image handles drivers and toolkit.

GPU Requirements

NVIDIA GPU with NVENC support

Unraid Setup

If you're using Unraid:

Install "NVIDIA Driver" plugin from Apps/Community Applications

Add to Fireshare container environment:

ENABLE_TRANSCODING=true
TRANSCODE_GPU=true
NVIDIA_DRIVER_CAPABILITIES=all

Add to "Extra Parameters": --gpus=all

Encoder Selection

When GPU mode is enabled, Fireshare selects the best available encoder:

GPU Mode (TRANSCODE_GPU=true):

AV1 with GPU (av1_nvenc) — RTX 40 series or newer
H.264 with GPU (h264_nvenc) — GTX 1050+
Fallback to CPU encoders if GPU encoding fails

CPU Mode (TRANSCODE_GPU=false):

H.264 with CPU — Most compatible, faster encoding
AV1 with CPU — Best compression, slower

Local Development

Requirements: Python 3, Node.js, and npm.

Clone the repo:

git clone https://github.com/ShaneIsrael/fireshare.git

Start backend services from project root:
```
./run_local.sh
```
Start frontend:
```
cd app/client
npm install
npm start
```
Open http://localhost:3000 and sign in with admin/admin.

Contributing

Contributions are welcome. For larger changes, open an issue first to align on scope.

Fork the repository
Create a branch from develop
Commit your changes
Rebase on latest develop
Open a pull request to develop

Issues and feature requests: https://github.com/ShaneIsrael/fireshare/issues

Database Changes

If you update models, create a migration and review it before opening a pull request.

Troubleshooting

Playback Problems

If playback is unstable:

Reduce source file size/bitrate
Verify upload bandwidth on the host
Prefer browser-friendly formats (MP4/H.264 is safest)
Consider enabling transcoding for better compatibility
Test in another browser to rule out codec/browser limitations

Upload Fails Behind Nginx

Increase proxy limits/timeouts, for example:

client_max_body_size 0;
proxy_read_timeout 999999s;

If you use a different proxy, apply equivalent upload size and timeout settings there.

Fireshare

Install / Use

README