Notas musicais é um CLI para ajudar na formação de escalas, acordes e campos harmônicos.
Toda a aplicação é baseada em um comando chamado notas-musicais
. Esse comando tem um subcomando relacionado a cada ação que a aplicação pode relaizar. Como: escala
, acorde
e campo-harmonico
.
Para a instalação do do CLI do projeto recomendamos o pipx
para fazer essa instalação:
pipx install notas-musicais
Embora isso seja somente uma recomendação! Você também pode instalar o projeto com o gerenciador de sua preferência. Como o pip
:
pip install notas-musicais
Você pode chamar as escalas via linha de comando. Por exemplo:
notas-musicais escala
Retornando os graus e as notas correspondentes a essa escala:
┏━━━┳━━━━┳━━━━━┳━━━━┳━━━┳━━━━┳━━━━━┓
┃ I ┃ II ┃ III ┃ IV ┃ V ┃ VI ┃ VII ┃
┡━━━╇━━━━╇━━━━━╇━━━━╇━━━╇━━━━╇━━━━━┩
│ D │ E │ F# │ G │ A │ B │ C# │
└───┴────┴─────┴────┴───┴────┴─────┘
O primeiro parâmetro do CLI é a tônica da escala que deseja exibir. Desta forma, você pode alterar a escala retornada. Por exemplo, a escala de F#
:
notas-musicais escala F#
Retornando:
┏━━━━┳━━━━┳━━━━━┳━━━━┳━━━━┳━━━━┳━━━━━┓
┃ I ┃ II ┃ III ┃ IV ┃ V ┃ VI ┃ VII ┃
┡━━━━╇━━━━╇━━━━━╇━━━━╇━━━━╇━━━━╇━━━━━┩
│ F# │ G# │ A# │ B │ C# │ D# │ F │
└────┴────┴─────┴────┴────┴────┴─────┘
Você pode alterar a tonalidade da escala também. Esse é o segundo parâmetro da linha de comando. Por exemplo, a escala de C# maior
:
notas-musicais escala C# menor
Retornando:
┏━━━━┳━━━━┳━━━━━┳━━━━┳━━━━┳━━━━┳━━━━━┓
┃ I ┃ II ┃ III ┃ IV ┃ V ┃ VI ┃ VII ┃
┡━━━━╇━━━━╇━━━━━╇━━━━╇━━━━╇━━━━╇━━━━━┩
│ D# │ F │ F# │ G# │ A# │ B │ C# │
└────┴────┴─────┴────┴────┴────┴─────┘
Uso básico:
notas-musicais acorde
┏━━━┳━━━━━┳━━━┓
┃ I ┃ III ┃ V ┃
┡━━━╇━━━━━╇━━━┩
│ C │ E │ G │
└───┴─────┴───┘
notas-musicais acorde C+
┏━━━┳━━━━━┳━━━━┓
┃ I ┃ III ┃ V+ ┃
┡━━━╇━━━━━╇━━━━┩
│ C │ E │ G# │
└───┴─────┴────┘
Até o momento você pode usar acordes:
- maiores
- menores
- diminuto e
- aumentado
Você pode chamar os campos harmônicos via o subcomando campo-harmonico
. Por exemplo:
notas-musicais campo-harmonico
┏━━━┳━━━━┳━━━━━┳━━━━┳━━━┳━━━━┳━━━━━━┓
┃ I ┃ ii ┃ iii ┃ IV ┃ V ┃ vi ┃ vii° ┃
┡━━━╇━━━━╇━━━━━╇━━━━╇━━━╇━━━━╇━━━━━━┩
│ C │ Dm │ Em │ F │ G │ Am │ B° │
└───┴────┴─────┴────┴───┴────┴──────┘
Por padrão os parâmetros utilizados são a tônica de C
e o campo harmônico maior
.
Você pode alterar os parâmetros da tônica e da tonalidade.
notas-musicais campo-harmonico [OPTIONS] [NOTA] [TONALIDADE]
Um exemplo com o campo harmônico de E
:
notas-musicais campo-harmonico E
┏━━━┳━━━━━┳━━━━━┳━━━━┳━━━┳━━━━━┳━━━━━━┓
┃ I ┃ ii ┃ iii ┃ IV ┃ V ┃ vi ┃ vii° ┃
┡━━━╇━━━━━╇━━━━━╇━━━━╇━━━╇━━━━━╇━━━━━━┩
│ E │ F#m │ G#m │ A │ B │ C#m │ D#° │
└───┴─────┴─────┴────┴───┴─────┴──────┘
Um exemplo utilizando o campo harmônico de E
na tonalidade menor
:
notas-musicais campo-harmonico E menor
┏━━━━┳━━━━━┳━━━━━┳━━━━┳━━━━┳━━━━┳━━━━━┓
┃ i ┃ ii° ┃ III ┃ iv ┃ v ┃ VI ┃ VII ┃
┡━━━━╇━━━━━╇━━━━━╇━━━━╇━━━━╇━━━━╇━━━━━┩
│ Em │ F#° │ G │ Am │ Bm │ C │ D │
└────┴─────┴─────┴────┴────┴────┴─────┘
Para descobrir outras opções, você pode executar a flag --help
:
notas-musicais --help
Usage: notas-musicais [OPTIONS] COMMAND [ARGS]...
╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ acorde │
│ campo-harmonico │
│ escala │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
As informações sobre as informações sobre os subcomandos podem ser acessadas usando a flag --help
após o nome do parâmetro. Um exemplo do uso do help
nos campos harmônicos:
notas-musicais campo-harmonico --help
Usage: notas-musicais campo-harmonico [OPTIONS] [NOTA] [TONALIDADE]
╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ nota [NOTA] Tônica do campo harmônico. [default: C] │
│ tonalidade [TONALIDADE] Tonalidade do campo harmônico. [default: maior] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯