Skip to main content

Notas Musicais

Documentation Status CI codecov PyPI version

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 realizar. Como escalas, acordes e campo-harmonico

Instalação

Para instalação do cli do projeto recomendamos que use 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

como usar?

Escalas

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 ┃
┡━━━╇━━━━╇━━━━━╇━━━━╇━━━╇━━━━╇━━━━━┩
│ C │ D  │ E   │ F  │ G │ A  │ B   │
└───┴────┴─────┴────┴───┴────┴─────┘

Alteração da tônica da escala

O primeiro parâmetro do CLI é a tônica da escala que deseja exibir. Dessa forma, você pode alterar a escala retornada. Por exemplo, a escala de F#:

notas-musicais escala F#

Resultando em:


┏━━━━┳━━━━┳━━━━━┳━━━━┳━━━━┳━━━━┳━━━━━┓
┃ I  ┃ II ┃ III ┃ IV ┃ V  ┃ VI ┃ VII ┃
┡━━━━╇━━━━╇━━━━━╇━━━━╇━━━━╇━━━━╇━━━━━┩
│ F# │ G# │ A#  │ B  │ C# │ D# │ F   │
└────┴────┴─────┴────┴────┴────┴─────┘

Alteração na tonalidade da escala

Você pode alterar a tonalidade da escala também. Esse é o segundo parâmetro da linha de comando. Por exemplo, a escala de D# maior:

notas-musicais escala D# menor

┏━━━━┳━━━━┳━━━━━┳━━━━┳━━━━┳━━━━┳━━━━━┓
┃ I  ┃ II ┃ III ┃ IV ┃ V  ┃ VI ┃ VII ┃
┡━━━━╇━━━━╇━━━━━╇━━━━╇━━━━╇━━━━╇━━━━━┩
│ D# │ F  │ F#  │ G# │ A# │ B  │ C#  │
└────┴────┴─────┴────┴────┴────┴─────┘

Acordes

Uso básico

notas-musicais acorde

┏━━━┳━━━━━┳━━━┓
┃ I ┃ III ┃ V ┃
┡━━━╇━━━━━╇━━━┩
│ C │ E   │ G │
└───┴─────┴───┘

Variações na cifra

notas-musicais acorde C+

┏━━━┳━━━━━┳━━━━┓
┃ I ┃ III ┃ V+ ┃
┡━━━╇━━━━━╇━━━━┩
│ C │ E   │ G# │
└───┴─────┴────┘

Até o momento você pode usar acordes maiores, menores, diminuto e aumentados

Campo harmônico

Você pode chamar os campos harmônicos via 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 Ce o campo harmônico maior

Alterações nos campos harmônicos

Você pode alterar os parâmetros da tônica e da tonalidade.

notas-musicais campo-harmonico [tonica] [tonalidade]

Alteração na tônica do campo

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#°  │
└───┴─────┴─────┴────┴───┴─────┴──────┘

Alteração da tonalidade do campo

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   │
└────┴─────┴─────┴────┴────┴────┴─────┘

Mais informações sobre o CLI

Para descobrir outras opções, você pode usar a flag --help:

notas-musicais --help

 Usage: notas-musicais [OPTIONS] COMMAND [ARGS]...

╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────────╮
│ escala                                                                                               │
│ acorde                                                                                               │
│ campo-harmonico                                                                                      │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯

Mais informações sobre os subcomandos

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] [tonica] [tonalidade]

╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────────╮
│   tonica          <str>  Tônica do campo harmônico [default: c]                                      │
│   tonalidade      <str>  Tonalidade do campo harmônico [default: maior]                              │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                                          │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯

Release files for notas-musicais-rks 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for notas-musicais-rks 0.1.0
File Size Uploaded
notas_musicais_rks-0.1.0.tar.gz 6.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for notas-musicais-rks 0.1.0
File Interpreter ABI Platform
notas_musicais_rks-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 14.2 kB

Release files / notas_musicais_rks-0.1.0.tar.gz

Download URL notas_musicais_rks-0.1.0.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
55894a69e58700ab000f0654b2e13c208832da8a7174a05f2e7655cc675d162c
BLAKE2b-256 checksum
How to use checksums
29bb314e4bfca984a84d3d0a0518a044818b5c463c2ce1722dff34ebefd45dbd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.2.1 CPython/3.14.0 Windows/11

Release files / notas_musicais_rks-0.1.0-py3-none-any.whl

Download URL notas_musicais_rks-0.1.0-py3-none-any.whl
Size 7.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dd873036b30bd3a21858e56aa7923c90a8ad7dba5e28a6a382824bb2418aab37
BLAKE2b-256 checksum
How to use checksums
fbe553535ecf91ce33b447e110d0473ece8278e306068d142aded27bccc8c235
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.2.1 CPython/3.14.0 Windows/11

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page