italianChords - Node.js Library

italianChords is a simple Node.js library that provides a database of 50 Italian songs with their chords. It allows you to search songs by artist, title, or key, displaying the main chord sections for each song.

Installation

Install the library via npm:

npm install italianchords

Importing into your project

Import the library into your JavaScript file:

const italianchords = require('italianchords');

Main features

• allSong()
  Displays all songs with their chords.
• searchByArtist()
  Interactive search by artist (input from terminal).
• searchBySong()
  Interactive search by song title (input from terminal).
• searchByTonality()
  Interactive search by key (input from terminal).

How to use

Display all songs

const italianchords = require('italianchords');

italianchords.allSong();

Search by artist

const italianchords = require('italianchords');

italianchords.searchByArtist();
// Follow the instructions in the terminal

Search by title

italianchords.searchBySong();
// Enter the requested title in the terminal

Search by key

italianchords.searchByTonality();
// Enter the requested key in the terminal

Data structure

The song data is stored in an internal JSON file with the following structure:

{
  "title": "Il mondo",
  "artist": "Jimmy Fontana",
  "key": "Re",
  "part1": ["Re", "La", "Si-", "Sol"],
  "chorus": ["Sol", "La", "Re", "Si-"],
  "part2": ["Mi-", "La", "Re"]
}

Technical notes

• The library runs in a Node.js environment.
• User interaction happens via console input/output using the readline module.
• Searches normalize input to ignore case, spaces, and special characters.
• No external dependencies are required beyond Node.js core modules.

Author

Giuseppe Gravagno

License

ISC