Skip to content

Installation

Jump to bottom
Alunacoz edited this page Mar 9, 2026 · 21 revisions

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

Adding Videos (Automatic) (Recommended)

1. Download a valid package for this website.

The source could really be anyone, but the DH Discord Server is likely a good place to start. You will know it's valid where the root of the .zip (when you double click it) just contains a video and or playlist folder.

2. Visit the manager and drag the .zip in

In the navigation bar of the website, open "Manager" and drag the .zip into the window, or click the import .zip button.

3. Verify that your new videos are at the top of the list!

You can drag the videos/playlists up and down to change the order they appear.

And you're done! You now have everything set up and can import videos. If you would like to learn how to manually install videos or create new packages, go here.

Clone this wiki locally