Skip to content

emiliamacek/tonevault

Repository files navigation

ToneVault

A digital inventory and signal chain manager for guitarists.

Python Django

ToneVault is an application to help musicians organize their gear collection and remember the exact settings (signal chains) used for specific genres/songs.

Features

  • Gear Vault: Manage your guitars, amps, and pedals (from a global catalog or add custom items).
  • Signal Chains: Build song-specific setups with exact pedal order and knob settings.
  • Community: Share your legendary tones and discover setups from other users.

Architecture

This project goes beyond basic CRUD by implementing enterprise-level design patterns to keep the business logic clean, testable, and scalable.

Full Architecture & Design Patterns documentation

Quick Start

Get the app running locally with a fully populated database:

  1. Setup environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
  1. Setup Database & Seed Data
python manage.py migrate
python manage.py seed_gear   # Loads global gear catalog
python manage.py seed_users  # Loads user community and setups
  1. Run
python manage.py runserver
  1. Test account: Login as jimi_hendrix with password purple_haze

Preview

  1. Profile page
image
  1. Setup configuration
image
  1. User's collection
image

About

Django-based web app for guitarists to manage gear inventory and design signal chains using enterprise design patterns

Topics

Resources

License

Stars

Watchers

Forks

Contributors