Skip to content

Installation

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

Download the files

Download the Latest Release!

You should download the latest Source code (zip), then unzip it where you'd like to install!

Prerequisites

If you do NOT have Python installed, it will ask you if you'd like to install it! This feature is experimental, feedback appreciated (both if it works or if it doesn't work!)

  • Python 3.x
  • pip

Installation

Using the Start Script (Recommended)

This starts both the main site AND the manager.

Linux & Mac:

Double click StartWebsite.sh or in a terminal:

chmod +x StartWebsite.sh
./StartWebsite.sh

Note: On Mac, you may run into Gatekeeper. Right click StartWebsite.sh -> Open then confirm!

Windows:

Simply double click StartWebsite.bat to run it!

Or in a command line:

StartWebsite.bat

If you do not have python, it will prompt you to install it. After it installs, close the window and restart StartWebsite.bat and it should work!

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

...and you're done! Now add some videos!

Manual Start

For first time setup, you will need to create a venv and install the requirements by hand:

python -m venv venv
source ./venv/bin/activate
pip install -r requirements.txt

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