Custom frontend for music cataloging and related ephemera.
Find a file
2025-09-04 22:13:39 -04:00
app Add Umami analytics tracking 2025-09-04 21:48:03 -04:00
.dockerignore Rework app and deployment logic 2023-10-03 15:34:49 -04:00
.gitignore Gitkeep app/static/fonts 2025-08-31 10:46:06 -04:00
.gitkeep Gitkeep app/static/fonts 2025-08-31 10:46:06 -04:00
app.py Fix Dockerfile 2025-09-04 22:13:39 -04:00
deploy.ps1 Run in detached mode 2023-10-03 16:02:02 -04:00
docker-compose.yaml Add extra_hosts 2025-08-31 10:02:21 -04:00
Dockerfile Fix Dockerfile 2025-09-04 22:13:39 -04:00
README.md Adjust for Docker deployment 2023-07-02 17:45:01 -04:00
requirements.txt Fix Dockerfile 2025-09-04 22:13:39 -04:00

bsoned.vinyl

Personal vinyl cataloguing website

Requirements

Needs Node.js and LESS to compile CSS during development. Grab Node.js from here, then run npm install -g less to install LESS.

After pulling and installing Node.js and LESS, run py -m venv venv from the main directory. Load the new virtual environment by running venv/Scripts/Activate, then run pip -r requirements.txt to install the required dependencies.

Needs database login credentials. Ask owner for details.

Run flags and arguments

Before running, load the virtual environment by running venv/Scripts/activate. To exit, run deactivate.

Running the launcher run.py from the command line gives several arguments to aid in development.

Most common launcher command is py run.py -dev.

-dev

Shorthand for -fr -less.

-test or -t

Runs the launcher in test mode. Does not start the webserver and does not compile LESS to CSS. Intended for launch configuration work.

-fr

Force remote. Skips a check for a local MySQL instance. Reduces startup time by virtue of avoiding a timeout.

port [port] or -p [port]

Specifies a port to run the webserver. Default is :80.

-log [level]

Specifies the logging level. There are currently three log levels:

  1. info
  2. debug
  3. trace

-less

Specific flag for using LESS as opposed to compiling and using CSS.