BOJRO N CHILL

BOJRO N CHILL is a portable, hardware-accelerated local streaming server and synchronized video player. Built with Electron and FFmpeg, it processes heavy video files (MKV, MP4, AVI) into HTTP Live Streaming (HLS) formats on the fly, allowing multiple users to watch and chat in perfect sync over a local network or VPN.

Table of Contents

• Features
• Screenshots
• Requirements
• Usage (Portable)
• Remote Access (Tailscale)
• Data Wiping & Uninstallation
• Development Setup
• License

Features

Core Engine

• Hardware Acceleration: Native FFmpeg integration with dynamic encoding profiles for NVIDIA (NVENC), AMD (AMF), Intel (QSV), and a standard CPU fallback.
• HLS Processing: Shreds large video files into .ts chunks with a .m3u8 playlist for seamless web streaming without prior transcoding.
• Portable Architecture: Operates entirely from a single compressed .exe. No installation, Python, or Node.js required for the end user.

Synchronized Theater

• Socket.io Integration: Real-time playback synchronization. Host playback controls (play, pause, seek) dictate client states globally.
• Integrated Chat: Built-in WebSocket text chat for all connected clients.
• Background Hosting: Runs a local Express web server on port 3000 to serve the frontend interface and video chunks.

Screenshots

Server Interface

App Interface

Requirements

• Windows 10 or higher.
• Dedicated GPU (NVIDIA, AMD, or Intel) is highly recommended for processing speed, though CPU mode is available.
• Network access allowed through Windows Defender/Firewall for port 3000.

Usage (Portable)

1. Run BOJRO N CHILL.exe.
2. Click the file selector to choose your local video file.
3. Select your hardware encoder from the dropdown menu.
4. Click Process Movie. Wait for the progress bar to reach 100%.
5. Click Start Server. The host theater will open in your default web browser.
6. Share your local IPv4 address (e.g., http://192.168.1.X:3000) with devices on your network.

Remote Access (Tailscale)

To host a movie night for users outside of your local network without dealing with router port-forwarding, use Tailscale to create a secure, private peer-to-peer network.

1. Host Setup: Download and install Tailscale on the PC running the BOJRO N CHILL server.
2. Client Setup: Have your remote viewers install Tailscale on their device (PC, Mac, iOS, or Android).
3. Connect: Both parties must log into the same Tailscale network (Tailnet).
4. Get IP: On the host PC, open the Tailscale application and copy your assigned Tailscale IPv4 address (it will start with 100.x.x.x).
5. Watch: With the BOJRO N CHILL server running, clients simply open their browser and navigate to http://100.x.x.x:3000.

Data Wiping & Uninstallation

BOJRO N CHILL is a portable application, meaning it does not install traditional registry keys or program files. However, to process videos efficiently without cluttering your desktop, it unzips background dependencies and writes temporary video chunks to your Windows AppData folder.

To clear video data while using the app:

• Click the Clear Cache button on the dashboard. This instantly deletes the current video chunks from your drive.

To completely wipe the application and all temporary data from your system:

1. Close the BOJRO N CHILL application entirely.
2. Press Windows Key + R to open the Run dialog.
3. Type %appdata% and press Enter.
4. Locate the folder named bojro-n-chill and delete it entirely.
5. Delete the BOJRO N CHILL.exe file from wherever you saved it.

Development Setup

To build or modify the application from the source code:

1. Clone the repository.
2. Install dependencies:

   npm install
   npm start
   npm run build

License This project is licensed under the GPLv3 License.