WVPlayer (Web Video Player)

WVPlayer is a minimalistic web-technology-based video player designed for easy deployment and usage, primarily on a local machine. It offers tracking playback progress while leveraging HTML's native video player features as much as possible. All data is stored either in progress.json files within directories or in the .env configuration file.

The app is designed for single-user usage, whose login credentials are to be hardcoded in the .env file.

Autorun

Start with generating an .env file by following the guidelines outlined in the .env.example file. Then follow one of the two methods below.

Method 1. As a service

1. Make the sell script executable

   chmod +x daemon/serve.sh

2. Draft a wvplayer.service file based on the example

3. Do one of the two:

   1. copy wvplayer.service to /lib/systemd/system/wvplayer.service
   2. Add it with a symlink:

      sudo ln -s /absolute/path/to/wvplayer.service /lib/systemd/system

4. Reload the daemon and start the wvplayer service

   sudo systemctl enable wvplayer.service
   sudo systemctl daemon-reload
   sudo service wvplayer start

5. Now the app may be managed as a regular service (e.g. sudo service wvplayer restart)

To take the service down permanently:

systemctl stop wvplayer
systemctl disable wvplayer
rm /lib/systemd/system/wvplayer
systemctl daemon-reload
systemctl reset-failed

Method 2. As a docker image

just docker compose up

Setup static IP

If you aim to access the application from other devices within your household, configuring a static IP on the host machine is essential. Below are two methods to achieve this on Linux.

Method 1. VIA Gnome Settings

Credit: https://linuxhint.com/configure-static-ip-address-linux/

1. Go to network's preferences --> IPv4

2. Set method to `Manual

3. Fill in:

   • Address: Desired static IP in the network
   • Netmask: 255.255.255.0
   • Gateway: usually ends with 1
   • DNS: 8.8.8.8

4. Press Apply

5. Let the network default to 0.0.0.0

Method 2. Via Netplan

Credit:

• https://linuxize.com/post/how-to-configure-static-ip-address-on-ubuntu-20-04/
• https://tizutech.com/ubuntu-netplan-gateway4-has-been-deprecated

1. Create a 02...yaml file in `/etc/netplan

     version: 2
     renderer: networkd
     ethernets:
       {{interface}}:
         dhcp4: no
         addresses:
           - {{DESIRED ADDRESS}}/24
         routes:
           - to: default
             via: {{GATEWAY}}
         nameservers:
           addresses:
             - {{GATEWAY}}
             - 8.8.8.8
             - 1.1.1.1

2. Apply: sudo netplan apply

3. Open the port