SongLib is a personal Django web application designed to help me manage my song lyrics and setlists. The application allows me to store lyrics, categorize songs, and create and manage setlists for performances. It provides a straightforward Django admin interface for managing song lyrics and setlists. Features include tag-based song categorization, song ordering within setlists, and printable setlist views.
- Clone the repository to your local machine.
- Create a virtual environment and activate it.
- Install the required packages using
pip install -r requirements.txt. - Run migrations using
python manage.py migrate. - Create a superuser for the Django admin interface using
python manage.py createsuperuser. - Start the development server using
python manage.py runserver. - Access the application at
localhost:8000.
The SongLib application is also available as a Docker image. You can pull and run the Docker image using the following commands:
-
Pull the Docker image:
docker pull ghcr.io/blasferna/songlib:latest -
Run the Docker image:
docker run --name songlib -e DEBUG=off -e DB_NAME=songlib -e DB_USER=postgres -e DB_PASS=secret -e DB_HOST=dbhost -e DB_PORT=5432 -e SECRET_KEY=secreto ghcr.io/blasferna/songlib
Please replace the DB_HOST, DB_PASS, and SECRET_KEY placeholders with your actual database host, password, and Django secret key.