Interactive guitar fretboard visualization for scales, chords, and arpeggios in all 12 keys

Features

• Interactive Fretboard Display: Visualize notes on the fretboard using HTML, CSS, and JavaScript.
• Scales: Major, Minor, Modes, Custom scales with all possible positions.
• Arpeggios: Major, Minor, Seventh, Extended arpeggios with multiple voicings.
• Chords:
  • Triads and seventh chords: Maj7, Dom7, Min7, m7♭5, Dim7.
  • V-System voicings (V3–V7, V8–V10) for 4‑note chords with fixture generation.
• String Configurations:
  • Standard 6‑string (E, A, D, G, B, E).
  • Extended 8‑string (B, E, A, D, G, B, E, A).
• All 12 Keys Supported: Generate positions for any root note.
• Search & Filter:
  • Find scales, chords, or arpeggios by name or note content.
  • API endpoints for JSON responses.
• Fixtures & Management:
  • generate_v_system_fixture.py script for auto-generating chord voicings.
  • Load data via Django fixtures (python manage.py loaddata).
• Extensible Architecture:
  • Modular Django apps for models, views, templates, and filters.
  • Pluggable string and tuning configurations.
• Custom Template Filters: Note naming, color coding, and display utilities.
• Responsive & Themed UI: Mobile-friendly layout and CSS theming.

Tech Stack

• Backend: Django (Python 3.8+)
• Frontend: Vanilla JavaScript, HTML5, CSS3
• Database: PostgreSQL (separate DBs for 6‑string and 8‑string)
• Data Exchange: JSON fixtures and REST APIs

Installation

1. Clone the repository:

   git clone https://github.com/hybridpicker/fretboard-position-finder.git

2. Create and activate the Conda environment:

   conda create --name fretboard
   conda activate fretboard

3. Install Python dependencies:

   pip install -r requirements.txt

Configuration

In your settings_dev.py (or settings.py), add:

TEMPLATES[0]['DIRS'] += [BASE_DIR / 'templates']
MEDIA_ROOT = BASE_DIR / 'media'
MEDIA_URL = '/media/'
STATIC_URL = '/static/'
STATICFILES_DIRS = [BASE_DIR / 'static']
STATIC_ROOT = BASE_DIR.parent / 'fretboard' / 'static_cdn'
FIXTURE_DIRS = [BASE_DIR / 'fixtures']

Loading Data

python manage.py migrate
python manage.py loaddata
# or any other fixture in /fixtures

Running the Development Server

python manage.py runserver 0.0.0.0:8080

• Python
• JavaScript
• JSON

Fretboard-Position-Finder in Action

Open http://localhost:8080 to view the app.

API Endpoints

• GET /api/scales/?name=<scale>&root=<note>
• GET /api/arpeggios/?name=<type>&root=<note>
• GET /api/chords/?name=<type>&root=<note>
• GET /api/search/?q=<query>

Deployment

• Server: CentOS with Nginx & Gunicorn
• Port: 8080

Example Gunicorn command:

gunicorn fretboard.wsgi:application --bind 0.0.0.0:8080

License

MIT License

Fixtures

Fretboard-Position-Finder loads all fingerings, that are stored as fixtures with the migrate-command:

python manage.py migrate