Installation

Getting Started

Prerequisites

• Python 3.x
• pip

Installation

1. Create a Python virtual environment:

   python -m venv venv

2. Activate the virtual environment:

   Linux & Mac:

   source ./venv/bin/activate

   Windows:

   venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

Running the Server

Using the Start Script (Recommended)

This starts both the main site AND the manager.

Linux & Mac:

chmod +x StartWebsite.sh
./StartWebsite.sh

Windows:

This is ⚠️UNTESTED⚠️ because I don't use Windows :]

StartWebsite.bat

This script automatically activates the virtual environment and starts the website.

Manual Start

If you prefer to start the server manually:

Linux/Mac:

source ./venv/bin/activate
python bump-sw.py
python manager.py & # This is optional! If you don't need to manage videos, you can omit this.
python -m RangeHTTPServer 8000 --bind 0.0.0.0

and after running, kill the manager PID then deactivate venv.

kill [Insert PID here] # Unnecessary if you skipped manager.py
deactivate

Windows:

To be honest, I don't really know what you do on Windows. This is my best guess. Just use the .bat file honestly it makes this so much easier.

On Command Prompt:

venv\Scripts\activate.bat
python bump-sw.py
python -m RangeHTTPServer 8000 --bind 0.0.0.0

if you need to use the video manager, open in a second tab:

python manager.py

There's probably a better way to do this, but this is the simplest. Let me know if there's a better way!

Important Security Note: By default, the server binds to all network interfaces (0.0.0.0), making it accessible on your local network. If you only want local access (just this device), omit the --bind flag and everything after it:

python -m RangeHTTPServer 8000

Accessing the Website

Once the server is running, open your browser and navigate to:

http://localhost:8000

If you want to access it from another device on your local network:

http://[YOURLOCALIPHERE]:8000